スキル

スキルは、エージェントが必要なときに適用できる再利用可能な指示パックです。各エージェントのシステムプロンプトに同じ指示を重ねて書くのではなく、ブランドスタイルガイド、コードレビューのチェックリスト、特定のワークフロー向けのランブックなど、複数のエージェントで繰り返し使う手順にはスキルを使用してください。

スキルは、短い frontmatter ヘッダーを含む Markdown ファイルです。

---
name: revenue-report
description: Generates the weekly revenue report using our standard segments
always-apply: false
user-invocable: true
---

When asked to generate a revenue report:
1. Filter to the requested period.
2. Apply the standard MRR formula:
     SUM(CASE
       WHEN billing_cycle = 'monthly' THEN amount
       WHEN billing_cycle = 'yearly'  THEN amount / 12
       ELSE 0
     END)
3. Break down by segment: Enterprise, Mid-Market, SMB.
4. Render the result as a Markdown table.

特に重要な frontmatter の項目:

• name - kebab-case の識別子。
• description - このスキルが関連しているかどうかをモデルが判断するための短い要約です。これは最も重要なフィールドとして扱ってください。具体的に書いてください。説明が曖昧だと、誤ったスキルが呼び出される原因になります。
• always-apply - true の場合、スキルは選択されるのではなく、すべてのターンに自動的に含まれます。多用は避けてください。always-apply スキルは、すべてのメッセージでコンテキストを消費します。
• user-invocable - true の場合 (既定値) 、このスキルは手動で選択するための $ ポップオーバーに表示されます。

SKILL.md と関連アセットを含む .zip をアップロードすれば、補助ファイル (リファレンス資料、クエリ例、小さなスクリプトなど) をスキルと一緒にまとめることができます。

会話の中でエージェントがスキルを利用する方法は 3 つあります。

• ユーザーによる呼び出し - コンポーザーで $ を押し、ポップオーバーからスキルを選択します。スキルの内容は次のターンに向けて事前に読み込まれます。
• モデルの自動選択 - スキルの description に基づいて、エージェントが適用するタイミングを自動的に判断します。
• 常時適用 - そのように設定されたスキルは、毎ターン事前に読み込まれます。

Cloudコンソールのスキルパネルでは、その場でスキルを作成したり、.md または .zip ファイルをアップロードしたり、ユーザーに対してどのスキルを有効にするかを管理したりできます。自分が所有するスキルはデフォルトで有効になっています。無効化すると、削除しなくてもポップオーバーとモデルのカタログから外れます。

スキルは他のユーザーと共有できます (共有とアクセス を参照) 。

• エージェントの指示は、そのエージェントの役割や全体的な振る舞いを定義するものです。そのエージェントでは常に有効です。
• スキルは状況に応じて適用されるもので、必要な場合にのみ使われ、特定のワークフローに限定されます。

複数のエージェントで同じ手順が繰り返し登場する場合や、毎回ではなく特定のユーザーリクエストに対してのみそれをトリガーしたい場合は、スキルを使ってください。