# skills-creator

> Claude Codeのスキル（SKILL.md）を対話形式で作成するスキル。ユーザーが「スキルを作成」「新しいスキルを作りたい」「スキル作成を手伝って」と依頼した時に使用。個人用スキルまたはプロジェクトスキルを作成し、適切な構造とベストプラクティスに従ったSKILL.mdファイルを生成する

- Author: suu3
- Repository: suu3play/.claude
- Version: 20260105083541
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/suu3play/.claude
- Web: https://mule.run/skillshub/@@suu3play/.claude~skills-creator:20260105083541

---

---
name: skills-creator
description: Claude Codeのスキル（SKILL.md）を対話形式で作成するスキル。ユーザーが「スキルを作成」「新しいスキルを作りたい」「スキル作成を手伝って」と依頼した時に使用。個人用スキルまたはプロジェクトスキルを作成し、適切な構造とベストプラクティスに従ったSKILL.mdファイルを生成する
allowed-tools: Read, Write, Bash, Glob, AskUserQuestion
---

# Skill Creator

効果的なスキルを作成するためのガイダンスを提供するスキル。

## スキルの基本

スキルは特定のドメインやタスクに特化した知識、ワークフロー、ツールを提供するモジュール式パッケージ。Claudeを汎用エージェントから専門エージェントに変換する「オンボーディングガイド」として機能する。

### スキルが提供するもの

1. **専門ワークフロー** - 特定ドメインの多段階手順
2. **ツール統合** - 特定ファイル形式やAPIの操作手順
3. **ドメイン専門知識** - 企業固有の知識、スキーマ、ビジネスロジック
4. **バンドルリソース** - 複雑で反復的なタスク用のスクリプト、リファレンス、アセット

### スキルの構成

```
skill-name/
├── SKILL.md (必須) - メタデータ + Markdown指示
├── scripts/ (任意) - 実行可能コード (Python/Bash等)
├── references/ (任意) - 必要時に読み込むドキュメント
└── assets/ (任意) - 出力に使用するファイル
```

**詳細**: `references/skill-examples.md`で具体例を確認

### Progressive Disclosure

スキルは3段階のコンテキスト管理を使用：

1. **メタデータ** (name + description) - 常時 (~100語)
2. **SKILL.md本文** - スキル起動時 (<5k語)
3. **バンドルリソース** - Claudeが必要に応じて (無制限*)

*スクリプトはコンテキストに読み込まずに実行可能

## スキル作成プロセス

以下の手順に従い、明確な理由がない限りステップをスキップしない。

### Step 1: 具体例でスキルを理解

**目的**: スキルの使用パターンを明確に理解する

**実施内容**:
- ユーザーから具体的な使用例を収集
- 「どのような機能が必要か」「どう使われるか」「起動ワードは何か」を確認
- 一度に多くの質問をせず、重要なものから始める

**完了条件**: スキルがサポートすべき機能が明確

**詳細**: `references/skill-creation-process.md` の Step 1

### Step 2: 再利用可能リソースを計画

**目的**: 各具体例から必要なリソースを特定

**実施内容**:
各例について以下を分析：
1. ゼロから実行する方法を考える
2. 繰り返し実行時に役立つ scripts/references/assets を特定

**成果物**: 含めるべきリソースのリスト

**詳細**: `references/skill-creation-process.md` の Step 2

### Step 3: スキルを初期化

**実施**: 新規作成時のみ `init_skill.py` を実行

```bash
scripts/init_skill.py <skill-name> --path <output-directory>
```

スクリプトが自動生成：
- SKILL.mdテンプレート（フロントマター + TODOプレースホルダー）
- scripts/, references/, assets/ ディレクトリ
- 各ディレクトリの例示ファイル（カスタマイズまたは削除可能）

**スキップ**: 既存スキルの反復やパッケージ化の場合

### Step 4: スキルを編集

#### 4.1 バンドルリソースから開始

Step 2で特定した scripts/, references/, assets/ ファイルを実装。必要に応じてユーザー入力を求める。不要な例示ファイルは削除。

#### 4.2 SKILL.mdを更新

**記述スタイル**: 命令形/不定詞形（動詞優先）を使用。二人称は使用しない。
- 良い例: "Xを達成するには、Yを実行する"
- 悪い例: "Xすべきです" "Xする必要がある場合"

**完成のための質問**:
1. スキルの目的は？（数文で）
2. いつ使用されるべきか？
3. Claudeはどのように使用すべきか？（再利用可能リソースの使用方法を含む）

**重要**: 本質的な手続き的指示のみをSKILL.mdに。詳細情報はreferencesへ。

**詳細**: `references/skill-creation-process.md` の Step 4

### Step 5: パッケージング

**コマンド**:
```bash
scripts/package_skill.py <path/to/skill-folder>
```

**動作**:
1. 自動検証（フロントマター、命名規則、構造、参照）
2. 検証通過時、zipファイル作成（例: `my-skill.zip`）

検証失敗時はエラー報告。修正後に再実行。

### Step 6: 反復

**ワークフロー**:
1. 実際のタスクでスキルを使用
2. 困難や非効率性に気づく
3. 更新箇所を特定
4. 実装して再テスト

## リファレンス

- **詳細プロセス**: `references/skill-creation-process.md` - 各ステップの詳細、ベストプラクティス
- **成功事例**: `references/skill-examples.md` - 構造例、成功/失敗事例の比較