skill-creator

スキル作成ツール

目的

高品質で効果的なスキルの作成をガイドするメタスキルです。Claude の機能を専門知識、ワークフロー、ツール連携によって強化するスキルを構築するためのテンプレート、ベストプラクティス、構造に関するガイドラインを提供します。

使用するタイミング

• ユーザーが新しいスキルの作成を希望している
• ユーザーが既存のスキルの更新や改善を希望している
• ユーザーがスキルのドキュメント構成について質問している
• 特定の分野やワークフロー向けのスキルを設計する必要がある
• スキルがベストプラクティスに従っていることを確認したい

スキルの基本構造

必須コンポーネント

すべてのスキルには、次の要素が必要です。

1. フロントマター

   ---
   name: skill-name
   description: One-line description when to use this skill
   ---
   

2. タイトルと目的

   # Skill Name
   
   ## Purpose
   Clear, concise statement of what this skill does
   

3. 使用するタイミング

   ## When to Use
   - Specific trigger 1
   - Specific trigger 2
   - Context where this helps
   

4. 主要な機能

   ## Core Capabilities
   
   ### Domain Expertise
   - Key knowledge area 1
   - Key knowledge area 2
   
   ### Tools & Methods
   - Specific techniques
   - Frameworks used
   

任意ですが、推奨されるコンポーネント

5. ワークフロー

   ## Workflow
   
   1. Step 1: What to do first
   2. Step 2: Next action
   3. Step 3: Final deliverable
   

6. ベストプラクティス

   ## Best Practices
   
   - Do this
   - Avoid that
   - Remember this
   

7. 例

   ## Examples
   
   ### Example 1: Common Use Case
   **Input**: User request
   **Approach**: How to handle
   **Output**: Expected result
   

8. アンチパターン

   ## Anti-Patterns
   
   ❌ **Don't**: Bad practice
   ✅ **Do**: Good alternative
   

スキル作成のワークフロー

ステップ 1：範囲を定義する

次の質問を自分に問いかけてください。

• このスキルはどのような問題を解決しますか？
• 誰が使いますか？
• どのようなきっかけで使用しますか？
• 期待される成果は何ですか？

ステップ 2：主要な知識を特定する

次の内容を記述します。

• 分野固有の用語
• 重要な概念と原則
• この分野でよく見られるパターン
• 関連するツールとテクノロジー

ステップ 3：ワークフローを構成する

次の項目を整理します。

• 開始条件
• ステップごとのプロセス
• 判断ポイント
• 終了条件と成果物

ステップ 4：実践的な要素を追加する

次の内容を含めます。

• 実例
• 避けるべきよくある落とし穴
• 現場でのベストプラクティス
• 品質基準

ステップ 5：明確なトリガーを書く

「使用するタイミング」を具体的にします。

• ✅ 「ユーザーが PostgreSQL データベース向けの SQL クエリ最適化を必要としている」

• ❌ 「ユーザーがデータベースの支援を必要としている」

• ✅ 「分散システムで本番環境の障害をデバッグしている」

• ❌ 「バグを修正している」

スキルの品質基準

明確さ

• 名前から内容がわかる
• 説明に使用するタイミングが明記されている
• 目的が 1～2 文で述べられている
• 説明のない専門用語がない

完全性

• 必須セクションがすべて含まれている
• ワークフローが実行可能である
• 例がよくあるケースを網羅している
• エッジケースに対応している

具体性

• トリガーが具体的である
• 手順に従えるだけの詳細がある
• ツールや手法が明示されている
• 成功基準が定義されている

使いやすさ

• 流し読みや移動が簡単である
• 書式が一貫している
• セクションの順序が論理的である
• 役立つ箇所に相互参照がある

スキルのテンプレート

技術分野向けスキルのテンプレート

---
name: domain-expert
description: Use when user needs [specific technical task] in [technology/domain]
---

# Domain Expert

## Purpose

