Smithery is now a part of Arcade.dev! Read more in our announcement here
Provides guidance for creating effective Claude Code skills with proper YAML frontmatter, directory structure, and best practices...
スキル作成のガイド。Claude Codeの機能を拡張するスキルを効果的に作成する方法を説明。
スキルはClaudeの機能を拡張するフォルダ構造。モデル自動発見—Claudeがリクエストに基づいて自動的に使用を判断する（スラッシュコマンドとは異なり明示的な呼び出し不要）。
Personal: ~/.claude/skills/skill-name/SKILL.md
Project: .claude/skills/skill-name/SKILL.md
Plugin: パッケージに同梱
mkdir -p .claude/skills/my-skill-name
---
name: skill-identifier # 必須: 小文字/数字/ハイフンのみ、64文字以内
description: 何をするか + いつ使うか # 必須: 1024文字以内、トリガーキーワード含む
allowed-tools: Read, Grep, Edit # オプション: ツール制限
---
name規則:
api-docs-writer, db-migration-helperdescription規則:
# ✅ GOOD
description: E2Eテストの作成・デバッグ・失敗修正を支援。Playwrightテスト失敗時、新規テスト作成時に使用。
# ❌ BAD
description: テストを手伝う
# Skill Title
概要（1-2文）
## When to Use This Skill
- シナリオ1
- シナリオ2
## Instructions
1. **Step 1**: 最初にやること
2. **Step 2**: 次にやること
3. **Step 3**: 最後にやること
## Examples
### Example 1: [シナリオ]
[コード例]
## Troubleshooting
**Issue**: 問題
**Solution**: 解決方法
## AI Assistant Instructions
このスキルが有効化された時:
1. まず○○を確認
2. 次に○○を実行
Always:
- 常に○○する
Never:
- ○○しない
allowed-tools: Read, Grep, Glob # 読み取り専用
my-skill-name/
├── SKILL.md # メイン（必須、500行以下）
├── reference.md # 詳細リファレンス（必要時読み込み）
└── templates/ # テンプレート
SKILL.mdから参照:
詳細は [reference.md](reference.md) を参照。
# ✅ DO
- api-docs-writer: API文書生成
- test-strategy: テスト実装
# ❌ DON'T
- developer-helper: 何でも（曖昧）
# ✅ GOOD
description: OpenAPI/Swagger文書をExpress/FastAPIから生成。API文書作成時に使用。
# ❌ BAD
description: API文書を手伝う
ユーザーもClaudeも例から学ぶ。実際のコード例を含める。
## AI Assistant Instructions
When this skill is activated:
1. まずコードベースを分析
2. 必要なら質問
3. 初期バージョンを生成
Always:
- TypeScriptで型安全に
- エラーハンドリングを含める
Never:
- 検証をスキップしない
my-skill-name/
├── SKILL.md # コア（< 500行）
├── reference.md # 詳細（必要時のみ読込）
└── examples.md # 拡張例（必要時のみ読込）
---
name: component-generator
description: React/Vue/Angularコンポーネントを生成。新規コンポーネント作成時に使用。
---
# Component Generator
## Instructions
1. コンポーネント種別を確認（React/Vue/Angular）
2. 名前とpropsを取得
3. 生成: コンポーネント + テスト + Storybook
4. プロジェクト規約に従う
| 原因 | 解決 |
|---|---|
| トリガーキーワード不足 | descriptionに具体的キーワード追加 |
| name形式が不正 | 小文字/数字/ハイフンのみに修正 |
| YAML不正 | --- デリミタ確認、タブ→スペース |
| ファイル名が違う | SKILL.md に統一（大文字小文字注意） |
| 原因 | 解決 |
|---|---|
| descriptionが広すぎる | より具体的なキーワードに変更 |
| 他スキルとキーワード重複 | ユニークなキーワードを使用 |
| 原因 | 解決 |
|---|---|
| 指示が曖昧 | 番号付きステップで明示化 |
| AI Instructions欠如 | セクション追加 |
# プロジェクトスキル
git add .claude/skills/skill-name/
git commit -m "feat: add [skill-name] skill"
git push
# チームメンバーは git pull で取得
.claude/skills/skill-name/SKILL.md（大文字小文字注意）--- で囲むname: 小文字/ハイフン、64文字以内description: 何 + いつ、トリガーキーワード含むこのスキルが有効化された時:
Always:
Never:
