skill-editor

Skills Editor Skill

説明

このスキルを使うと、エージェントの機能を拡張するモジュール型の機能である「Agent Skills」を作成、保守できます。すべてのスキルが、deepagents 環境で必要とされる標準のディレクトリ構造とファイル形式に従うようにします。

使用する場面

• ユーザーが「スキルを作成して」や「機能を追加して」と依頼したとき。
• ユーザーが特定のワークフロー（例：「エージェントに PDF 請求書の処理方法を教える」）をパッケージ化したいとき。
• 既存のスキルを変更して、新しいリソースを追加したり、指示を更新したりするとき。

スキルの構造に関するルール

各スキルは専用のディレクトリに配置し、SKILL.md ファイルを含める必要があります。

1. ディレクトリ構造

スキル用の新しいディレクトリ（例：pdf-processing/）を作成します。 その中に SKILL.md が必須です。複雑なタスクでは、コンテキストウィンドウを軽く保つため、その他のファイルも用意することを推奨します（段階的開示）。

skill-name/
├── SKILL.md          # (Required) Main instructions and metadata
├── REFERENCE.md      # (Optional) Detailed API docs or reference material
├── FORMS.md          # (Optional) Specialized guides
└── scripts/          # (Optional) Executable scripts
    └── utility.py

2. SKILL.md の形式

SKILL.md ファイルは、YAML フロントマターで始まり、その後に Markdown 形式の指示を記述する必要があります。

フロントマターの要件：

• name：最大 64 文字。小文字、数字、ハイフンのみ使用できます。予約語（"anthropic"、"claude"）は使用できません。
• description：最大 1024 文字。スキルの内容と、使用する場面を説明する必要があります。

コンテンツのセクション：

• # [Skill Name]
• ## Instructions：手順を段階的に説明します。
• ## Examples：具体的な使用例を示します。

指示 - スキルの作成方法

以下の手順の進捗を記録するため、todowrite ツールと todoread ツールを必ず使用してください。

Step 1: 類似するオンラインスキルを確認する

スキルを作成または編集する前に、必ず簡単なウェブ検索（webfetch ツールを使用）を行い、オンラインに類似する既存のスキルがないか確認してください（例：https://github.com/anthropics/skills/tree/main/skills にある Anthropic 公式スキルや、コミュニティが管理するリスト）。類似するスキルが見つかった場合：

• ライセンスと利用条件で再利用が認められている場合は、テンプレートとしての利用を優先し、新しいスキルの SKILL.md に明確な参照リンク（"Based on: "）を記載してください。
• ライセンスで帰属表示が必要、または条件が定められている場合は、元の LICENSE.txt（またはその参照先）を新しいスキルのディレクトリに含め、ライセンス条件に従ってください。ライセンスが意図する用途と両立しない場合は、取り込む前にユーザーに知らせ、指示を求めてください。

Step 2: 既存スキルを確認する

オンラインスキルをテンプレートとして使用せずに新しいスキルを作成する前に、既存または類似するローカルスキルを検索し、その構造、例、パターンを再利用して出発点にしてください。

Step 3: ディレクトリを作成する

.opencode/skills/ の下に、スキルの目的に合ったケバブケース名のディレクトリを作成します。

Step 4: SKILL.md を作成する

必須のフロントマターとセクションを含む SKILL.md ファイルを作成します。

テンプレート：

---
name: my-new-skill
description: Brief description of what this skill does and when to use it.
---

# My New Skill

## Instructions
[Clear, step-by-step guidance for the agent to follow]

## Examples
[Concrete examples of using this skill]

Step 5: 補助ファイルを追加する（任意）

大きな参照テキストやスクリプトが必要な場合は、別ファイル（例：scripts/main.py、docs/api.md）を作成し、SKILL.md から参照してください。エージェントは必要な場合にのみ、これらのファイルを読み込みます。

Step 6: 依存関係を更新する（任意）

必要な依存関係があれば、uv pip install <package> を使用してプロジェクトの requirements.txt ファイルに追加し、プロジェクトの仮想環境を更新します。

Step 7: 必要な環境変数を明記する（任意）

スキルのスクリプトで環境変数（API キー、トークン、認証情報）が必要な場合は、想定される変数名（例：GITHUB_ACCESS_TOKEN、YOUTUBE_API_KEY）とともに、SKILL.md の Credentials セクションに明記してください。新しいスキルを作成するときは、必要な環境変数をユーザーに伝え、スクリプトの実行前にプロジェクトの .env ファイルまたはシステム環境に追加するよう案内してください。

ベストプラクティス

• 段階的な情報提示：すべてを SKILL.md に詰め込まないでください。ほかのファイルへのリンクを含むエントリーポイントとして使用してください。
• 決定論的なコード：複雑なロジックやデータ処理には、自然言語の指示よりも Python スクリプトを優先してください。
• 簡潔なスクリプト：スクリプトファイルを作成する際は、目的を明確にし、関数を小さく保ち、外部依存を最小限にして、不要な複雑さを避けてください。
• 明確なトリガー：ルーターが適切に選択できるよう、description にはスキルをいつ使用すべきかを明確に記載してください。
• 変更の確認：手順を実行する前に、変更内容をユーザーに確認してください。