> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# スキル

> ClickHouse Agents向けの再利用可能な指示パック

[ベータ機能](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#beta-features)

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

## スキルの構造

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

```markdown theme={null}
---
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` ファイルをアップロードしたり、ユーザーに対してどのスキルを有効にするかを管理したりできます。自分が所有するスキルはデフォルトで有効になっています。無効化すると、削除しなくてもポップオーバーとモデルのカタログから外れます。

スキルは他のユーザーと共有できます ([共有とアクセス](https://clickhouse.com/docs/ja/agents/sharing-and-access.md) を参照) 。

## スキルと指示の違い

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

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