Skill Creator
原則
コンテキストは公共財
Claudeはすでに賢い。Claudeが知らない情報だけを追加する。
簡潔さ > 冗長な説明
冗長な説明より具体例。500行以下を目指す。
Skill vs Subagent
| 観点 | Skill | Subagent |
|---|---|---|
| 目的 | 知識・ルールの提供 | タスクの委譲 |
| コンテキスト | メイン会話に読み込まれる | 分離される |
| 適用例 | SCSS変数、命名規則 | E2Eテスト、大量リファクタ |
構造
code
skill-name/ ├── SKILL.md (必須) └── references/ (任意)
Frontmatter(重要)
yaml
--- name: skill-name description: 英語で記述。Claudeがトリガー判定に使用。 ---
descriptionの書き方
形式: [何をするか]. Use when [トリガー条件].
良い例:
code
Edit SCSS styles with design system. Use when user mentions SCSS, CSS, style, color, or component styling.
悪い例:
code
SCSSを編集するスキル # 日本語、トリガー条件なし
禁止事項
- •Claudeが既に知っている一般知識を書かない
- •冗長な説明(背景、歴史など)を書かない
- •READMEやCHANGELOGなどの補助ファイルを作らない
作成手順
- •目的を明確化
- •具体例を収集(Claudeが知らない情報は何か?)
- •
.claude/skills/{name}/SKILL.md作成 - •
/skillsで確認