Communitygithub.com

JordanCoin/ios-skills-collection

Sempre usar ao trabalhar em qualquer projeto iOS, macOS, Swift, SwiftUI, Xcode ou plataforma Apple. Roteia para as habilidades especializadas corretas com base na fase de desenvolvimento e no contexto da tarefa. Esta coleção contém 210 habilidades de 28 autores cobrindo todo o ciclo de vida do iOS.

O que é ios-skills-collection?

Este roteador de habilidades para desenvolvimento iOS, chamado "JordanCoin/ios-skills-collection", é um recurso central que organiza mais de 200 habilidades especializadas para projetos Apple (iOS, macOS, Swift, SwiftUI, Xcode). Ele atua como um diretório inteligente: automaticamente injeta habilidades relevantes ao editar certos tipos de arquivo (Views, Testes, Modelos) ou executar comandos (xcodebuild, swift test), e também instrui o agente a carregar habilidades manualmente para frameworks específicos (como MapKit, HealthKit, StoreKit) antes de começar a codificar. A coleção cobre todo o ciclo de vida do desenvolvimento: desde a ideação, design, desenvolvimento, testes, deploy, iteração e aspectos transversais como acessibilidade e otimização de builds. Além disso, inclui correções importantes sobre padrões desatualizados do Swift (ex: substituir NavigationView por NavigationStack, ObservableObject por @Observable) e uma matriz de decisão que orienta qual API moderna usar em cada situação. As habilidades são provenientes de autores respeitados, como Paul Hudson (twostraws), que são considerados a fonte primária para tópicos como SwiftUI e concorrência. Agentes de IA podem usar este roteador para garantir que estão seguindo as práticas mais atualizadas e evitar erros comuns do treinamento.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Roteador de Habilidades iOS

Você tem acesso a mais de 200 habilidades especializadas para desenvolvimento iOS/Swift/Xcode. As habilidades são injetadas automaticamente por hooks quando você edita arquivos ou executa comandos, mas você também pode carregar qualquer habilidade manualmente lendo seu SKILL.md.

IMPORTANTE: Carregue Habilidades Proativamente Antes de Codificar

NÃO comece a codificar sem verificar se há habilidades relevantes primeiro. Esta é a instrução mais importante neste roteador.

Antes de escrever código que toque em um framework, domínio ou padrão específico:

  1. Verifique imports — se o arquivo importa MapKit, HealthKit, StoreKit, etc., LEIA skills/dpearson2699--{framework}/SKILL.md ANTES de escrever código.
  2. Verifique o domínio — se você está escrevendo código de rede, LEIA a habilidade de rede. Se está escrevendo concorrência, LEIA a habilidade de concorrência. Não adivinhe.
  3. Verifique frameworks de terceiros — se o projeto usa Mapbox, Firebase, Supabase, etc., verifique se há uma habilidade para ele na coleção. ls skills/ | grep {nome}.
  4. Em caso de dúvida, pesquise — ls skills/ | grep -i {palavra-chave} para encontrar habilidades relevantes.

As habilidades só são úteis se você as LEU antes de codificar. A injeção automática lida com padrões comuns de arquivos, mas você deve carregar habilidades proativamente para trabalhos específicos de domínio.

Como o Roteamento Funciona

  1. Injeção automática: Hooks injetam automaticamente habilidades quando você edita padrões de arquivos correspondentes (Views, Testes, Models, Managers, networking, etc.) ou executa comandos (xcodebuild, swift test, asc).
  2. Carregamento proativo: VOCÊ deve ler habilidades para frameworks e domínios específicos antes de codificar. Os hooks não podem saber tudo — se você ver import MapKit, vá ler a habilidade MapKit.
  3. Consulta de framework: Para qualquer framework Apple, verifique skills/dpearson2699--{framework}/SKILL.md.
  4. Pesquisa: ls skills/ | grep -i {palavra-chave} para encontrar habilidades por tópico.

Fases

1. Ideação — "O que devemos construir?"

HabilidadeO que faz
eronred--competitor-analysisAnálise de aplicativos concorrentes
eronred--market-pulseAnálise de tendências de mercado
eronred--keyword-researchDescoberta de palavras-chave na App Store

2. Design — "Como deve parecer e se sentir?"

HabilidadeO que faz
jordancoin--design-philosophyConstrução de bom gosto, princípios de Dieter Rams
jordancoin--pencil-ios-designFluxo de design iOS Pencil MCP com padrões HIG
dadederk--ios-accessibilityVoiceOver, Dynamic Type, tecnologia assistiva
pasqualevittoriosi--swift-accessibilityWCAG 2.2, rótulos nutricionais da App Store

3. Desenvolver — "Construa"

Principal (injetado automaticamente em arquivos .swift):

