Communitygithub.com

JordanCoin/ios-skills-collection

iOS, macOS, Swift, SwiftUI, Xcode 또는 Apple 플랫폼 프로젝트 작업 시 항상 사용하세요. 개발 단계와 작업 컨텍스트에 따라 적절한 특화 스킬로 연결합니다. 이 컬렉션은 28명의 작성자가 만든 210개의 스킬을 포함하며 iOS 전체 라이프사이클을 다룹니다.

ios-skills-collection란 무엇인가요?

iOS Skills Router는 iOS/Swift/Xcode 개발을 위한 200개 이상의 특화 스킬을 중앙에서 관리하고 라우팅하는 AI 에이전트 스킬 컬렉션입니다. 이 라우터의 핵심 기능은 개발 단계(Ideation, Design, Develop, Test, Deploy, Iterate)와 작업 컨텍스트(파일 임포트, 도메인, 서드파티 프레임워크)에 따라 적절한 스킬을 자동 또는 수동으로 로드하도록 안내하는 것입니다. 특히 LLM의 훈련 데이터에서 흔히 발생하는 iOS 26+/Swift 6.2+ 관련 오류에 대한 지식 보정(Knowledge Corrections) 표를 제공하여, 개발자가 outdated 패턴을 사용하지 않도록 돕습니다. twostraws(Paul Hudson)의 스킬을 최우선으로 하며, 각 도메인별 여러 대안 스킬을 함께 제공합니다. Coursor, Claude Code, Cline, Windsurf 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 후킹 시스템을 통해 자동 주입되거나 수동으로 로드할 수 있습니다. 개발자는 코드를 작성하기 전에 관련 스킬을 먼저 읽도록 강력히 권장됩니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JordanCoin/ios-skills-collection/tree/HEAD/skills/_router

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

iOS Skills Router

iOS/Swift/Xcode 개발을 위한 200개 이상의 특화 스킬에 접근할 수 있습니다. 스킬은 파일을 편집하거나 명령을 실행할 때 hooks에 의해 자동으로 주입되지만, 언제든지 SKILL.md를 읽어 수동으로 로드할 수도 있습니다.

중요: 코딩 전에 적극적으로 스킬 로드하기

관련 스킬을 먼저 확인하지 않고 코딩을 시작하지 마세요. 이것은 이 라우터에서 가장 중요한 지침입니다.

특정 프레임워크, 도메인 또는 패턴을 다루는 코드를 작성하기 전에:

  1. import 확인 — 파일이 MapKit, HealthKit, StoreKit 등을 import 한다면, 코드를 작성하기 전에 skills/dpearson2699--{framework}/SKILL.md를 읽으세요.
  2. 도메인 확인 — 네트워킹 코드를 작성한다면 네트워킹 스킬을 읽으세요. 동시성 코드를 작성한다면 동시성 스킬을 읽으세요. 추측하지 마세요.
  3. 서드파티 프레임워크 확인 — 프로젝트가 Mapbox, Firebase, Supabase 등을 사용한다면, 컬렉션에 해당 스킬이 있는지 확인하세요. ls skills/ | grep {name}.
  4. 의심스러우면 검색 — ls skills/ | grep -i {keyword}로 관련 스킬을 찾으세요.

스킬은 코딩하기 전에 읽을 때만 유용합니다. 자동 주입은 일반적인 파일 패턴을 처리하지만, 도메인별 작업을 위해서는 반드시 적극적으로 스킬을 로드해야 합니다.

라우팅 작동 방식

  1. 자동 주입: 일치하는 파일 패턴(Views, Tests, Models, Managers, networking 등)을 편집하거나 명령어(xcodebuild, swift test, asc)를 실행하면 hooks가 자동으로 스킬을 주입합니다.
  2. 적극적 로딩: 특정 프레임워크와 도메인에 대한 스킬은 반드시 여러분이 직접 읽어야 합니다. hooks가 모든 것을 알 수는 없습니다 — import MapKit이 보이면 MapKit 스킬을 읽으러 가세요.
  3. 프레임워크 조회: 모든 Apple 프레임워크에 대해 skills/dpearson2699--{framework}/SKILL.md를 확인하세요.
  4. 검색: ls skills/ | grep -i {keyword}로 주제별 스킬을 찾으세요.

