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?

Be as detailed as possible for better results