Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations. Use when: (1) creating a new SKILL.md, (2) initializing a skill directory, (3) packaging a .skill file, (4) improving or iterating on an existing skill, (5) understanding skill best practices and design patterns.
中文简介正在准备中。当前显示原文说明。
查看安装方法安装前可以查看交给 AI 代理的指令内容。
効果的なスキルを作成・改善するためのガイド。
skill-name/
├── SKILL.md - 必須。frontmatter (name + description) + 指示
├── scripts/ - 実行可能コード（Python/Bash等）
├── references/ - 必要時にロードするドキュメント
└── assets/ - 出力で使用するファイル（テンプレート等）
設計原則、各リソースの詳細、プログレッシブディスクロージャーパターンについては references/skill-design-guide.md を参照。
スキル作成には以下のステップが含まれます：
これらのステップを順番に従い、適用できない明確な理由がある場合にのみスキップしてください。
使用パターンが明確な場合はスキップ可。ユーザーに以下を質問して具体例を収集する：
1つのメッセージで質問しすぎず、最重要な質問から始める。
具体的な例を効果的なスキルに変えるには、各例を次のように分析します：
例：PDO移行を支援するpdo-migrationスキルの場合：
mysql_*使用箇所の棚卸しと置換パターンの把握が毎回必要references/affected-files.md（使用箇所一覧）+ references/patterns.md（旧→新の置換ルール）例：jQuery廃止を支援するjquery-removalスキルの場合：
references/jquery-inventory.md（ファイル別jQuery使用状況）+ references/conversion-rules.md（jQueryパターン→ES6+対応表）例：DocumentParser周辺の不具合調査を支援するparser-debuggerスキルの場合：
references/parse-flow.md（処理ステージ一覧・フック箇所）+ デバッグ用ログ挿入パターンスキルの内容を確立するには、各具体例を分析して、含める再利用可能なリソースのリストを作成します：スクリプト、リファレンス、アセット。
既存スキルの反復・パッケージ化の場合はスキップ。新規作成時は init_skill.py を実行してテンプレートを生成する：
scripts/init_skill.py <skill-name> --path <output-directory>
SKILL.mdテンプレート、scripts/・references/・assets/のサンプルが生成される。不要なサンプルは削除する。
スキルは別のClaudeインスタンスが使用するために作成される。Claudeにとって自明でない手続き的知識やドメイン固有の詳細を含めること。
既存スキル（project-worker、issue-resolver）のパターンに従う：
## コマンド セクションに /command-name + 番号付きステップAGENTS.md を参照する旨を記載ステップ2で特定した scripts/、references/、assets/ から実装を開始する。追加したスクリプトは実行テストすること。
執筆ガイドライン： 常に命令形/不定詞形を使用。
name：ハイフンケースのスキル名description：スキルの内容＋トリガー条件。descriptionにすべての「いつ使用するか」情報を含める（ボディはトリガー後にのみロードされるため）
スキルとそのバンドルされたリソースの使用方法に関する指示を記述する。
配布が必要な場合のみ実行。.skillファイル（zip形式）を作成する：
scripts/package_skill.py <path/to/skill-folder> [output-directory]
自動検証（frontmatter、命名規則、description）後にパッケージ化される。ローカルで使うだけならこのステップは不要。
スキルをテストした後、ユーザーは改善を要求する場合があります。これは多くの場合、スキルの使用直後に、スキルのパフォーマンスに関する新鮮なコンテキストとともに発生します。
反復ワークフロー：
还没有评价。欢迎分享你的使用感受。
无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。
还没有评论。来写第一条吧。
改修後の動作確認を、AIが自分で環境を立てて最後まで進めるための検証スキル。CLI（curl / php evo / DB）を優先し、画面操作でしか判定できないときだけ Playwright（既定はヘッドレス）に切り替える。Docker の検証環境の起動、インストール、テスト用ユーザー作成、mailpit でのメール確認、main との比較、後片付けまでを扱う。「動作確認」「自走で確認」「実環境で確かめる」「ブラウザで確認」「再現を確認」「Playwright」と依頼されたとき、または修正のあとに実機での裏付けが必要なときに使う。
中文简介正在准备中。当前显示原文说明。
非公開のセキュリティアドバイザリ（下書き）で扱う修正を、人の確認を待たずに「準備 → 実装 → 範囲の照合 → 検証 → 自己レビュー → 一時的な非公開フォークへの push → フォーク内の PR」まで進めるスキル。`/run-advisory <GHSA-ID> <計画のパス>` を提供する。ユーザーが「/run-advisory」「アドバイザリを自走で直して」「非公開フォークで修正を進めて」と依頼したときに使う。公開の Issue や ExecPlan を回すなら exec-plan-runner を使う。
中文简介正在准备中。当前显示原文说明。
`.agent/agents/` のエージェント定義を入口に、タスクを調査・計画・実装・レビュー・検証へ分担するスキル。ユーザーが「エージェント」「マルチエージェント」「orchestrator」「役割分担」「複数担当」などを求めたとき、または大きな変更で担当境界を決める必要があるときに使う。
中文简介正在准备中。当前显示原文说明。
AI向けマークダウンドキュメント（SKILL.md、AGENTS.md、.agent/*.md など）の健全性チェックと修正を支援するスキル。「ドキュメントの整合性を確認」「SSOT違反を探す」「スキル定義をメンテしたい」「PRの概要を更新したい」と依頼されたときに使用する。
中文简介正在准备中。当前显示原文说明。
ExecPlan（実行計画）の作成・検証・更新を支援するスキル。複雑なタスク（新機能開発、リファクタリング、バグ修正）の設計フェーズで使用します。`/create-plan`でプラン作成を開始。
中文简介正在准备中。当前显示原文说明。
Issue または ExecPlan を、人の確認を待たずに「準備 → 実装 → 範囲の照合 → 検証 → 自己レビュー → push → PR」まで進めるスキル。`/run-issue <番号>`・`/run-plan <ExecPlan のパス>`・`/finish-task` を提供する。ユーザーが「/run-issue」「/run-plan」「Issue を自走で直して」「ExecPlan を最後まで進めて」「0 節の Issue を順に片付けて」と依頼したときに使う。ExecPlan を作るだけなら exec-plan、次のタスクを選ぶだけなら roadmap-manager を使う。
中文简介正在准备中。当前显示原文说明。