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.
インストール方法を見るインストールする前に、エージェントに与えられる指示の中身を確認できます。
効果的なスキルを作成・改善するためのガイド。
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」と依頼されたとき、または修正のあとに実機での裏付けが必要なときに使う。
`.agent/agents/` のエージェント定義を入口に、タスクを調査・計画・実装・レビュー・検証へ分担するスキル。ユーザーが「エージェント」「マルチエージェント」「orchestrator」「役割分担」「複数担当」などを求めたとき、または大きな変更で担当境界を決める必要があるときに使う。
AI向けマークダウンドキュメント（SKILL.md、AGENTS.md、.agent/*.md など）の健全性チェックと修正を支援するスキル。「ドキュメントの整合性を確認」「SSOT違反を探す」「スキル定義をメンテしたい」「PRの概要を更新したい」と依頼されたときに使用する。
ExecPlan（実行計画）の作成・検証・更新を支援するスキル。複雑なタスク（新機能開発、リファクタリング、バグ修正）の設計フェーズで使用します。`/create-plan`でプラン作成を開始。
不具合報告（GitHub Issue、フォーラム投稿、社内報告）を起点に、調査・再現・修正・検証・記録までを一貫実行するスキル。症状の切り分け、原因仮説の整理、最小再現、修正実装、ExecPlan作成、PR下書き、ナレッジ追記が必要なときに使う。
Evolution CMS JP Editionの開発タスクを実行するためのワークフロー、コマンド(/work, /start-session等)、およびコーディング規約ガイド。開発作業を開始する際に使用します。