SwiftUI 코드를 생성하는 AI가 문법을 알고 있어도, 결과물이 곧바로 좋은 앱 코드가 되는 것은 아니다. 버튼이 VoiceOver에 제대로 노출되지 않거나, 이미 deprecated된 API를 선택하거나, 화면을 그리는 방식이 성능 문제를 부를 수 있다. twostraws/SwiftUI-Agent-Skill은 이런 반복적인 실수를 줄이기 위해 만든 SwiftUI Pro 에이전트 스킬이다.
이 저장소의 핵심은 특정 모델이나 편집기에 묶이지 않는 배포 방식이다. Agent Skills 형식을 사용해 Claude Code, Codex, Gemini, Cursor 등에서 쓸 수 있다. Claude Code에서는 `/swiftui-pro`, Codex에서는 `$swiftui-pro`로 호출하고, “성능 문제를 찾아줘”처럼 자연어로 검토를 요청할 수도 있다. README는 이를 기존 AGENTS.md에 쌓인 실전 지식을 여러 코딩 에이전트로 가져오는 방법으로 설명한다.
다루는 항목은 내비게이션, 레이아웃, 애니메이션, 상태 관리, VoiceOver 접근성, deprecated API, 성능 등이다. 범위를 넓게 잡으면서도 지침을 무작정 늘리지는 않겠다는 원칙이 눈에 띈다. 기여 안내는 이미 LLM이 알고 있는 내용을 반복하지 말고, 엣지 케이스와 예상 밖 동작에 집중하라고 한다. 스킬 문서가 길어질수록 사용자의 토큰 비용도 커진다는 점을 설계의 일부로 본다.
그래서 이 저장소는 새로운 코드 생성 모델이라기보다, 코딩 에이전트가 SwiftUI 프로젝트를 검토할 때 참고할 도메인별 기준에 가깝다. 특정 문제만 골라 확인할 수 있어 전체 리뷰가 필요 없는 상황에도 적용하기 쉽다. 반면 호출했다고 해서 모든 제안이 프로젝트에 맞거나, 코드가 자동으로 검증되는 것은 아니다. README의 배지는 iOS 26 이상과 Swift 6.4 이상을 대상으로 한다고 밝히므로, 지원 버전이 다른 앱이라면 지침과 제안을 그 맥락에 맞춰 판단해야 한다.
설치는 `npx skills add https://github.com/twostraws/swiftui-agent-skill --skill swiftui-pro`로 안내돼 있다. 코딩 도구를 교체하지 않고도, 그 도구가 자주 틀리는 영역에 더 구체적인 기준을 보탤 수 있다는 것이 실용적인 이점이다. 결국 에이전트의 결과물을 좌우하는 것은 모델의 이름 하나만이 아니다. 어떤 지식을 어떤 순간에 불러 쓰게 하느냐도 개발 흐름의 일부가 된다.