skill-new

skill-new

適切な形式の SKILL.md を含む新しいスキルフォルダーを、現在のプロジェクトの構成に従って作成します。

使用しない場合

有効化する条件は、フロントマターの when_to_use フィールドに記述します。 既存のスキルを編集する場合は有効化しないでください。 新しいスキルを作成する場合にのみ使用します。

収集する入力情報

ファイルを書き込む前に、次の情報を確認してください。

1. name — 小文字で、ハイフン区切りの名前。既存のスキルと重複しないこと。 明らかな場合はユーザーの依頼から導きます。 そうでなければ、ユーザーに確認してください。
2. description — スキルの機能を説明する1～2文。 簡潔にしてください。 有効化条件は when_to_use に記述します。 不明な場合はユーザーに確認してください。
3. when_to_use — エージェントがこのスキルを有効化する条件を示します。 ユーザーが使いそうな表現、ファイルの種類、プロジェクトの構成などを記述します。 エージェントは description と when_to_use を合わせて照合するため、具体的に記述してください。 不明な場合はユーザーに確認してください。
4. 本文の内容 — スキルが有効化されたときにエージェントが実行する手順。 ユーザーが手順を説明していない場合は、確認してください。

配置先ディレクトリの決定

プロジェクト内で既存の SKILL.md ファイルが配置されている場所を確認し、同じ規則に従います。 一般的な構成は次のとおりです。

• skills/<name>/SKILL.md — 複数のスキルを含むリポジトリで最も一般的
• .claude/skills/<name>/SKILL.md — Claude 固有のプロジェクト構成
• リポジトリのルートにある <name>/SKILL.md — フラットな構成

既存のスキルが見つからない場合は、skills/<name>/SKILL.md を既定の配置先にします。

手順

1. 上記の規則に従って配置先ディレクトリを決定します。
2. 配置先のパスがまだ存在しないことを確認します。 すでに存在する場合は、上書きするか別の名前にするか、ユーザーに確認してください。
3. ディレクトリを作成します。
4. 以下のテンプレートを使用して SKILL.md を作成します。
5. 作成したパスを報告します。

SKILL.md テンプレート

---
name: <name>
description: >-
  <one or two sentences: what the skill does>
when_to_use: >-
  <triggers: phrases the user might say, file types, project shapes>
---

# <Human-readable title>

<One-paragraph summary of what the skill does.>

## Steps

1. <First action>
2. <Second action>
3. <Final action>

ルール

• スキルに必要な場合を除き、scripts/ や references/ サブフォルダーを追加しないでください。 雛形は最小限に保ちます。
• スキルごとの README は作成しないでください。 ドキュメントは SKILL.md に記述します。
• フロントマターの name はフォルダー名と一致させてください。