| name | write-skill |
| description | 公式のベストプラクティスに従って Claude エージェントスキル（SKILL.md、リファレンスファイル、ユーティリティスクリプト）を設計し、実装する。スキルの作成、執筆、構築、更新、改善を求められた場合、SKILL.md に言及された場合、または Claude エージェントの能力を設計する場合に使用する。 |
| allowed-tools | ["Bash","Glob","Grep","Read","Edit","Write"] |
スキルの執筆
ワークフロー
ステップ 1: 要件の収集
ユーザーに確認する:
- スキルがカバーするタスクやドメインは何か？
- 対応すべき具体的なユースケースは何か？
- 実行可能なスクリプトが必要か、それとも指示だけでよいか？
- 含めるリファレンス素材（ドキュメント、スキーマ、例）はあるか？
ステップ 2: 環境の確認
ファイルを書く前に、既存のレイアウトを把握する:
ls <skills-root>/
代表的な SKILL.md を 1 つ読み、命名規則、フロントマターフィールド、スタイルを確認する。それらの規則を正確に踏襲する。
ステップ 3: スキルの草案作成
skill-name/
├── SKILL.md # 必須。500 行以内に収める。
├── references/ # ドメイン固有・めったに参照しない内容はここに
│ └── topic.md
└── scripts/ # 確定的で再利用可能な操作はここに
└── helper.py
SKILL.md テンプレート:
---
name: skill-name
description: 何をするスキルか。Use when [特定のキーワード / コンテキスト / ファイルタイプ]。
---
# スキル名
## クイックスタート
[最小限の動作例]
## ワークフロー
[複雑なタスクのステップバイステップチェックリスト]
## 高度な機能
詳細は [topic.md](references/topic.md) を参照
ユーザーへ提示する前に、レビューチェックリストでセルフチェックする。
ステップ 4: ユーザーとのレビュー
- ユースケースをカバーしているか？
- 欠けている点や不明な点はないか？
- 詳細を増やすべきセクションや減らすべきセクションはないか？
ユーザーが満足するまで繰り返す。
命名規則
| 制約 | ルール |
|---|
| フォーマット | 小文字、数字、ハイフンのみ |
| 最大文字数 | 64 文字 |
| 推奨スタイル | 動名詞形: processing-pdfs, writing-skills |
| 禁止 | 予約語: anthropic-*, claude-*; XML タグ |
description の規則
- 最大 1024 文字；XML タグ禁止；常に三人称で記述する
- 第一文: 何をするか。第二文:
Use when [特定のトリガー]
良い例: "Excel スプレッドシートを分析してピボットテーブルを作成する。.xlsx ファイル、表形式データ、スプレッドシートを分析する場合に使用する。"
悪い例: "ドキュメントを支援する。"（スキル選択のコンテキストが何もない）
自由度のレベル
タスクの脆弱性に応じて指示の具体性を調整する:
- 高（テキスト形式の指示）: 複数の有効なアプローチがあり、コンテキストに依存するヒューリスティック
- 中（パラメータ付きテンプレート）: 望ましいパターンがあるが、多少の変動は許容
- 低（正確なコマンドやスクリプト）: 厳格な一貫性が求められる脆弱なシーケンス
レビューチェックリスト
パターン、アンチパターン、評価の詳細なガイダンスについては:
references/BEST-PRACTICES.md を参照
注意事項
- スキルを呼び出したときにユーザーが使用した言語で常に応答する
