skill-creator

スキル作成ツール

確立された規約に従って、本番環境で使える Claude Code スキルを生成します。

基本的なワークフロー

1. スキルの目的を定義する：明確な名前、説明、ユースケースを決めます
2. カテゴリを決定する：適切なフォルダー（foundation、frontend、backend など）に配置します
3. SKILL.md を作成する：フロントマターとコンテンツを含むメインのスキルファイルを作成します
4. 参考資料を追加する：必要に応じて templates.md、conventions.md、patterns.md を追加します
5. サンプルを含める：本番環境で使えるコードサンプルを用意します
6. チェックリストを作成する：出力の検証用チェックリストを作成します

スキルのカテゴリ

カテゴリ	パス	目的
基盤	foundation/	プロジェクト設定、開発環境、git、ドキュメント
フロントエンド	frontend/	React、Vue、UI コンポーネント、スタイリング、UX
バックエンド	backend/	API、認証、サーバーロジック、サービス
AI エンジニアリング	ai-engineering/	LLM、RAG、エージェント、プロンプト
アーキテクチャ	architecture/	システム設計、ADR、技術的な意思決定
CI/CD	ci-cd/	自動化、デプロイ、パイプライン
データベース	database-management/	マイグレーション、クエリ、データエンジニアリング
テスト	testing/	単体テスト、結合テスト、E2E、モック
セキュリティ	security/	脆弱性、認証、セキュリティ強化
パフォーマンス	performance/	可観測性、モニタリング、最適化

SKILL.md テンプレート

---
name: skill-name-in-kebab-case
description: One-line description of what the skill does and when to use it. Include trigger phrases like "use when users request X, Y, or Z".
---

# Skill Title

Brief tagline explaining the skill's value proposition.

## Core Workflow

1. **Step one**: Description
2. **Step two**: Description
3. **Step three**: Description
   ...

## [Main Content Sections]

### Section with Code Examples

\`\`\`typescript
// Production-ready code example
\`\`\`

### Patterns / Templates

Document reusable patterns with examples.

## Best Practices

- Practice one
- Practice two
- Practice three

## Output Checklist

Every output should include:

- [ ] Item one
- [ ] Item two
- [ ] Item three

参考ファイルの構成

スキルに補足ドキュメントが必要な場合：

skill-name/
├── SKILL.md              # Main skill file (required)
└── references/            # Optional reference materials
    ├── templates.md       # Code/file templates
    ├── conventions.md     # Standards and conventions
    └── patterns.md        # Reusable patterns

フロントマターの要件

---
name: kebab-case-skill-name # Must match folder name
description: >
  Clear description including:
  - What the skill does
  - When to use it
  - Trigger phrases ("use when X", "create Y", "generate Z")
---

コンテンツのガイドライン

コードサンプル

• 擬似コードではなく、本番環境で使えるものにします
• 該当する場合は TypeScript の型を含めます
• 完全に動作するサンプルを示します
• 最新の構文とベストプラクティスを使用します

含めるセクション

1. 基本的なワークフロー：スキルの使い方を番号付きの手順で示します
2. メインコンテンツ：パターン、テンプレート、サンプル
3. ベストプラクティス：業界で実績のある推奨事項
4. 出力チェックリスト：検証項目

文体

• 能動態と命令形を使用します
• 簡潔で流し読みしやすい形式にします
• 構造化された比較には表を使用します
• 技術的な内容はすべてコードブロックに記載します

スキルの品質基準

完全性

• 明確に定義された特定の問題を解決する
• 動作するコードサンプルを含む
• 説明に明確なトリガーフレーズがある
• 出力検証用チェックリストを用意する

一貫性

• 命名規則（kebab-case）に従う
• 標準的なセクション見出しを使用する
• 既存のスキル形式に合わせる
• 適切なカテゴリフォルダーに配置する

有用性

• サンプルをコピーしてすぐに使える
• 一般的なユースケースに対応する
• エッジケースを想定する
• 役立つ場合は外部ドキュメントを参照する

例：新しいスキルの作成

ステップ 1：スキルを定義する

Name: api-rate-limiter
Category: backend
Purpose: Implement rate limiting for APIs
Triggers: "add rate limiting", "protect API", "throttle requests"

ステップ 2：フォルダー構成を作成する

mkdir -p backend/api-rate-limiter
touch "backend/api-rate-limiter/SKILL.md"

ステップ 3：SKILL.md を作成する

---
name: api-rate-limiter
description: Implements rate limiting for APIs using token bucket, sliding window, or fixed window algorithms. Use when users request "add rate limiting", "protect API from abuse", or "throttle requests".
---

# API Rate Limiter

Protect your APIs from abuse with production-ready rate limiting.

## Core Workflow

...

ステップ 4：参考資料を追加する（必要な場合）

mkdir -p backend/api-rate-limiter/references
touch backend/api-rate-limiter/references/algorithms.md

出力チェックリスト

新しいスキルを作成する際は、以下を確認します。

• スキル名が kebab-case である
• 説明にトリガーフレーズが含まれている
• 適切なカテゴリフォルダーに配置されている
• SKILL.md がテンプレートの構成に従っている
• コードサンプルが本番環境で使える
• 基本的なワークフローのセクションがある
• 出力チェックリストのセクションがある
• 必要に応じて参考ファイルが追加されている