Agent skill
skill-create
[スキル作成] 新しいスキルを壁打ち→テンプレ生成→登録確認まで
Stars
163
Forks
31
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/skill-create
SKILL.md
[スキル作成] 新しいスキルを壁打ち→テンプレ生成→登録確認まで
入力: $ARGUMENTS
- スキルの目的や名前(任意)
- 省略時: 壁打ちから開始
例: DBマイグレーション専用のスキルを作りたい react-query の判断軸が欲しい /deploy コマンドを追加したい
🎯 目的
- 新しいスキルを壁打ち→テンプレ生成→登録確認まで一気通貫でサポート
- 判断軸(role/tech)と手順系(user-invocable)の違いを明確にして設計
- 既存スキルとの重複を避け、適切な粒度で作成
共通前提(参照)
- 口調・出力規約は
CLAUDE.mdに従う。 - 既存スキル一覧は
.claude/skills/を参照。 - スキル命名規則は
doc/guide/commands_catalog.mdを参照。
フェーズ1: 壁打ち(要件整理)
質問リスト(順に確認)
Q1. スキルの種類は?
| 種類 | 説明 | 例 |
|---|---|---|
| 判断軸(role) | 役職・専門観点。AIが状況に応じて自動適用 | developer-specialist, ui-designer |
| 判断軸(tech) | 技術スタック固有の知識。rdd.mdの技術スタックで自動適用 | react, svelte, tailwind |
| 手順系 | /command で明示的に呼び出す。フロー型の作業手順 |
/task-run, /bug-fix, /design-mock |
Q2. 既存スキルとの関係は?
- 重複: 既存スキルでカバーできないか?
- 拡張: 既存スキルに追加すべきか?
- 新規: 完全に新しい観点・手順か?
bash
# 既存スキル一覧を確認
ls -la .claude/skills/
Q3. スキルのスコープは?
- いつ使う?: どんな状況で適用/呼び出すか
- 何をする?: 主な責務(1〜3文で)
- 何をしない?: 明示的なスコープ外
Q4. 命名は?
- 判断軸:
{観点}または{技術名}(例:security-expert,react) - 手順系:
{カテゴリ}-{動詞}(例:task-run,bug-fix,design-mock)
フェーズ2: テンプレ生成
判断軸(role/tech)テンプレート
markdown
---
category: role # または tech
description: "{1行説明}"
---
# {スキル名}
## いつ適用する?
<!-- rdd.mdの技術スタック、または状況に応じて -->
## 判断軸(このスキルが守る観点)
### {観点1}
- {具体的な基準}
- {具体的な基準}
### {観点2}
- {具体的な基準}
- {具体的な基準}
## やること / やらないこと
| やること | やらないこと |
|----------|--------------|
| {責務} | {スコープ外} |
## 参考リソース
- {公式ドキュメント等}
手順系(user-invocable)テンプレート
markdown
---
user-invocable: true
description: "[カテゴリ] {1行説明}"
---
# [カテゴリ] {タイトル}
## 入力: $ARGUMENTS
- {引数の説明}
例:
{使用例1}
{使用例2}
---
## 🎯 目的
- {目的1}
- {目的2}
---
## 共通前提(参照)
- 口調・出力規約は `CLAUDE.md` に従う。
- `doc/input/rdd.md` を読み、該当する `.claude/skills/*` を適用。
- 詳細運用は `doc/guide/ai_guidelines.md` を参照。
---
## 実行手順
### 1. {ステップ1}
{詳細}
### 2. {ステップ2}
{詳細}
### 3. {ステップ3}
{詳細}
---
## 出力
- {成果物1}
- {成果物2}
---
## 品質チェックリスト
- [ ] {チェック項目1}
- [ ] {チェック項目2}
---
## 自己評価
- **成功自信度**: (1-10)
- **一言理由**: {短く理由を記載}
フェーズ3: ファイル生成
壁打ちとテンプレ確認が完了したら、以下を実行:
bash
# ディレクトリ作成
mkdir -p .claude/skills/{skill-name}
# SKILL.md 作成(テンプレを元に生成)
# → Writeツールで出力
フェーズ4: 登録確認
4.1 ファイル構造チェック
bash
# 必須ファイルが存在するか
ls -la .claude/skills/{skill-name}/SKILL.md
4.2 YAML frontmatter チェック
bash
# frontmatterが正しいか確認
head -10 .claude/skills/{skill-name}/SKILL.md
判断軸の場合:
yaml
---
category: role # または tech
description: "{説明}"
---
手順系の場合:
yaml
---
user-invocable: true
description: "[カテゴリ] {説明}"
---
4.3 認識確認
bash
# Claude Codeでスキル一覧を確認
# /help または skill 一覧で表示されるか
4.4 カタログ更新(必要に応じて)
- 判断軸 →
doc/guide/skills_catalog.mdに追記 - 手順系 →
doc/guide/commands_catalog.mdに追記
参考: 既存スキルの構造
判断軸(role)の例: developer-specialist
.claude/skills/developer-specialist/SKILL.md
├── category: role
├── いつ適用する?
├── 判断軸(観点)
└── やること / やらないこと
判断軸(tech)の例: react
.claude/skills/react/SKILL.md
├── category: tech
├── いつ適用する?(rdd.mdの技術スタック)
├── フレームワーク固有の判断軸
└── パフォーマンス/設計の基準
手順系の例: task-run
.claude/skills/task-run/SKILL.md
├── user-invocable: true
├── 入力($ARGUMENTS)
├── 目的
├── 実行手順(1, 2, 3...)
├── 出力
└── 品質チェックリスト
壁打ち開始
入力がある場合は、上記の質問リストに沿って整理を開始する。 入力がない場合は、以下を質問:
📝 新しいスキルを作成します
まず教えてください:
1. どんな目的のスキル?(1〜2文で)
2. 判断軸(観点/技術)? それとも手順系(/command)?
3. 既存のスキルで似たものはある?
品質チェックリスト
- 既存スキルとの重複がない
- 命名規則に従っている(role/tech または カテゴリ-動詞)
- YAML frontmatter が正しい
- スコープ(やること/やらないこと)が明確
- カタログに追記済み(必要に応じて)
Didn't find tool you were looking for?