スキルの作成

プロセス

1. 要件の収集 - ユーザーに以下について質問します:

   • そのスキルはどのようなタスク/ドメインをカバーしていますか?
   • 対応すべき具体的なユースケースは何ですか?
   • 実行可能なスクリプトが必要ですか、それとも単なる手順で十分ですか?
   • 参考資料を含める必要がありますか?

2. スキルのドラフト作成 - 以下を作成します:

   • 簡潔な説明を含む SKILL.md
   • コンテンツが 500 行を超える場合は追加の参考ファイル
   • 決定論的な操作が必要な場合はユーティリティスクリプト

3. ユーザーとのレビュー - ドラフトを提示し、以下を質問します:

   • このスキルはあなたのユースケースをカバーしていますか?
   • 不足しているか、不明瞭な部分がありますか?
   • セクションの詳細度を増やすか減らすべきですか?

スキルの構成

skill-name/
├── SKILL.md           # メイン手順書（必須）
├── REFERENCE.md       # 詳細なドキュメント（必要に応じて）
├── EXAMPLES.md        # 使用例（必要に応じて）
└── scripts/           # ユーティリティスクリプト（必要に応じて）
    └── helper.js

SKILL.md テンプレート

---
name: skill-name
description: Brief description of capability. Use when [specific triggers].
---

# Skill Name

## Quick start

[Minimal working example]

## Workflows

[Step-by-step processes with checklists for complex tasks]

## Advanced features

[Link to separate files: See [REFERENCE.md](REFERENCE.md)]

説明文の要件

説明文は、エージェントがスキルを読み込むかどうかを判断するときに見る唯一のもの です。これはシステムプロンプトに他のインストール済みスキルとともに表示されます。エージェントはこれらの説明文を読んで、ユーザーのリクエストに基づいて関連するスキルを選択します。

目標: エージェントが以下を知るのに必要な情報だけを提供します:

1. このスキルが提供する機能は何か
2. いつ/なぜそれをトリガーするか（特定のキーワード、コンテキスト、ファイル型）

フォーマット:

• 最大 1024 文字
• 三人称で記述
• 最初の文: それが何をするか
• 次の文: 「Use when [specific triggers]」

良い例:

Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when user mentions PDFs, forms, or document extraction.

悪い例:

Helps with documents.

悪い例はエージェントに他のドキュメントスキルと区別する方法を与えません。

スクリプトを追加すべき場合

以下の場合にユーティリティスクリプトを追加してください:

• 操作が決定論的である（検証、フォーマット）
• 同じコードが繰り返し生成される可能性がある
• エラーが明示的な処理を必要とする

スクリプトは生成コードと比較してトークンを節約し、信頼性を向上させます。

ファイルを分割すべき場合

以下の場合に別ファイルに分割してください:

• SKILL.md が 100 行を超える
• コンテンツに異なるドメイン（金融 vs 営業スキーマ）がある
• 高度な機能がほとんど必要とされない

レビューチェックリスト

ドラフト作成後、以下を確認してください:

• 説明文にトリガーが含まれている（「Use when...」）
• SKILL.md が 100 行以下
• 時間に依存した情報がない
• 用語に一貫性がある
• 具体的な例が含まれている
• 参照が 1 レベルの深さ