# Skill Creator

> 新しいスキルを対話形式で作成するメタスキル。 スキルの作成、新規スキル追加、カスタムスキル開発、スキルテンプレート生成をサポート。 要件をヒアリングし、SKILL.md、scripts/、references/を自動生成する。 Use when user asks to create a new skill, add custom skill, or develop agent capabilities.

- Skill: `nomhiro/skill-creator` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add nomhiro/skill-creator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nomhiro/skill-creator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: nomhiro (https://skillmd.com/u/nomhiro)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nomhiro/skill-creator

---


# Skill Creator

新しいスキルを対話形式で作成するメタスキル。ユーザーから要件をヒアリングし、Anthropic公式形式のスキルを自動生成する。

## ワークフロー

### 1. 要件ヒアリング

ユーザーから以下の情報を対話形式で収集する：

- **スキル名**: hyphen-case形式（例: `my-new-skill`）、最大40文字
- **説明**: スキルの目的と発動条件（description）
- **必要なツール**: bash, python など
- **参照データの有無**: 参照ドキュメントやデータファイルが必要か

### 2. スキル初期化

テンプレートからスキルディレクトリを生成：

```bash
python skills/skill-creator/scripts/init_skill.py <skill-name> --path ./skills
```

生成されるディレクトリ構造：
```
skills/<skill-name>/
├── SKILL.md              # メタデータ + 指示
├── scripts/
│   └── example.py        # サンプルスクリプト
├── references/
│   └── api_reference.md  # 参照ドキュメント
└── assets/
    └── example_asset.txt # アセットファイル
```

### 3. SKILL.md編集

ヒアリング内容に基づいて`SKILL.md`を編集する。

**YAMLフロントマター形式**:
```yaml
---
name: skill-name
description: |
  スキルの説明。何ができるか、いつ発動するかを記述。
  Claudeがこの説明を見てスキルを使うかどうかを判断する。
allowed-tools:
  - bash
  - python
metadata:
  author: your-name
  version: 1.0.0
---
```

**本文**: Markdownでスキルの使用方法、手順、制約を記述。

### 4. 検証

スキル構造を検証：

```bash
python skills/skill-creator/scripts/quick_validate.py ./skills/<skill-name>
```

検証項目：
- SKILL.mdの存在
- YAMLフロントマターの形式
- name, descriptionの必須フィールド
- 命名規則（hyphen-case）
- 文字数制限（name: 64文字、description: 1024文字）

### 5. 完了報告

作成されたファイル一覧をユーザーに報告し、次のステップを案内する。

## 使用可能なスクリプト

| スクリプト | 用途 | 使用例 |
|-----------|------|--------|
| `init_skill.py` | スキルテンプレート生成 | `python scripts/init_skill.py my-skill --path ./skills` |
| `quick_validate.py` | スキル構造検証 | `python scripts/quick_validate.py ./skills/my-skill` |
| `package_skill.py` | .skillファイル作成 | `python scripts/package_skill.py ./skills/my-skill` |

## 命名規則

- **hyphen-case**: 小文字とハイフンのみ（`a-z`, `0-9`, `-`）
- **最大40文字**
- ハイフンで始まらない・終わらない
- 連続ハイフン禁止

**良い例**: `data-analyzer`, `pdf-processor`, `email-sender`
**悪い例**: `DataAnalyzer`, `data_analyzer`, `-invalid-`, `too--many`

## SKILL.md フォーマット詳細

### フロントマター（YAML）

| フィールド | 必須 | 説明 |
|-----------|------|------|
| `name` | ✅ | スキル名（hyphen-case、最大64文字） |
| `description` | ✅ | スキルの説明と発動条件（最大1024文字） |
| `license` | ❌ | ライセンス情報 |
| `allowed-tools` | ❌ | 使用可能なツールのリスト |
| `metadata` | ❌ | author, versionなどの追加情報 |

### 本文（Markdown）

- スキルの詳細な使用方法
- ワークフローの手順
- 使用可能なリソース（scripts, references）の説明
- 入力/出力の例
- 制約事項

## パッケージング（オプション）

スキルを配布可能な`.skill`ファイルにパッケージ化：

```bash
python skills/skill-creator/scripts/package_skill.py ./skills/<skill-name> ./dist
```

生成される`.skill`ファイルはZIP形式で、他の環境にインポート可能。

## 制約

- スキル名は一意である必要がある
- 既存スキルと同名の場合はエラー（上書きは確認後のみ）
- SKILL.mdの本文は500行以下を推奨
- 大量の参照データはreferences/に分割する

## 参考リンク

- [Agent Skills Overview](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview)
- [Agent Skills Best Practices](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)
- [Skills Cookbook](https://github.com/anthropics/claude-cookbooks/tree/main/skills)