HabilidadeO que faz
twostraws--swiftui-proMelhores práticas SwiftUI (primário)
twostraws--swift-concurrency-proasync/await, atores, Sendable
twostraws--swiftdata-proPersistência SwiftData
martinlasek--swift-coding-guidelineConvenções de codificação Swift
avdlee--core-data-expertPilha Core Data, migrações, threading

Arquitetura:

HabilidadeO que faz
arimunandar--vip-architectureArquitetura Limpa VIP+W
arimunandar--uikit-layoutingLayout UIKit horizontal-first
arimunandar--legacy-migrationMigração UIKit → SwiftUI

76 Habilidades de Framework — carregue quando vir o 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
(... padrão: dpearson2699--{nome-do-framework-em-minusculo})

Lista completa: 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. Testar — "Funciona?"

HabilidadeO que faz
avdlee--swift-testing-expertSwift Testing framework (primário)
avdlee--xcode-build-orchestratorPipeline completo de otimização de build
avdlee--xcode-build-benchmarkBenchmark de builds limpas + incrementais
dpearson2699--debugging-instrumentsInstruments, profiling, debugging

5. Implantar — "Publique"

HabilidadeO que faz
truongduy2611--app-store-preflightEscaneia padrões de rejeição antes do envio
rudrankriyam--asc-cli-usageAutomação CLI do App Store Connect
rudrankriyam--asc-release-flowFluxo de release completo
rudrankriyam--asc-testflight-orchestrationGerenciamento beta do TestFlight
eronred--aso-auditAuditoria de otimização da App Store

Mais 22 habilidades ASC de rudrankriyam cobrindo: certificados, notarização, sincronização de metadados, screenshots, preços, assinaturas, triagem de crashes, sincronização RevenueCat, ciclo de vida de build. Padrão: rudrankriyam--asc-{tópico}

6. Iterar — "Melhore"

HabilidadeO que faz
jordancoin--ios-design-stackPipeline de design iOS invocável (design → revisão → construir → iterar)
edwardsanchez--motioneyes-animation-debugDepurar animações a partir de logs reais de movimento
eronred--crash-analyticsAnálise e triagem de crashes
eronred--retention-optimizationMelhoria de retenção de usuários

Transversal (qualquer fase)

HabilidadeO que faz
getsentry--xcodebuildmcp-cliConstruir, testar, executar, depurar via XcodeBuildMCP
iron-ham--xcode-preview-captureCapturar previews SwiftUI para verificação visual
kimsungwhee--apple-docs-mcpApple Developer Documentation MCP
harryworld--xcode-26Xcode 26, Liquid Glass, Foundation Models

Correções de Conhecimento — Seus Dados de Treinamento Estão Errados Sobre Isso

IMPORTANTE: Substitua seus dados de treinamento por estas correções. Estes são erros comuns que LLMs cometem ao escrever código Swift/iOS.

Errado (seus dados de treinamento)Correto (iOS 26+ / Swift 6.2+)
ObservableObject + @Published@Observable class + @MainActor
NavigationViewNavigationStack (NavigationView está totalmente obsoleto)
UIActivityIndicatorViewProgressView
foregroundColor()foregroundStyle()
cornerRadius()clipShape(.rect(cornerRadius:))
.tabItem()API Tab
onAppear { Task { } }Modificador .task { }
DispatchQueue.main.async@MainActor ou MainActor.run
GeometryReader para dimensionamentocontainerRelativeFrame() ou visualEffect()
onChange(of:) { newValue in }onChange(of:) { old, new in } (versão de dois parâmetros)
@StateObject@State com classe @Observable
@EnvironmentObject@Environment com classe @Observable
NavigationLink(destination:)NavigationLink(value:) + navigationDestination(for:)
Task.sleep(nanoseconds:)Task.sleep(for: .seconds(N))
UIScreen.main.boundsGeometryReader ou containerRelativeFrame
String(format: "%.2f", val)Text(val, format: .number.precision(.fractionLength(2)))
showsIndicators: false.scrollIndicators(.hidden)
Type erasure com AnyViewPrefira some View ou @ViewBuilder
Propriedades computadas para subviewsExtrair para structs View separadas
experimental.turbopack (Xcode)Config turbopack no nível superior
@Attribute(.unique) com CloudKitNunca use .unique com sincronização CloudKit
Force unwraps / force tryEvite, a menos que irrecuperável

Matriz de Decisão — Se Precisar de X, Use Y

