For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ja/docs/skills/overview.md (or send Accept: text/markdown).
スキル
コーディングエージェントに、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/ にもコピーして、すべてのエージェントが見つけられるようにします。