---

name: create-skill description: 既存設定と完全に整合したスキルを自動作成。~/.claude/CLAUDE.md、context/*.md、既存スキルを自動参照し、重複・競合を避けたスキルを生成。

Create Skill

既存のuser-level/project-level設定と整合性が取れたスキルを自動作成する。

使い方

Copy/create-skill <内容>                 # user scope（デフォルト）
/create-skill --user <内容>          # user scope（明示）
/create-skill --project <内容>       # project scope

ワークフロー

Step 1: 引数パース

Copy入力: /create-skill --project 大規模タスク分割ワークフロー
→ scope: project
→ 内容: 大規模タスク分割ワークフロー

Step 2: 既存設定の読み込み（必須）

常に読み込む:

• ~/.claude/CLAUDE.md - user-level設定
• ~/.claude/context/*.md - 特に以下が重要:
  • claude-customization-guide.md - Skills/Commands/CLAUDE.mdの使い分け
  • workflow-rules.md - Phase 0-5ワークフロー
  • memory-file-formats.md - メモリディレクトリ構造

--project時に追加で読み込む:

• ./CLAUDE.md - project-level設定
• ./context/*.md - project-level参照ファイル

既存スキルの確認:

• ~/.claude/skills/*/SKILL.md のfrontmatter（name, description）を取得
• 重複・競合がないか確認

Step 3: Skill vs Command vs CLAUDE.md 判定

@context/claude-customization-guide.md に従い判定:

Step 4: 整合性チェック

1. ワークフローとの整合: Phase 0-5、4ステップ構造との関係
2. ディレクトリ構造: MEMORY_DIR、memory/、tasks/等との整合
3. 既存スキルとの重複: 同じ機能を持つスキルがないか
4. スコープ判定: user vs project（@context/claude-customization-guide.md参照）

問題があればAskUserQuestionで確認。

Step 5: スキル設計

設計原則（@context/claude-customization-guide.md）:

• SKILL.mdは500行以下
• descriptionに「何をするか」+「いつ使うか」
• 詳細は別ファイルに分割（参照は1階層のみ）
• 既存設定を@context/xxx.md形式で参照（重複記載しない）

description例:

Copy# Good
description: PRレビュー。PR番号・ブランチ名指定時またはレビュー依頼時に使用。

# Bad
description: PRレビュー。

Step 6: スキル作成

配置先:

• --user: ~/.claude/skills/<skill-name>/
• --project: ./.claude/skills/<skill-name>/

構造（Progressive Disclosure）:

Copy<skill-name>/
├── SKILL.md              # Level 2: トリガー時ロード（500行以下）
└── references/           # Level 3: 必要時のみロード
    └── detail.md

Step 7: 確認

作成後、以下を報告:

• 作成したファイル一覧
• 既存設定との関係
• 使い方の例

SKILL.md テンプレート

Copy---
name: <skill-name>
description: <何をするか>。<いつ使うか>。使用タイミング: (1) xxx、(2) yyy。
---

# <Skill Name>

[1-2文で概要]

## 既存設定との関係

- **Phase 0-5（@context/workflow-rules.md）**: [補完/拡張/独立]
- **メモリディレクトリ（@context/memory-file-formats.md）**: [既存構造を使用/拡張]

## ワークフロー

[具体的な手順]

## 既存設定への参照

- @context/workflow-rules.md
- @context/memory-file-formats.md

禁止事項

• 既存設定との整合性確認なしでスキル作成
• 既存スキルと重複する機能の作成
• SKILL.mdに500行以上記載
• references/内で更にファイル参照（1階層まで）
• descriptionに「いつ使うか」がない

チェックリスト

• ~/.claude/CLAUDE.md を読んだか
• ~/.claude/context/claude-customization-guide.md を確認したか
• 既存スキル一覧を確認したか
• Skill/Command/CLAUDE.md追記の判定をしたか
• descriptionに「何を」「いつ」が含まれるか
• SKILL.mdは500行以下か
• @context/xxx.md 形式で参照を記載したか