> ## Documentation Index > Fetch the complete documentation index at: https://supastack.dev/llms.txt > Use this file to discover all available pages before exploring further. > For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt # スキル コーディングエージェントに、supastack の一般的な作業をキットが想定するやり方で教える、すぐ使える指示集。 ## スキルとは supastack には Agent Skills が同梱されています。作業が一致したときにコーディングエージェントが読み込む、短くタスクに特化した指示です。プロンプトのたびにキットの規約を推測させる代わりに、エージェントは機能・決済・データベース変更・テストで同じ手順に従います。スキルはオープンな Agent Skills フォーマットに従うため、Claude Code、Cursor、Codex、GitHub Copilot、Gemini CLI などの互換エージェントで動作します。 ## スキルの置き場所 スキルは `.agents/skills/` にあり、スキルごとに 1 つのフォルダと `SKILL.md` があります。Claude Code 用に `.claude/skills/` に同一のコピーがあります。 ## 読み込むエージェント Codex、Cursor、GitHub Copilot、Gemini CLI、OpenCode は `.agents/skills/` を読みます。Claude Code は `.claude/skills/` を読みます。リクエストが description に一致するとエージェントが自動で選びます。または「use the `database-schema-change` skill」のように名前で指定できます。 ## どのリポジトリに同梱されるか all-platforms リポジトリにはすべてのスキルが含まれます。web・mobile・desktop の各リポジトリには、それぞれに適用されるスキルが含まれます。エンドツーエンドテストと CI のスキルは all-platforms リポジトリにのみ同梱されます。 ## セットアップと環境 キットの起動・デプロイ・設定のためのスキル。 - **ローカル環境のセットアップ** (`local-environment-setup`) — ローカル環境の構築や修復に: 初回クローン、.env の欠落・破損、Postgres、マイグレーション、ポート。 - **デプロイと環境変数** (`deploy-and-env-vars`) — デプロイ、ホスティング先の選択、環境変数の追加・変更に。 - **依存関係の追加** (`adding-a-dependency`) — npm 依存関係の追加・アップグレード・移動・削除、または CI のライセンス/監査チェックの失敗時に。 - **アップストリームからの更新** (`upgrading-from-upstream`) — supastack の新しいリリースを、それを使って構築したプロダクトに取り込むときに。 ## 機能の構築 各プラットフォームにプロダクトの画面を追加するスキル。 - **Web 機能を追加** (`add-a-web-feature`) — 独自のデータ、Server Actions、ナビゲーション、テストを持つプロダクトページやセクションに。 - **API エンドポイントを追加** (`add-an-api-endpoint`) — 公開 /api/v1 エンドポイント、その OpenAPI ドキュメント、API キーのスコープの追加・変更に。 - **UI コンポーネントを追加** (`add-a-ui-component`) — セクション、ブロック、フォームコントロール、再利用コンポーネントをキットのスタイル規約に沿って作るときに。 - **テーマやスタイルを変更** (`change-the-theme-or-style`) — プロダクトの見た目を変えるとき: デザインスタイル、カラーパック、密度、角丸、フォント、レイアウト。 - **マーケティングページやブログ記事を追加** (`add-a-marketing-page-or-blog-post`) — 公開ページ、料金ページ、法的ページ、ブログ記事、ドキュメントガイドの追加・編集に。 - **モバイル画面を追加** (`add-a-mobile-screen`) — Expo モバイルアプリの画面を追加・変更するときに。 - **デスクトップ機能を追加** (`add-a-desktop-capability`) — Tauri デスクトップアプリを変更するとき: ウィンドウ、トレイ、グローバルショートカット、自動更新。 - **通知を追加** (`add-a-notification`) — アプリ内通知、プッシュ通知、ダイジェスト項目の追加に。 ## 認証と決済 サインイン、課金、プランのスキル。 - **認証方法を追加** (`add-an-auth-method`) — サインインを変えるとき: ソーシャルプロバイダー、マジックリンク、メールコード、パスキー、二要素認証。 - **決済プロバイダーを追加** (`add-a-payment-provider`) — 課金プロバイダーの有効化、またはチェックアウト・カスタマーポータル・Webhook を備えた新しい課金アダプターの作成に。 - **プランと価格を変更** (`change-plans-and-pricing`) — プランの追加・改名・価格変更に: 価格、トライアル、シート、権限、利用上限、クレジット。 ## データと連携 スキーマ、AI、ジョブ、メール、ストレージ、翻訳のスキル。 - **データベーススキーマの変更** (`database-schema-change`) — テーブル・カラム・インデックス・リレーションの追加・変更とマイグレーション生成に。 - **AI 機能を追加** (`add-an-ai-feature`) — モデル呼び出し、チャットやエージェントツール、永続 AI タスク、予算、BYOK に。 - **バックグラウンドジョブを追加** (`add-a-background-job`) — リクエスト後、タイマー、ワークスペース単位で動く処理に。 - **メールを追加・編集** (`add-or-edit-an-email`) — トランザクションメールの追加・変更や、配信プロバイダーの切り替えに。 - **ファイルストレージを使う** (`use-file-storage`) — アバター、ロゴ、添付ファイルなどのアップロードや保存ファイルに。 - **翻訳を追加** (`add-translations`) — ユーザー向けテキストの追加・変更・翻訳や、ロケールの追加に。 ## 品質とリリース テスト、検証、レビュー、CI のスキル。 - **ユニットテストを書く** (`writing-unit-tests`) — Vitest のユニットテスト・結合テストを書く・直すときに。 - **E2E テストを書く** (`writing-e2e-tests`) — Playwright の E2E テストをローカルや CI で追加・修正するときに。 - **変更を検証する** (`verify-changes`) — 引き継ぎ・コミット・PR 作成の前に、適切なチェックを選んで実行するために。 - **失敗した CI ランをデバッグ** (`debugging-a-failing-ci-run`) — GitHub Actions が失敗し、原因を見つけて直す必要があるときに。 - **PR をレビュー** (`reviewing-a-pr`) — PR や diff を正確さ、ワークスペース分離、規約の観点でレビューするときに。 ## 自分のスキルを追加 frontmatter の `name` と一致する名前のフォルダを作り、使うべき場面を説明する `name` と `description` を書きます。`.claude/skills/` にもコピーして、すべてのエージェントが見つけられるようにします。 ## 次へ [コーディングエージェントで構築する](https://supastack.dev/ja/docs/web/agents.md)