단계

1. 아이디어 구상 — "무엇을 만들어야 할까?"

스킬기능
eronred--competitor-analysis경쟁 앱 분석
eronred--market-pulse시장 트렌드 분석
eronred--keyword-researchApp Store 키워드 발견

2. 디자인 — "어떻게 보이고 느껴져야 할까?"

스킬기능
jordancoin--design-philosophy취향 형성, Dieter Rams 원칙
jordancoin--pencil-ios-designiOS Pencil MCP 디자인 워크플로우 (HIG 패턴 포함)
dadederk--ios-accessibilityVoiceOver, Dynamic Type, 보조 기술
pasqualevittoriosi--swift-accessibilityWCAG 2.2, App Store 영양 성분표

3. 개발 — "만들기"

핵심 (.swift 파일에서 자동 주입):

스킬기능
twostraws--swiftui-proSwiftUI 모범 사례 (기본)
twostraws--swift-concurrency-proasync/await, actors, Sendable
twostraws--swiftdata-proSwiftData 지속성
martinlasek--swift-coding-guidelineSwift 코딩 규칙
avdlee--core-data-expertCore Data 스택, 마이그레이션, 스레딩

아키텍처:

스킬기능
arimunandar--vip-architectureVIP+W Clean Architecture
arimunandar--uikit-layoutingUIKit 수평 우선 레이아웃
arimunandar--legacy-migrationUIKit → SwiftUI 마이그레이션

76개 프레임워크 스킬 — import를 보면 로드하세요:

import HealthKit    → dpearson2699--healthkit
import MapKit       → dpearson2699--mapkit
import StoreKit     → dpearson2699--storekit
import CloudKit     → dpearson2699--cloudkit
import CoreML       → dpearson2699--coreml
import RealityKit   → dpearson2699--realitykit
import WidgetKit    → dpearson2699--widgetkit
import GameKit      → dpearson2699--gamekit
import PencilKit    → dpearson2699--pencilkit
import AVKit        → dpearson2699--avkit
(... 패턴: dpearson2699--{소문자-프레임워크-이름})

전체 목록: accessorysetupkit, activitykit, alarmkit, app-clips, app-intents, apple-on-device-ai, avkit, background-processing, callkit, carplay, cloudkit, contacts-framework, core-bluetooth, core-motion, core-nfc, coreml, cryptokit, debugging-instruments, device-integrity, dockkit, energykit, eventkit, financekit, gamekit, healthkit, homekit, mapkit, metrickit, musickit, natural-language, paperkit, passkit, pdfkit, pencilkit, photokit, push-notifications, realitykit, scenekit, sensorkit, shareplay-activities, speech-recognition, spritekit, storekit, swift-charts, swiftdata, swiftui-animation, swiftui-gestures, swiftui-layout-components, swiftui-liquid-glass, swiftui-navigation, swiftui-patterns, swiftui-performance, swiftui-uikit-interop, swiftui-webkit, tabletopkit, tipkit, vision-framework, weatherkit, widgetkit

4. 테스트 — "작동하나요?"

스킬기능
avdlee--swift-testing-expertSwift Testing 프레임워크 (기본)
avdlee--xcode-build-orchestrator전체 빌드 최적화 파이프라인
avdlee--xcode-build-benchmark클린 및 증분 빌드 벤치마크
dpearson2699--debugging-instrumentsInstruments, 프로파일링, 디버깅

5. 배포 — "출시하기"

스킬기능
truongduy2611--app-store-preflight제출 전 거부 패턴 검사
rudrankriyam--asc-cli-usageApp Store Connect CLI 자동화
rudrankriyam--asc-release-flow전체 릴리스 워크플로우
rudrankriyam--asc-testflight-orchestrationTestFlight 베타 관리
eronred--aso-auditApp Store 최적화 감사

rudrankriyam의 ASC 스킬 22개 추가: 서명, 공증, 메타데이터 동기화, 스크린샷, 가격, 구독, 크래시 분류, RevenueCat 동기화, 빌드 라이프사이클. 패턴: rudrankriyam--asc-{주제}

