スキルでエージェント モードを拡張する

スキルを使用すると、専門知識とカスタム ワークフローでエージェント モードの機能を強化できます。スキルは、エージェント スキル オープン標準に基づいています。

AGENTS.md ファイルとは異なり、スキルはオンデマンドのエキスパティーズを表します。この構造により、エージェント モードは、特定のライブラリ バージョン間の移行や、さまざまな画面サイズに対応するコンポーザブルの作成など、多数の専門的な機能をモデルの直接的なコンテキスト ウィンドウを煩雑にすることなく維持できます。

モデルは、リクエストとスキルの説明に基づいて、スキルを使用するタイミングを自律的に決定します。関連するスキルが特定されると、モデルはタスクの完了に必要なすべての手順とリソースを動的にプルします。

スキルをオンデマンドで有効にするには、エージェントにスキルに関連するタスクを実行するように依頼します。入力ボックスに「@」と入力して、特定のスキルをトリガーすることもできます。

主な特典

  • 専門知識の共有: 複雑なワークフロー（特定のチームのプルリクエスト レビュー プロセスなど）を、誰でも使用できる専用フォルダにパッケージ化します。
  • 再現可能なワークフロー: 標準的な手順を提供することで、複数ステップから成る複雑なタスクを確実に一貫して実行できます。
  • リソースのバンドル: スクリプト、テンプレート、サンプルデータを手順とともに含めることで、エージェントは必要なものをすべて 1 か所で入手できます。
  • コンテキスト ウィンドウの効率的な使用: コンテキスト トークンを節約するため、最初はスキルのメタデータ（名前と説明）のみが読み込まれます。SKILL.md ファイル全体は、有効化されたときにのみ読み込まれます。references/、scripts/、assets/ ディレクトリ内のサポート ファイルは、エージェントが明示的に必要とする場合にのみコンテキストに読み込まれます。

独自のスキルを作成する

エージェントは、プロジェクト ルートにある .skills/ ディレクトリまたは .agent/skills/ ディレクトリからスキルを探します。カスタムスキルを作成する手順は次のとおりです。

  1. スキルのディレクトリを作成 します（例: my-new-skill/）。
  2. 新しいディレクトリ内に SKILL.md ファイルを 作成します（大文字と小文字が区別されます）。

スキルは次のルールに従う必要があります。

  • スキルごとに 1 つのディレクトリ: 各スキルには、独自のディレクトリ が必要です。これには、SKILL.md ファイルと追加のリソースが含まれます。
  • ネスト: すべてのスキルは、プロジェクト ルートの .skills/ ディレクトリまたは .agent/skills/ ディレクトリに配置する必要があります。ただし、サブディレクトリを使用して整理することもできます（例: skills/ui-flows/<skill name>/SKILL.md または skills/testing/<skill name>/SKILL.md)。
  • スコープ: 現在、プロジェクトのコードベース内にあるスキルのみがサポートされています。

SKILL.md ファイルでは、メタデータに YAML ブロックを使用し、手順に標準の Markdown を使用します。

  • name: スキルの固有識別子。ディレクトリ名と一致する必要があります。
  • description: スキルの機能と、エージェントがスキルを使用するタイミングを明確に説明します。
  • 本文: YAML ブロックの下の Markdown 本文には、スキルが有効なときにエージェントの動作をガイドする手順が含まれています。
---
name: skill-name
description: A description of what this skill does and when to use it.
metadata:
  author: example-org
  version: "1.0"
---

Skill content

形式に関するガイドライン

スキルのオプション ディレクトリ

SKILL.md ファイルを簡潔でモジュール化された状態に保つため、スキルのフォルダ内の次のオプション ディレクトリに追加のリソースを含めることができます。

  • scripts/: エージェントが実行できる実行可能コード（Python、Bash など）が含まれます。
  • references/: 詳細な技術ドキュメント、API リファレンス、ドメイン固有のガイドが含まれます。
  • assets/: ドキュメント テンプレート、UI 図、JSON スキーマなどの静的リソースが含まれます。

SKILL.md の手順内でこれらのファイルを参照する場合は、スキルのルートからの相対パスを使用します。例: Run the script at scripts/cleanup.py。