Expert in [domain] specializing in [specific areas]. Helps with [key problems solved].

## When to Use

- User needs [specific task 1]
- Working with [technology] and needs [help type]
- Troubleshooting [specific problem type]
- Designing [architectural element]

## Core Capabilities

### [Domain] Expertise
- [Technology 1] - [version/specifics]
- [Technology 2] - [what aspects]
- [Pattern/practice] - [when/how]

### Key Techniques
- **[Technique 1]**: [What it solves]
- **[Technique 2]**: [When to use]
- **[Technique 3]**: [How it helps]

## Workflow

1. **Understand Requirements**
   - Clarify [specific aspects]
   - Identify [constraints]

2. **Apply [Domain] Patterns**
   - Use [pattern 1] for [scenario]
   - Consider [trade-off]

3. **Implement Solution**
   - Follow [best practice]
   - Ensure [quality criteria]

4. **Validate**
   - Test [aspects]
   - Verify [requirements met]

## Best Practices

- **[Practice 1]**: [Reasoning]
- **[Practice 2]**: [Benefit]
- **[Practice 3]**: [Why important]

## Common Patterns

### [Pattern 1]
**When**: [Scenario]
**How**: [Implementation approach]
**Why**: [Benefits]

### [Pattern 2]
**When**: [Scenario]
**How**: [Implementation approach]
**Why**: [Benefits]

## Anti-Patterns

❌ **Don't**: [Bad practice]
   - Why it fails: [Reason]
   - Better approach: [Alternative]

❌ **Avoid**: [Common mistake]
   - Problem: [What goes wrong]
   - Instead: [Correct way]

## Examples

### Example 1: [Common Scenario]
**Context**: [Situation]
**Approach**: [Solution steps]
**Result**: [Outcome]

## Tools & Technologies

- **[Tool 1]**: [Version] - [Use for what]
- **[Tool 2]**: [Version] - [Use for what]
- **[Framework]**: [Version] - [Key features used]

プロセス／ワークフロー向けスキルのテンプレート

---
name: process-specialist
description: Use when user needs [specific process/workflow] for [outcome]
---

# Process Specialist

## Purpose

Guides [specific process] to achieve [specific outcome]. Ensures [quality aspects] through [methodology].

## When to Use

- Need to [execute process]
- Want to ensure [quality outcome]
- Working on [scenario requiring this process]

## Core Process

### Phase 1: [Name]
**Goal**: [What to achieve]

Steps:
1. [Action 1]: [Details]
2. [Action 2]: [Details]
3. [Action 3]: [Details]

**Outputs**: [What you have after this phase]

### Phase 2: [Name]
**Goal**: [What to achieve]

Steps:
1. [Action 1]: [Details]
2. [Action 2]: [Details]

**Outputs**: [What you have after this phase]

### Phase 3: [Name]
**Goal**: [What to achieve]

Steps:
1. [Action 1]: [Details]
2. [Action 2]: [Details]

**Deliverable**: [Final output]

## Decision Points

### When to [Decision]
- If [condition], then [choice A]
- If [condition], then [choice B]

## Quality Gates

After each phase, verify:
- [ ] [Criterion 1]
- [ ] [Criterion 2]
- [ ] [Criterion 3]

## Best Practices

- **[Practice]**: [Why it matters]
- **[Practice]**: [Impact on quality]

## Common Pitfalls

- **Pitfall**: [What people do wrong]
  - **Impact**: [What happens]
  - **Solution**: [How to avoid]

執筆のヒント

具体的にする

❌ 「データベースを扱うときに使用する」 ✅ 「本番環境の PostgreSQL 14 以降のデータベース向けに SQL クエリを最適化するときに使用する」

実行可能にする

❌ 「セキュリティについて考える」 ✅ 「OWASP ZAP のスキャンを実行し、重大度が HIGH のすべての指摘を確認する」

構造化する

一貫した見出しレベルを使います。