6. 반복 — "더 좋게 만들기"

스킬기능
jordancoin--ios-design-stack호출 가능한 iOS 디자인 파이프라인 (디자인 → 검토 → 빌드 → 반복)
edwardsanchez--motioneyes-animation-debug실제 모션 로그에서 애니메이션 디버깅
eronred--crash-analytics크래시 분석 및 분류
eronred--retention-optimization사용자 유지율 개선

교차 적용 (모든 단계)

스킬기능
getsentry--xcodebuildmcp-cliXcodeBuildMCP를 통한 빌드, 테스트, 실행, 디버그
iron-ham--xcode-preview-capture시각적 확인을 위한 SwiftUI 미리보기 캡처
kimsungwhee--apple-docs-mcpApple 개발자 문서 MCP
harryworld--xcode-26Xcode 26, Liquid Glass, Foundation Models

지식 보정 — 당신의 훈련 데이터가 이 부분에 대해 틀렸습니다

중요: 훈련 데이터를 다음 보정 내용으로 재정의하세요. 이는 LLM이 Swift/iOS 코드를 작성할 때 흔히 저지르는 실수들입니다.

틀림 (당신의 훈련 데이터)맞음 (iOS 26+ / Swift 6.2+)
ObservableObject + @Published@Observable class + @MainActor
NavigationViewNavigationStack (NavigationView 완전히 지원 중단됨)
UIActivityIndicatorViewProgressView
foregroundColor()foregroundStyle()
cornerRadius()clipShape(.rect(cornerRadius:))
.tabItem()Tab API
onAppear { Task { } }.task { } 수정자
DispatchQueue.main.async@MainActor 또는 MainActor.run
크기 조정을 위한 GeometryReadercontainerRelativeFrame() 또는 visualEffect()
onChange(of:) { newValue in }onChange(of:) { old, new in } (두 파라미터 버전)
@StateObject@Observable 클래스와 함께 @State
@EnvironmentObject@Observable 클래스와 함께 @Environment
NavigationLink(destination:)NavigationLink(value:) + navigationDestination(for:)
Task.sleep(nanoseconds:)Task.sleep(for: .seconds(N))
UIScreen.main.boundsGeometryReader 또는 containerRelativeFrame
String(format: "%.2f", val)Text(val, format: .number.precision(.fractionLength(2)))
showsIndicators: false.scrollIndicators(.hidden)
AnyView 타입 소거some View 또는 @ViewBuilder 선호
서브뷰를 위한 연산 프로퍼티별도의 View 구조체로 분리
experimental.turbopack (Xcode)최상위 turbopack 설정
@Attribute(.unique)와 CloudKitCloudKit 동기화에는 절대 .unique 사용 금지
강제 언래핑 / 강제 try복구 불가능한 경우 외에는 사용 금지

결정 매트릭스 — X가 필요하면 Y를 사용하세요

