SwiftUI Agent Skills ガイド

1 つだけ選ぶなら：Apple が作成したガイダンスを使い、API のハルシネーションを減らしたい場合は ameyalambat128/swiftui-skills、iOS エンジニアリングを幅広く扱い、フレームワークごとに正確に振り分けたい場合は dpearson2699/swift-ios-skills を選びます。最も有効な組み合わせ：前者を信頼できる情報源の層として使い、後者からプロジェクトに必要な専門 Skill だけを 5〜10 個インストールします。

AI が生成する SwiftUI で最も多い問題は、構文エラーではなく、正しそうに見えるだけのコードです。状態の所有者が不明確、ナビゲーションパターンが古い、並行処理の境界が曖昧、存在しない API が使われている、といった問題があります。Agent Skills は、汎用モデルを Apple プラットフォームの明確なエンジニアリング制約に従う共同作業者へと変えます。

Agent Skill とは何か

Skill は通常、SKILL.md ファイルを含むディレクトリです。Codex、Claude Code、Cursor などのコーディングエージェントに、機能を有効にするタイミング、最初に読む参考資料、従うルール、結果の形式を伝えます。Xcode 拡張機能でも Swift パッケージでもありません。AI 向けのチーム開発ハンドブックと、対象を絞った知識集を組み合わせたものです。

すべてのルールを 1 つの巨大なプロンプトに入れる方法とは異なり、Skill は必要なときだけ読み込めます。SwiftUI のアニメーション作業ではアニメーションのガイダンス、コマース機能では StoreKit の購入と検証のルール、スクロールのデバッグではパフォーマンスのガイダンスが読み込まれます。タスクに合わせたコンテキストは通常、より正確で token の効率にも優れています。

2 つのアプローチを一覧で比較

アプローチ 1：Xcode ドキュメントを AI の信頼できる情報源にする

最も価値のある設計は、事実に関するすべての記述と API の根拠をローカルの /docs に求めるという明確なルールです。エージェントはコーディングの前にドキュメントを選び、レビュー時に使用したファイルを示します。型や API が見つからない場合は、もっともらしい名前を作らず、不確実であることを伝える必要があります。

抽出される資料は SwiftUI のレイアウトだけではありません。App Intents、AlarmKit、StoreKit、WebKit、SwiftData の継承、Swift Concurrency、Liquid Glass、visionOS のウィジェットに加え、InlineArray や Span などの低レベルなパフォーマンス機能も含まれます。

確認しておきたい制約

• macOS と Xcode 26 以降が必要です。ドキュメントのディレクトリにファイルが用意されるまで、Skill は SwiftUI のガイダンスを提供すべきではありません。
• 対象範囲の広い入口です。複雑なプロジェクトでは、「Apple ドキュメントを基準に状態の所有権とナビゲーションをレビューする」など、焦点を絞った依頼が引き続き必要です。
• ローカルの Xcode バージョンによって参考資料のバージョンが決まります。利用可能性について異なる結論が出ないよう、チームでツールチェーンを統一する必要があります。

アプローチ 2：組み合わせられる 84 の iOS Skill

このリポジトリは正確な振り分けを得意とします。Apple 開発の知識全体を毎回コンテキストに入れる必要はありません。SwiftData、StoreKit 2、App Intents、WidgetKit を使うサブスクリプションアプリなら、それらの Skill に SwiftUI パターン、Swift Concurrency、テスト、アクセシビリティを組み合わせてインストールできます。

以下は、この記事の更新時点における 84 の Skill の完全なカタログです。各グループを開くと、プロジェクトの技術構成に必要な範囲を確認できます。

選び方：数ではなくタスクから始める

シナリオ A：SwiftUI で AI を使い始める

まず swiftui-skills をインストールして Apple ドキュメントの制約を適用し、次に 84 の Skill コレクションから swiftui-patterns、swiftui-navigation、swift-concurrency、swift-testing、ios-accessibility を追加します。この 5 つは、新規プロジェクトで最も多い問題をカバーします。

シナリオ B：既存プロダクトに機能を追加する

いつか役立つかもしれない技術ではなく、現在使っている技術を基準に選びます。サブスクリプションには storekit、システムの表示領域には app-intents と widgetkit、データ量の多いアプリには swiftdata または core-data、オンデバイス AI 製品には apple-on-device-ai を追加します。

シナリオ C：コードレビューと信頼性の改善

swiftui-performance、debugging-instruments、metrickit、swift-security、ios-accessibility、app-store-review を優先します。このセットはコード生成よりも、リリースの品質を確認する役割に適しています。

インストール：一般的なエージェントと Codex

ローカルの Apple ドキュメント Skill をインストール

