SKILL.md

name: skill-creator description: Create or update Claude Code skills. Use when user wants to create a new skill, update an existing skill, or needs guidance on skill design.

Skill Creator

原則

コンテキストは公共財

Claudeはすでに賢い。Claudeが知らない情報だけを追加する。

簡潔さ > 冗長な説明

冗長な説明より具体例。500行以下を目指す。

Skill vs Subagent

観点	Skill	Subagent
目的	知識・ルールの提供	タスクの委譲
コンテキスト	メイン会話に読み込まれる	分離される
適用例	SCSS変数、命名規則	E2Eテスト、大量リファクタ

構造

skill-name/
├── SKILL.md (必須)
└── references/ (任意)

Frontmatter（重要）

---
name: skill-name
description: 英語で記述。Claudeがトリガー判定に使用。
---

descriptionの書き方

形式: [何をするか]. Use when [トリガー条件].

良い例:

Edit SCSS styles with design system. Use when user mentions SCSS, CSS, style, color, or component styling.

悪い例:

SCSSを編集するスキル  # 日本語、トリガー条件なし

禁止事項

Claudeが既に知っている一般知識を書かない
冗長な説明（背景、歴史など）を書かない
READMEやCHANGELOGなどの補助ファイルを作らない

作成手順

目的を明確化
具体例を収集（Claudeが知らない情報は何か？）
.claude/skills/{name}/SKILL.md 作成
/skills で確認

スコア

総合スコア

55/100

リポジトリの品質指標に基づく評価

✓SKILL.md

SKILL.mdファイルが含まれている

+20

✓LICENSE

ライセンスが設定されている

+10

○説明文

100文字以上の説明がある

0/10

○人気

GitHub Stars 100以上

0/15

○最近の活動

3ヶ月以内に更新がある

0/10

○フォーク

10回以上フォークされている

0/5

✓Issue管理

オープンIssueが50未満

○言語

プログラミング言語が設定されている

0/5

○タグ

1つ以上のタグが設定されている

0/5

skill-creator