• 主要なセクションには ## を使う
• サブセクションには ### を使う
• 詳細な項目には #### を使う

視覚的な指標を使う

• ✅ 良いプラクティス
• ❌ アンチパターン
• 🔍 調査手順
• ⚠️ 警告
• 💡 ヒント

背景を含める

何をするかを列挙するだけでなく、その理由も説明します。

## Instead of:
- Use connection pooling

## Write:
- **Use connection pooling** (pg-pool for PostgreSQL)
  - Reduces connection overhead by 80%
  - Critical for applications with >100 concurrent users
  - Configure pool size = (core count × 2) + effective_spindle_count

スキルのメンテナンス

更新するタイミング

• 中核となるテクノロジーの新しいバージョンがリリースされた
• より良いプラクティスが現場で生まれた
• ユーザーからのフィードバックで不足が明らかになった
• 関連するスキルが作成された（相互参照）

バージョン管理

フロントマターに次の項目を追加することを検討してください。

---
name: skill-name
description: One-line description
---

スキルの連携

相互参照

関連するスキルへのリンクを追加します。

## Related Skills
- Use [[debugger-skill]] when issues arise
- Combine with [[performance-engineer-skill]] for optimization
- Precede with [[architect-reviewer-skill]] for design validation

スキルの組み合わせ

複雑なワークフローでは、複数のスキルを連鎖させることができます。

## Workflow
1. Use [[requirement-analyst]] to gather needs
2. Apply this skill for implementation
3. Use [[code-reviewer]] for quality assurance
4. Use [[deployment-engineer]] to ship

例

例 1：Python Pro スキルの作成

コンテキスト：高度な Python 開発向けのスキルが必要です

プロセス：

1. 範囲を定義します：FastAPI と型安全性に重点を置いた Python 3.11 以降
2. トリガーを特定します：「modern Python」、「type hints」、「FastAPI」
3. 中核となる機能を整理します：
   • Python 3.11 以降の機能（match 文、型ヒントの改善）
   • FastAPI フレームワークのパターン
   • 型注釈のベストプラクティス
4. ワークフローを追加します：API の設計 → 型モデルの定義 → ルートの実装 → テスト
5. 例を含めます：型注釈をすべて記述した FastAPI のルート

結果：最新の Python 開発に特化した、実用的なスキルです

例 2：Git ワークフロースキルの作成

コンテキスト：チームの Git ブランチ戦略を明文化する必要があります

プロセス：

1. 範囲を定義します：機能開発のための Git ワークフロー
2. トリガーを特定します：「create branch」、「make PR」、「git workflow」
3. フェーズごとに整理します：
   • ブランチの作成
   • 開発サイクル
   • PR のプロセス
   • マージ戦略
4. 判断ポイントを追加します：リベースとマージを使い分けるタイミング
5. 例を含めます：標準的な機能開発の流れ

結果：一貫した Git の使用を実現する、明確な手順ガイドです

検証チェックリスト

スキルを仕上げる前に、次の項目を確認してください：

構成

• フロントマターが完成している（name、description）
• タイトルと目的が明確である
• 「使用するタイミング」セクションに具体的なトリガーがある
• 中核となる機能が明確に定義されている

内容

• 情報が正確で最新である
• 例が現実的で役に立つ
• ベストプラクティスに根拠がある
• アンチパターンに代替案が示されている

使いやすさ

• 必要な情報をすばやく見つけられる
• セクションが論理的につながっている
• 書式が一貫している
• 相互参照が正しい

品質

• 誤字や文法の誤りがない
• 技術用語が定義されている
• コード例（ある場合）が正しい
• 上記のすべての品質基準を満たしている

メタ：このスキルについて

このスキル自体が、教えている原則を実践しています：

• 明確なフロントマターと構成
• 具体的な「使用するタイミング」のトリガー
• 実践的なワークフロー
• 具体例
• 品質基準

スキルを作成するときは、ガイドとしてもテンプレートとしても活用してください。