# 直接インストールし、Xcode からドキュメントを抽出
curl -fsSL https://swiftui-skills.ameyalambat.com/install | bash

# または skills CLI を使用
npx skills add ameyalambat128/swiftui-skills

リモートスクリプトをシェルに渡す前に、リポジトリ内のインストーラーを確認してください。インストール後は、インストールされた Skill のディレクトリから setup.sh を実行し、エージェントのセッションを再起動して新しい Skill を検出できるようにします。

84 の Skill コレクションから対話形式で選ぶ

# 対話型の選択画面を開き、Skill と対象エージェントを選ぶ
npx skills add dpearson2699/swift-ios-skills

# 選択した機能だけをインストール
npx skills add dpearson2699/swift-ios-skills \
  --skill swiftui-patterns \
  --skill swift-concurrency \
  --skill swift-testing

# 確認と更新
npx skills check
npx skills update

Codex に Skill を 1 つインストール

$skill-installer install \
  https://github.com/dpearson2699/swift-ios-skills/tree/main/skills/swiftui-patterns

最後のディレクトリを、カタログにある任意の Skill 名に置き換えます。プロジェクト固有のルールはプロジェクトのスコープに置き、再利用する SwiftUI とエンジニアリングのガイダンスは個人の共有スコープに置きます。

組み合わせて信頼性を高めるワークフロー

1. 目的とデプロイ先を明示します。タスクが機能追加、リファクタリング、レビューのどれかをエージェントに伝え、新しい API が無条件に使われないよう、iOS の最小バージョンを指定します。
2. 信頼できる情報源の層に、最初にドキュメントを選ばせます。swiftui-skills に、タスクで使用する Apple ドキュメントと利用可能性の制約を一覧にするよう依頼します。
3. タスクに必要な Skill だけを読み込みます。カタログ全体を 1 つのタスクに追加せず、ナビゲーションには swiftui-navigation、購入には storekit を使います。
4. すべての検証を求めます。エージェントにターゲットのビルドとテストの実行を依頼し、UI を変更した場合は Dynamic Type、VoiceOver、ダークモードも確認します。
5. 判断をプロジェクトのルールに記録します。繰り返し使うアーキテクチャ上の判断は、タスクごとに決め直すのではなく、プロジェクトの Skill または AGENTS.md に記載します。

再利用できるタスクプロンプトは、次のように始められます。

Use local Apple documentation as the API source of truth,
and use swiftui-patterns, swift-concurrency, and swift-testing.
Goal: implement a testable asynchronous loading screen for an iOS 26 app.
List the selected documentation and state ownership first, then modify the code, build, and run tests.
Do not introduce an architecture that the project does not already use.

バージョンとライセンス：最後に確認する 2 点

Apple プラットフォームの API は短期間で変わります。この記事は、2026 年 7 月 6 日の swiftui-skills の commit と、2026 年 7 月 4 日の swift-ios-skills の commit を基準に確認しました。リポジトリの内容、対応バージョン、Skill の数は変更される可能性があります。ベータ版のフレームワークは、常に現在の Xcode SDK で確認してください。

ライセンスも異なります。swiftui-skills は MIT、swift-ios-skills は PolyForm Perimeter 1.0.0 を使用しています。後者はアプリ開発と非公開ソースの商用ワークフローを許可しますが、競合製品としてコンテンツを再パッケージすることを制限しています。チームでの配布、変更、商用統合を行う前に、上流の LICENSE を確認してください。

よくある質問

SwiftUI Agent Skills は公式の Apple ドキュメントの代わりになりますか？

いいえ。Skill は、エージェントが適切なタイミングでルールを読み込み、適用できるようにします。最終的な API の利用可能性、プラットフォームの動作、レビュー要件は、現在の Xcode SDK と公式の Apple 資料で引き続き確認する必要があります。

両方の Skill ライブラリをインストールできますか？

はい。2 つは互いを補完します。一方はローカルの Apple ドキュメントを信頼できる情報源として提供し、もう一方は対象を絞ったフレームワークとエンジニアリングのワークフローを提供します。最初からすべてをインストールせず、プロジェクトごとに Skill を選んでください。

84 の Skill をすべてインストールする方がよいですか？

必ずしもそうではありません。多くの Apple プラットフォーム向けプロジェクトを保守するチームには役立つ場合がありますが、単一のプロダクトでは通常、よく使う Skill を 5〜10 個に絞る方が明確で、ガイダンスの出典も追いやすくなります。

これらの Skill は Codex 専用ですか？

いいえ。どちらのリポジトリも、Codex、Claude Code、Cursor を含む複数のエージェントに対応しています。インストール先と検出方法は、各エージェントの現在のバージョンによって異なります。