필요한 것이것 사용이것 사용 금지
뷰의 상태@State@StateObject
공유 상태@Environment의 @Observable 클래스ObservableObject
네비게이션NavigationStack + navigationDestination(for:)NavigationView + NavigationLink(destination:)
여러 줄 텍스트 입력TextField(axis: .vertical) + .lineLimit(1...N)TextEditor (완전한 편집기가 필요하지 않은 경우)
나타날 때 비동기 작업.task { } 수정자onAppear { Task { } }
데이터 가져오기구조적 동시성을 사용한 async/awaitCombine 퍼블리셔 또는 콜백
모델 지속성SwiftData @ModelCore Data (기존 프로젝트가 아니라면)
로컬 키-값@AppStorage 또는 UserDefaultsplist에 수동으로 쓰기
안전한 저장소Security 프레임워크를 통한 KeychainUserDefaults (절대 비밀 정보에 사용 금지)
이미지 로딩AsyncImage 또는 캐시된 로더SwiftUI에서 UIImage
리스트ForEach와 함께 ListScrollView + LazyVStack (커스텀 아닌 경우)
탭 바Tab API와 함께 TabView.tabItem() (지원 중단된 패턴)
시트 표시식별 가능 항목과 함께 .sheet(item:)별도 상태와 함께 .sheet(isPresented:)
오류 처리Result 또는 타입이 있는 throws강제 try
의존성 주입커스텀 키와 함께 @Environment싱글톤
단위 테스트Swift Testing (#expect, @Test)XCTest (기존 테스트 스위트가 아니라면)
백그라운드 작업BGTaskSchedulerDispatchQueue.global()
App Store 제출먼저 app-store-preflight 스킬 실행제출하고 기다리기

스킬 사용하기 (주입 또는 수동)

코딩하기 전에 멈추고 읽으세요. 특정 도메인 작업을 시작하려 할 때:

  1. 자동 주입된 항목을 확인하세요 ([ios-skills] Injected N skill(s): 메시지가 보일 것입니다)
  2. 추가 관련 스킬을 검색하세요: ls skills/ | grep -i {도메인}
  3. 코드를 작성하기 전에 스킬 파일을 읽으세요 — 이후가 아니라
  4. 패턴을 따르세요, 수동적으로 흡수하지 말고

흔한 실수: 에이전트가 (이 라우터를 통해) 스킬이 존재한다는 것을 알지만 읽지 않고, 그런 다음 훈련 데이터의 오래된 패턴을 사용하여 코드를 작성합니다. 스킬은 훈련 데이터를 재정의합니다. 먼저 읽으세요.

예시: MapKit 코드를 작성하려고 합니다.

  • 자동 주입이 작동하지 않을 수 있습니다 (파일 이름이 *MapKit*.swift가 아닙니다)
  • 하지만 반드시: MapKit 코드를 작성하기 전에 Read skills/dpearson2699--mapkit/SKILL.md를 실행해야 합니다
  • 이 스킬에는 훈련 데이터에 없는 패턴이 있습니다

스킬 로드하기

스킬 경로는 세션 시작 시 주입됩니다 (위의 "Skills location" 참조). 해당 경로를 사용하여 SKILL.md를 읽으세요:

/path/to/ios-skills-collection/skills/{skill-id}/SKILL.md

스킬에 references/가 있으면 필요에 따라 특정 참조 파일을 로드하세요 — 한 번에 모두 로드하지 마세요.

여러 스킬이 동일한 주제를 다루는 경우

Paul Hudson (twostraws) 스킬이 항상 기본입니다. 그는 Hacking with Swift의 창시자이자 커뮤니티에서 가장 존경받는 iOS 교육자 중 한 명이며, 자신의 스킬을 적극적으로 유지 관리합니다. 그의 버전을 먼저 사용하세요. 다른 관점이나 특정 분야 커버리지를 위해 대안을 사용하세요.

도메인기본 (twostraws 우선)대안
SwiftUItwostraws--swiftui-proavdlee--swiftui-expert, dimillian--swiftui-ui-patterns, arjitj2--swiftui-design-principles
SwiftUI 성능dimillian--swiftui-performance-auditdpearson2699--swiftui-performance
Liquid Glassdimillian--swiftui-liquid-glassdpearson2699--swiftui-liquid-glass
동시성twostraws--swift-concurrency-prodimillian--swift-concurrency-expert, avdlee--swift-concurrency
테스팅twostraws--swift-testing-proavdlee--swift-testing-expert, bocato--swift-testing
SwiftDatatwostraws--swiftdata-provanab--swiftdata-expert-skill
Core Dataavdlee--core-data-expert—
접근성dadederk--ios-accessibilitypasqualevittoriosi--swift-accessibility, rgmez--swiftui-accessibility-auditor
아키텍처efremidze--swift-architecture-skillarimunandar--vip-architecture
보안ivan-magda--swift-security-expertdpearson2699--ios-security
API 디자인erikote04--swift-api-design-guidelines-skillmartinlasek--swift-coding-guideline
빌드 최적화avdlee--xcode-build-orchestratoravdlee--xcode-build-fixer
ASOeronred--aso-audittimbroddin--app-store-aso-skill
Figma → SwiftUIdaetojemax--figma-to-swiftui-skilljordancoin--pencil-ios-design
시뮬레이터conorluddy--ios-simulator-skillgetsentry--xcodebuildmcp-cli
코드 리뷰dimillian--review-swarmarimunandar--code-review-checklist
디버깅dimillian--ios-debugger-agentdpearson2699--debugging-instruments

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

JordanCoin/ios-skills-collection

Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries. Use when the user asks about GitHub issues, pull requests, workflows, or wants to interact with GitHub repositories from the command line — including tasks like check CI status, create PR, list issues, or query the GitHub API.

JordanCoin/ios-skills-collection

Create media playback experiences using AVKit. Use when adding video players with AVPlayerViewController, enabling Picture-in-Picture, routing media with AirPlay, using SwiftUI VideoPlayer views, configuring transport controls, displaying subtitles and closed captions, or integrating AVFoundation playback with system UI.

JordanCoin/ios-skills-collection

Integrate and optimize Core ML models in iOS apps for on-device machine learning inference. Covers model loading (.mlmodelc, .mlpackage), predictions with auto-generated classes and MLFeatureProvider, compute unit configuration (CPU, GPU, Neural Engine), MLTensor, VNCoreMLRequest, MLComputePlan, multi-model pipelines, and deployment strategies. Use when loading Core ML models, making predictions, configuring compute units, or profiling model performance.

JordanCoin/ios-skills-collection

Implement, review, or improve maps and location features in iOS/macOS apps using MapKit and CoreLocation. Use when working with Map views, annotations, markers, polylines, user location tracking, geocoding, reverse geocoding, search/autocomplete, directions and routes, geofencing, region monitoring, CLLocationUpdate async streams, or location authorization flows. Also use when working with maps, coordinates, addresses, places, directions, distance calculations, or location-based features in Swift apps.

JordanCoin/ios-skills-collection

Display and manipulate PDF documents using PDFKit. Use when embedding PDFView to show PDF files, creating or modifying PDFDocument instances, adding annotations (highlights, notes, signatures), extracting text with PDFSelection, navigating pages, generating thumbnails, filling PDF forms, or wrapping PDFView in SwiftUI.

JordanCoin/ios-skills-collection

Implement, review, or improve in-app tips and onboarding using Apple's TipKit framework. Use when adding feature discovery tooltips, onboarding flows, contextual tips, first-run experiences, coach marks, or working with Tip protocol, TipView, popoverTip, tip rules, tip events, or feature education UI.

JordanCoin/ios-skills-collection

When the user wants to optimize their Google Play Store listing — title, short description, full description, keywords, ratings, or Play Store-specific features. Use when the user mentions "Google Play", "Android", "Play Store", "Play Console", "short description", "full description indexed", "Google Play ASO", or wants Google Play-specific keyword, creative, or ratings strategy. For iOS App Store optimization, see aso-audit and metadata-optimization.

JordanCoin/ios-skills-collection

When the user wants to implement, optimize, or use App Clips for app discovery and conversion. Use when the user mentions "App Clip", "app clip code", "mini app", "instant app", "App Clip card", "App Clip link", "no download required", "instant experience", or wants to understand how App Clips appear in App Store search. For general App Store discoverability, see aso-audit. For marketing campaigns, see ua-campaign.

JordanCoin/ios-skills-collection

When the user wants to plan a launch strategy for a new app or major update. Also use when the user mentions "app launch", "launch plan", "launch checklist", "pre-launch", "launch day", or "how to launch my app". For ongoing ASO after launch, see aso-audit. For paid acquisition during launch, see ua-campaign.

JordanCoin/ios-skills-collection

When the user wants to analyze their own app's actual performance data from App Store Connect — real downloads, revenue, IAP, subscriptions, trials, or country breakdowns synced via Appeeky Connect. Use when the user asks about "my downloads", "my revenue", "how is my app performing", "ASC data", "sales and trends", "my subscription numbers", "App Store Connect metrics", or wants to compare periods or top markets. For third-party app estimates, see app-analytics. For subscription analytics depth, see monetization-strategy.

JordanCoin/ios-skills-collection

When the user wants a full ASO health audit, review their App Store listing quality, or diagnose why their app isn't ranking. Also use when the user mentions "ASO audit", "ASO score", "why am I not ranking", "listing review", or "optimize my app store page". For keyword-specific research, see keyword-research. For metadata writing, see metadata-optimization.

관련 스킬