AI 코딩 도구가 SwiftUI에서 흔히 범하는 실수를 막아주는 가이드라인
Claude Code나 Codex 같은 AI 도구를 써서 SwiftUI 코드를 만들 때, 버튼이 VoiceOver에서 사라지거나 오래된 API를 쓰는 일이 잦습니다. 이 저장소는 AI가 실제로 자주 하는 실수를 집어내도록 설계된 규칙 모음입니다. 몇 분 만에 설치하면 AI가 더 현대적이고 접근성 좋은 코드를 쓰게 됩니다.
AI가 놓치는 SwiftUI의 함정
이 스킬은 수천 시간의 학습과 실제 프로젝트 경험을 바탕으로 만들어졌습니다. AI가 자주 저지르는 버튼의 VoiceOver 인식 실패, 비추천 API 사용, 예상치 못한 성능 문제를 직접적으로 겨냥합니다. 기존 AGENTS.md 파일에 기반하여, 수년간의 실무 지식을 코딩 에이전트에 빠르게 전달할 수 있게 합니다. Agent Skills 형식을 사용해 Claude Code, Codex, Gemini, Cursor 등 다양한 도구에서 작동합니다.
설치와 활성화 방법
Node.js가 설치되어 있다면 npx skills add 명령어로 쉽게 설치할 수 있습니다. 설치 과정에서 특정 에이전트만 선택하거나, 프로젝트 단위 또는 전역 단위로 적용할지 정할 수 있습니다. Claude Code 사용자는 마켓플레이스를 추가한 뒤 플러그인을 직접 설치하는 방법도 있습니다. Xcode를 사용하는 경우, YouTube 튜토리얼을 참고하여 설치 과정을 따라갈 수 있습니다.
스킬을 호출하는 방식
Claude Code에서는 /swiftui-pro, Codex에서는 $swiftui-pro 명령어로 스킬을 실행합니다. 전체 리뷰가 아니라 특정 부분만 점검하고 싶다면, '비추천 API 확인'이나 '접근성 집중' 같은 구체적인 지시를 함께 입력할 수 있습니다. 자연어 문장으로도 '이 프로젝트의 성능 문제를 찾아줘'라고 요청하면 스킬이 작동합니다.
사용 전 확인 사항
이 스킬은 MIT 라이선스로 배포되어 상업적 사용과 수정이 가능합니다. 다만, 스킬 파일은 토큰 비용을 발생시키므로, LLM이 이미 아는 내용을 반복하지 않도록 주의해야 합니다. 기여 시에는 토큰 예산을 존중하고, 엣지 케이스나 미묘한 비추천 사항에 초점을 맞춰야 합니다. Node.js가 없다면 Homebrew를 통해 설치해야 하며, 이는 설치 과정의 필수 요구 사항입니다.