skill-creator

スキル作成ツール

スキルは、専門知識、ワークフロー、ツールを提供してClaudeの機能を拡張する、モジュール式のパッケージです。

基本原則

簡潔さが重要です

コンテキストウィンドウは共有リソースです。Claudeがすでに知っている内容は追加しないでください。それぞれの項目について、「Claudeに本当に必要か？」と考えてください。

スキルの構成

skill-name/
├── SKILL.md (required)
│   ├── YAML frontmatter (name, description)
│   └── Markdown instructions
└── Bundled Resources (optional)
    ├── scripts/      - Executable code
    ├── references/   - Documentation
    └── assets/       - Templates, images

SKILL.mdの形式

---
name: my-skill-name
description: A clear description of what this skill does and when to use it
---

# My Skill Name

[Instructions for Claude when this skill is active]

## Examples
- Example usage 1
- Example usage 2

## Guidelines
- Guideline 1
- Guideline 2

スキル作成のプロセス

ステップ1：例を使って理解する

スキルの使用方法について、具体例を集めます。次の点を尋ねてください。

• 「このスキルでどのような機能をサポートする必要がありますか？」
• 「どのようなユーザーの発言が、このスキルを起動するべきですか？」

ステップ2：再利用可能な内容を計画する

例を分析して、次の内容を特定します。

• スクリプト：繰り返し書き直すコード
• リファレンス：Claudeが参照する必要のあるドキュメント
• アセット：出力用のテンプレートや画像

ステップ3：初期化する

SKILL.mdとリソース用フォルダーを含むスキルのディレクトリー構造を作成します。

ステップ4：実装する

• 再利用可能なリソース（スクリプト、リファレンス、アセット）から始めます
• 適切なフロントマターを含む、明確なSKILL.mdを作成します
• スクリプトを実際に実行してテストします

ステップ5：改善を重ねる

実際のタスクでスキルを使い、問題点に気づいたら改善します。

段階的な情報開示

SKILL.mdは500行未満に保ちます。内容は分割してください。

# PDF Processing

## Quick start
[code example]

## Advanced features
- **Form filling**: See [FORMS.md](FORMS.md)
- **API reference**: See [REFERENCE.md](REFERENCE.md)

含めてはいけないもの

• README.md
• INSTALLATION_GUIDE.md
• CHANGELOG.md
• ユーザー向けドキュメント

スキルは人間ではなく、AIエージェント向けです。