twostraws/SwiftUI-Agent-Skill

AI 코딩 어시스턴트가 API 사용, 디자인, 성능, 접근성 등에 대한 가이드를 포함하여 더 스마트하고, 단순하며, 현대적인 SwiftUI를 작성하도록 돕는 에이전트 스킬입니다. 내비게이션, 레이아웃, 애니메이션, 상태 관리, VoiceOver, 사용 중단된 API 등 LLM(대규모 언어 모델)이 실제로 저지르는 실수를 겨냥하여 다룹니다.

또한 다음에서도 이용 가능합니다:

Swift 및 Apple 플랫폼 개발을 위한 더 많은 에이전트 스킬은 Swift Agent Skills에서 찾아보세요.

이 스킬은 제가 기존에 가지고 있던 AGENTS.md 파일을 기반으로 구축되었기 때문에, 단 몇 분 만에 수년간의 지식과 실질적인 경험을 원하는 코딩 에이전트에 가져올 수 있습니다. 이 스킬은 Agent Skills 형식을 사용하므로 Claude Code, Codex, Gemini, Cursor 등과 원활하게 작동합니다.

다음 명령어를 사용하여 Claude Code, Codex, Gemini, Cursor 등에 이 스킬을 설치할 수 있습니다:

npx skills add https://github.com/twostraws/swiftui-agent-skill --skill swiftui-pro

만약 npx: command not found 오류가 발생한다면, 현재 Node를 설치하지 않았다는 의미입니다. Homebrew를 통해 Node를 설치하려면 다음 명령어를 실행해야 합니다:

brew install node

그리고 만약 그것마저 실패한다면, 보통은 먼저 Homebrew를 설치해야 한다는 의미입니다.

npx를 사용할 때, 설치 과정에서 사용하고자 하는 에이전트를 정확하게 선택할 수 있습니다. 또한 스킬을 단일 프로젝트에만 설치할지, 아니면 모든 프로젝트에서 사용 가능하도록 만들지 여부도 선택할 수 있습니다.

Claude Code 사용자들은 SwiftUI Agent Skill 마켓플레이스를 추가한 다음, Claude를 통해 플러그인을 직접 설치할 수 있습니다. 예를 들면 다음과 같습니다:

/plugin marketplace add twostraws/SwiftUI-Agent-Skill
/plugin install swiftui-pro@swiftui-agent-skill

대안으로, 이 전체 저장소를 클론(clone)하여 원하는 방식으로 설치할 수 있습니다.

Xcode를 사용하고 있다면, Xcode에서 Agent Skills를 설치하고 사용하는 방법에 대한 워크스루는 YouTube 비디오를 참고하세요. (How to Install and Use Agent Skills in Xcode)

이 스킬의 이름은 SwiftUI Pro이며, 다양한 방법으로 트리거(trigger)할 수 있습니다. 예를 들어, Claude Code에서는 다음을 사용합니다:

/swiftui-pro

그리고 Codex에서는 다음을 사용합니다:

$swiftui-pro

두 경우 모두 부분적인 검토만 원할 경우 특정 지침을 제공할 수 있습니다. 예를 들어, Claude에서는 /swiftui-pro Check for deprecated API와 같이 사용하거나, Codex에서는 $swiftui-pro Focus on accessibility를 사용할 수 있습니다.

또한 자연어를 사용하여 스킬을 트리거할 수도 있습니다:

이 프로젝트의 성능 문제를 찾기 위해 SwiftUI Pro 스킬을 사용해 주세요.

이 스킬은 수천 시간에 걸친 학습, 실험, 그리고 실제 SwiftUI 프로젝트 구축 경험을 바탕으로 만들어졌습니다. 여기에 포함된 규칙들은 LLM(대규모 언어 모델)들이 흔히 저지르는 SwiftUI 실수를 직접적으로 겨냥합니다. 이들은 때때로 VoiceOver에 버튼을 보이지 않게 만들고, 자주 사용되지 않는 API를 사용하며, 종종 예상치 못한 성능 문제를 일으키는 코드를 작성하는 경향이 있습니다.

제가 왜 이 스킬을 만들었는지에 대한 더 자세한 내용은 제 아티클에서 읽어보실 수 있습니다: SwiftUI Agent Skill - Write better code with Claude, Codex, and other AI tools.

새로운 검사 추가, 기존 검사 개선, 또는 이 README 편집 등 모든 기여를 환영합니다. 누구나 오신 것을 환영합니다!

• 마크다운을 간결하게 유지해 주세요. 특히 SKILL.md 사용 시 스킬에는 토큰 비용이 발생하므로 사용자들의 토큰 예산을 존중해 주십시오.
• LLM이 이미 알고 있는 내용은 반복하지 마세요. 이는 아무런 이득 없이 토큰을 소모합니다. 엣지 케이스(edge cases), 예상치 못한 문제, 소프트한 사용 중단(soft deprecations) 등에 집중해 주세요.
• 모든 작업은 가장 많은 사람들에게 도움이 될 수 있도록 MIT 라이선스 하에 라이선스가 부여되어야 합니다.

행동 강령(Code of Conduct)을 준수해 주시기 바랍니다.

SwiftUI Pro는 원래 Paul Hudson이 제작했으며, 그는 Hacking with Swift에서 무료 Swift 튜토리얼을 작성하고 있습니다. 이 스킬은 상업적 사용, 수정, 배포 및 개인적인 사용을 허용하는 MIT 라이선스 하에 제공됩니다.