skills-create

Skills Create — メタスキル

スキルを作成し、リファクタリングするスキルです。役割は2つです。

• 作成： ゼロから（または既存のプロンプト／コマンドから）新しいスキルを作成します。
• リファクタリング： 肥大化したスキルを分割します。詳細は references/ に移し、出力形式は templates/ に移し、SKILL.md をポインターだけの簡潔な骨組みにします。

教える内容と同じ方法で作られています。 詳細は references/ に委ねた、簡潔な本文が特徴です。これが段階的な情報開示であり、このスキル自体が実例になっています。すべて組み合わせ可能な Markdown です。 スキルは SKILL.md と、エージェントが必要になったときにだけ読み込む任意のファイルで構成されます。

内容ではなく、作り方を規定する

スキルの作り方には厳格に、個々のスキルやその出力に含める内容には中立になってください。

• 規定する（厳格かつ普遍的）： 段階的な情報開示 · 三人称で、トリガーとなる条件を豊富に含む description · 命令形で簡潔な本文 · 重複なし · 同梱ファイルすべてへの導線 · 意図的な呼び出し制御 · スキルの種類に合った検証。（references/skill-standards.md を参照してください。）
• 規定しない（作成者の判断に任せる）： 計画／PRD／レポートに含めるセクション、ドメイン用語、出力形式、存在するフェーズ。決まった出力形式はありません。作成者を適切な判断へ導き、固定の形式を押し付けないでください。

作り方には厳格に、内容については作成者の自由を保ちます。(指針を示し、規定はしないでください。また、既存のものを使うか構築するかについては、プロセスを自分で管理し、自分のやり方に従わせたい場合にスキルを構築します。)

まずスキルの種類を分類する

作り方を適用する前に、種類を見極めてください。指針の適用度合いは種類に応じて変わり、すべてに同じものを適用するわけではありません。

種類	内容	適用する指針
ワークフロー	複数ステップの手順（計画、レビュー、出荷）	検証可能なゲートを含む、すべての指針
成果物生成	ドキュメント／出力を生成する	Context-is-King ＋ 推奨する（必須ではない）出力形式
知識／リファレンス	エージェントが参照する情報	Context-is-King ＋ 情報密度の高さ。フェーズも検証ループも不要
ツールラッパー	スクリプト／CLI／API を操作する	決定論的なスクリプト ＋ 明確なトリガー。検証にはツール自身の終了コードを使用

スキルは複数の種類を組み合わせることもできます。該当する指針を組み合わせて適用してください。ワークフローの仕組み（フェーズ、ループ、出力の骨組み）を知識スキルに無理に適用しないでください。詳細は references/skill-standards.md →「Skill types」を参照してください。

ステップ 0 — モードを選ぶ（$ARGUMENTS から）

$ARGUMENTS を解析し、モードと対象を選びます。

• create [<name>] で始まる場合（または新しいスキルの作成依頼だと明らかな場合）→ 作成モード。名前が指定されていれば、<name> をスキル名として使用します → references/creating-skills.md に従います。
• refactor <path/to/SKILL.md> で始まる場合（または既存のスキルを指している場合）→ 指定されたパスを対象とするリファクタリングモード → references/refactoring-skills.md に従います。
• 空欄または不明確な場合 → モードと、スキル／対象について尋ねます。推測しないでください。

どちらのモードも同じ作り方のルールに従います → まず references/skill-standards.md を読んでください。

作成 — 簡潔な骨組み（詳細は references/creating-skills.md）

1. コンテキストを集める — 起動のきっかけとなる具体的な表現、タスクの開始から完了まで、注意点、模倣するパターンを確認します。ユーザーに尋ね、まだ書き始めないでください。
2. リソースを計画する — 繰り返す処理は scripts/ へ、作業の参考になる情報は references/ へ、出力の形を定めるものは templates/ へ移します。自分が管理せず、上流で変わるものはパス／URL を記載します。実行時にしか得られない情報は収集します（ユーザーに尋ねる、Git／コードベースを読む）。
3. ひな形を作る — templates/SKILL.template.md を .claude/skills/<name>/SKILL.md にコピーします。計画に応じて references/ や templates/ も追加します。
4. まず骨組みを書く — 三人称でトリガーとなる条件を豊富に含む description と、命令形で簡潔な本文を書き、詳細はリファレンスに移します。リファレンスを書く前に、まず起動される状態にしてください。
5. 検証して反復する — references/validation.md に従い、チェックリスト → トリガーテスト → 実際に実行、の順で進めます。

リファクタリング — クイック手順（全詳細：references/refactoring-skills.md）

1. SKILL.md を棚卸しし、各ブロックに 中核（残す）または 抽出可能（出力テンプレート、スキーマ、長い例、網羅的なパターン／エッジケースの一覧）の印を付けます。
2. 対象スキルの references/（出力形式の場合は templates/）にそのまま抽出します。動作に影響する内容は言い換えないでください。
3. 参照先に置き換えます。常に必要な内容には、必読の行（「出力を生成する前に、templates/<x>.md を読んでください」）を追加し、必要な場合に限られる内容には遅延参照を追加します。
4. 動作保持を確認します。プロセスも出力も以前と同じであることを確認します。失われた内容も重複した内容もないことを確認します。
5. 検証します。references/validation.md を参照してください。

リファクタリングで最も注意すべきリスク： 常に必要な出力形式を、遅延読み込みされる参照先に移動してしまうことです。エージェントがそれを読まず、出力が気付かないうちに変わってしまいます。このような抽出を行う場合は、必ず必読の行を追加してください。

スキルを作成するタイミング

プロセスを自分で管理していて、エージェントにその進め方を繰り返し守らせたい場合に作成します。これが「使うか作るか」の判断基準です。大まかな目安として、同じ指示を約3回与えたら（「3回のルール」）、スキルとして蓄積しましょう。一度限りの作業や、すでに優れたスキルを提供しているツールのために、スキルを作成する必要はありません。

リソース

• references/skill-standards.md — スキルの種類、構造、コンテキストソース、フロントマターの仕様、段階的な情報開示、文体、重複の防止、「構造はメンテナーの存在を示唆する」という考え方、連携、移植性など、作成時のルールを説明します。
• references/creating-skills.md — 作成手順の完全版（既存のプロンプト／コマンドの移植を含む）です。
• references/refactoring-skills.md — 分割と簡素化の手順の完全版です。変更前後の例もあります。
• references/validation.md — 検証ゲート（構造・説明・本文・情報開示・動作・トリガーテスト）です。
• templates/SKILL.template.md — スキルのひな型にする、簡潔な SKILL.md の骨組みです。