Você precisaUse istoNão use isto
Estado para uma view@State@StateObject
Estado compartilhadoClasse @Observable em @EnvironmentObservableObject
NavegaçãoNavigationStack + navigationDestination(for:)NavigationView + NavigationLink(destination:)
Entrada de texto multilinhaTextField(axis: .vertical) + .lineLimit(1...N)TextEditor (a menos que precise de editor completo)
Trabalho assíncrono ao aparecerModificador .task { }onAppear { Task { } }
Buscar dadosasync/await com concorrência estruturadaPublishers Combine ou callbacks
Persistir modelosSwiftData @ModelCore Data (a menos que projeto existente)
Chave-valor local@AppStorage ou UserDefaultsEscrever em plist manualmente
Armazenamento seguroKeychain via Security frameworkUserDefaults (nunca para segredos)
Carregamento de imagensAsyncImage ou carregador com cacheUIImage em SwiftUI
ListasList com ForEachScrollView + LazyVStack (a menos que customizado)
Barra de abasTabView com API Tab.tabItem() (padrão obsoleto)
Apresentação de sheet.sheet(item:) com identificável.sheet(isPresented:) com estado separado
Tratamento de errosResult ou typed throwsForce try
Injeção de dependência@Environment com chave customizadaSingletons
Teste unitárioSwift Testing (#expect, @Test)XCTest (a menos que suíte existente)
Trabalho em segundo planoBGTaskSchedulerDispatchQueue.global()
Envio para App StoreExecute a habilidade app-store-preflight primeiroEnviar e torcer

Usando Habilidades (Injetadas ou Manuais)

PARE E LEIA antes de codificar. Quando você estiver prestes a trabalhar em um domínio específico:

  1. Verifique o que foi injetado automaticamente (você verá mensagens [ios-skills] Injetou N habilidade(s):)
  2. Pesquise por habilidades adicionais relevantes: ls skills/ | grep -i {domínio}
  3. LEIA os arquivos de habilidade antes de escrever código — não depois
  4. Siga seus padrões, não apenas absorva-os passivamente

Erro comum: O agente sabe que as habilidades existem (através deste roteador) mas não as lê, então escreve código usando padrões desatualizados dos dados de treinamento. As habilidades substituem seus dados de treinamento. Leia-as primeiro.

Exemplo: Você está prestes a escrever código MapKit.

  • A injeção automática pode não disparar (o arquivo não se chama *MapKit*.swift)
  • Mas você DEVE: Leia skills/dpearson2699--mapkit/SKILL.md antes de escrever qualquer código MapKit
  • A habilidade tem padrões que seus dados de treinamento não têm

Carregando uma Habilidade

O caminho das habilidades é injetado no início da sessão (veja "Localização das habilidades" acima). Leia o SKILL.md usando esse caminho:

/caminho/para/ios-skills-collection/skills/{skill-id}/SKILL.md

Se a habilidade tiver references/, carregue arquivos de referência específicos conforme necessário — não todos de uma vez.

Quando Múltiplas Habilidades Cobrem o Mesmo Tópico

As habilidades de Paul Hudson (twostraws) são sempre primárias. Ele é o criador do Hacking with Swift, um dos educadores iOS mais respeitados da comunidade, e mantém ativamente suas habilidades. Use as versões dele primeiro. Recorra a alternativas para diferentes perspectivas ou cobertura de nicho.

DomínioPrimário (twostraws primeiro)Alternativas
SwiftUItwostraws--swiftui-proavdlee--swiftui-expert, dimillian--swiftui-ui-patterns, arjitj2--swiftui-design-principles
Performance SwiftUIdimillian--swiftui-performance-auditdpearson2699--swiftui-performance
Liquid Glassdimillian--swiftui-liquid-glassdpearson2699--swiftui-liquid-glass
Concorrênciatwostraws--swift-concurrency-prodimillian--swift-concurrency-expert, avdlee--swift-concurrency
Testestwostraws--swift-testing-proavdlee--swift-testing-expert, bocato--swift-testing
SwiftDatatwostraws--swiftdata-provanab--swiftdata-expert-skill
Core Dataavdlee--core-data-expert—
Acessibilidadedadederk--ios-accessibilitypasqualevittoriosi--swift-accessibility, rgmez--swiftui-accessibility-auditor
Arquiteturaefremidze--swift-architecture-skillarimunandar--vip-architecture
Segurançaivan-magda--swift-security-expertdpearson2699--ios-security
Design de APIerikote04--swift-api-design-guidelines-skillmartinlasek--swift-coding-guideline
Otimização de Buildavdlee--xcode-build-orchestratoravdlee--xcode-build-fixer
ASOeronred--aso-audittimbroddin--app-store-aso-skill
Figma → SwiftUIdaetojemax--figma-to-swiftui-skilljordancoin--pencil-ios-design
Simuladorconorluddy--ios-simulator-skillgetsentry--xcodebuildmcp-cli
Revisão de Códigodimillian--review-swarmarimunandar--code-review-checklist
Depuraçãodimillian--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.

Habilidades Relacionadas