# Skill Craft

> Claude Codeスキルの作成・レビュー。新規スキルの設計ガイド、既存スキルの品質チェック、ベストプラクティスに基づく改善提案を行う。

- Skill: `majiayu000/skill-craft` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/skill-craft`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/skill-craft/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/skill-craft

---


# Skill Craft - スキル作成スペシャリスト

Claude Code スキルの作成とレビューを支援します。

## モード

### 1. 新規作成モード

スキルを新規作成する場合:

1. **目的の明確化**: スキルが解決する問題を特定
2. **トリガー設計**: いつスキルが呼び出されるべきか
3. **構造設計**: 単一ファイル vs マルチファイル
4. **SKILL.md 生成**: メタデータと本文を作成

### 2. レビューモード

既存スキルをレビューする場合:

1. **品質チェック**: [CHECKLIST.md](CHECKLIST.md) に基づく検証
2. **改善提案**: 具体的な修正案を提示
3. **ベストプラクティス適合度**: 公式ガイドとの照合

---

## 新規作成ワークフロー

### Step 1: 要件定義

ユーザーに以下を確認:
- スキルの目的（何を自動化/支援するか）
- 対象ユーザー（個人/チーム/組織）
- 必要なツール（Bash, Read, Edit, Task 等）

### Step 2: 設計

**name の決定:**
- 小文字、数字、ハイフンのみ（最大64文字）
- gerund形式推奨: `processing-pdfs`, `reviewing-code`
- 避ける: `helper`, `utils`, `tools`（汎用すぎる）

**description の作成:**
- 第三者視点で記述（「〜する」「〜を行う」）
- 何をするか + いつ使うかを明記
- ユーザーが使いそうなキーワードを含める
- 最大1024文字

### Step 3: 構造決定

**単一ファイル（シンプルなスキル）:**
```
my-skill/
└── SKILL.md
```

**マルチファイル（複雑なスキル）:**
```
my-skill/
├── SKILL.md        # 概要・ナビゲーション（500行以下）
├── REFERENCE.md    # 詳細リファレンス
├── EXAMPLES.md     # 使用例
└── scripts/        # ユーティリティスクリプト
```

### Step 4: メタデータ設定

仕様詳細は [REFERENCE.md](REFERENCE.md) を参照。

**必須フィールド:**
- `name`: スキル名
- `description`: 説明

**オプションフィールド:**
- `model`: 使用モデル（sonnet, opus, haiku）
- `allowed-tools`: 許可ツール制限
- `context`: `fork` でサブエージェント実行
- `user-invocable`: スラッシュメニュー表示制御

### Step 5: 本文作成

**原則:**
- Claude は賢い。既知の情報は省略
- 簡潔に。各段落がトークンコストを正当化できるか確認
- 具体的に。抽象的な説明より例を示す

**構成例:**
```markdown
# スキル名

## 概要
[1-2文で目的を説明]

## 使用方法
[具体的な手順]

## 例
[入出力の例]

## 参照
[詳細ドキュメントへのリンク]
```

---

## レビューワークフロー

### Step 1: スキルの読み込み

対象スキルの SKILL.md とサポートファイルを読み込む。

### Step 2: チェックリスト検証

[CHECKLIST.md](CHECKLIST.md) に基づいて検証。

### Step 3: 改善提案

問題点ごとに:
1. **問題**: 何が問題か
2. **理由**: なぜ問題か
3. **修正案**: 具体的なコード/テキスト

---

## 出力形式

### 新規作成時

```markdown
## 生成されたスキル

### メタデータ
- name: `xxx`
- description: `xxx`
- model: `xxx`（該当する場合）

### ファイル構造
[ディレクトリ構造]

### SKILL.md
[生成されたコンテンツ]

### 次のステップ
1. ファイルを配置
2. テスト実行
3. 必要に応じて調整
```

### レビュー時

```markdown
## レビュー結果

### 総合評価
[A/B/C/D]

### 良い点
- [具体的な良い点]

### 改善必須
- [問題] → [修正案]

### 改善推奨
- [問題] → [修正案]

### 提案
- [あれば良い改善]
```