> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/ja/build/skills.md).
# スキル
スキル（Skill）とは何か、その構成要素、Agent がスキルを展開して複数のステップを実行する仕組み、ツールとの違いと適した用途を説明します。作成・管理方法はスキル管理をご覧ください。
スキル：複数ステップの SOP を定義し、Agent が手順に沿って会話を進めます
## これは何ですか？
スキルは、Agent が複数のステップで処理を進めるためのワークフローです。自然言語で SOP を定義すると、Agent は会話中に関連する状況に遭遇した際、その手順を展開して順番に処理します。
ツールが Agent の「単一の能力」（ドライバーのようなもの）だとすれば、スキルは「複数の能力を組み合わせた一連の処理手順」（組み立てマニュアルのようなもの）です。使うツールだけでなく、いつ、どのように使い、使用後にどう回答するかまで Agent に伝えます。
## 具体例で見てみましょう
Agent に「顧客への見積もり」を担当させたいとします。
**スキルがない場合**：Agent の回答がまとまらず、重要な情報が抜けることがあります。
**スキルがある場合**：次のような見積もり SOP を定義します。
```
1. まず顧客が必要とする製品の型番を確認します
2. 製品の価格表を検索します（ツールを使用）
3. 顧客の希望数量を確認します
4. 数量に応じた割引ルールを適用します
5. 見積もりの概要を作成します
6. 調整が必要か顧客に確認します
```
Agent はこの手順に沿って会話を進め、各ステップの抜け漏れを防ぎます。
## スキルには何を含められますか？
スキルは次の3つの要素で構成されます。手動で作成したスキルでも、アップロードして作成したスキルでも、すべて設定できます。
| 構成要素 | 説明 |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **指示内容** | 処理手順全体と回答形式を自然言語で記述した Markdown 形式の SOP です。Agent に接続済みのナレッジベースを検索するよう指示することもできます |
| **追加ツール** | スキルの実行中に呼び出すツール（API ツール、MCP ツール）です。スキルとともに Agent に提供されます |
| **リソースファイル** | スキルに付属する参考資料、テンプレート、スクリプトです。Agent で [Code Interpreter](/maiagent-user-guide/ja/build/agent/code-interpreter.md) が有効になっている場合、スキルを展開するとこれらのファイルがコード実行環境に配置され、Agent が読み取りや処理を行えます。有効でない場合、Agent は指示内容のみを使用します |
{% hint style="info" %}
スキルの定義はプレーンテキストのプロンプトであり、フローチャートやコードではありません。自然言語で手順全体を記述すると、Agent が理解して実行します。
{% endhint %}
## スキルの動作の仕組み
1. **スキルを作成します**：名前と説明を入力し、指示内容を記述して、必要に応じてツールとリソースファイルを追加します。Agent は説明をもとに使用時機を判断するため、用途とトリガー条件を明確に記述してください。
2. **Agent に紐付けます**：Agent の設定で使用するスキルを選択します。1つの Agent に複数のスキルを紐付けられます。スキルは、回答モード が Agent モード の Agent でのみ有効です。
3. **ユーザーが質問します**：たとえば「休暇の残り日数を調べてください」と質問します。
4. **スキルを判断して展開します**：通常、Agent に見えるのは各スキルの名前と説明だけです。そのスキルで質問を処理すべきだと判断した時点で、指示全体を読み込みます。そのため、多くのスキルを紐付けても、毎回の会話が不要な指示で埋まることはありません。
5. **実行して回答します**：Agent は指示の手順に従って追加ツールを呼び出し（データベース検索、API 呼び出しなど）、指定された形式にまとめて回答します。
動作原理、`SKILL.md` の仕様、API については、技術マニュアルの [Skill スキルモジュール](https://docs.maiagent.ai/tech/advanced-genai-tech/skill) をご覧ください。
## スキルの主なメリット
* **複雑なタスクを標準化できます**：毎回同じ SOP に従って実行することで、回答品質を一定に保てます。
* **適切なタイミングで起動し、役割を分担できます**：スキルごとに異なるタスクを担当し、Agent が説明をもとに使うスキルを判断します。
* **再利用・共有できます**：1つのスキルを複数の Agent に紐付けたり、`.skill` ファイルとしてエクスポートして他の組織と共有したりできます。
* **指示とツールをまとめられます**：「何をするか」と「何を使うか」を一緒にまとめるため、システムプロンプトに大量の手順を繰り返し記述する必要がありません。
## スキルとツールの違い
| 比較項目 | ツール | スキル |
| ---------- | -------------------- | ----------------------------- |
| **本質** | 単一の外部機能（API、MCP）です | 一連の実行手順です |
| **含まれるもの** | API エンドポイント／MCP サーバー | 指示＋ツール＋リソースファイル |
| **たとえ** | ドライバー | 組み立てマニュアル＋ドライバー |
| **起動方法** | Agent が呼び出しの要否を判断します | Agent がスキルの説明に基づいて展開の要否を判断します |
| **適した用途** | 単一の操作（天気の確認、メール送信） | 複数ステップの処理（返品処理、休暇計算） |
スキルとツールは互いに補完し合います。スキルは追加ツールによって実際の処理能力を得て、スキルの指示は Agent にツールをいつ、どの順番で使うかを伝えます。
## どのような場合にスキルが適していますか？
* **決まった SOP がある処理**：見積もり、苦情対応、問題診断
* **複数回のやり取りで情報を集める場合**：予約手続き（日付、時間、人数の確認）
* **条件に応じた判断が必要な場合**：状況によって異なる処理へ分岐する場合
* **手順の抜け漏れを防ぐ必要がある場合**：フォーム入力の案内、承認手続き
## どのような場合はスキルが不要ですか？
* 簡単な一問一答（ナレッジベースで十分です）
* 1つの情報を調べたり、1つの操作を実行したりするだけの場合（ツールで十分です）
## 活用例
| 場面 | スキル | トリガー | 手順 | 追加ツール |
| ------------ | --------- | ---------------------------- | ----------------------------------- | ------------------------ |
| 企業のカスタマーサポート | 返品処理フロー | 顧客が返品・交換を希望したとき | 注文検索 → 返品条件の確認 → 返品依頼の作成 → 処理結果の回答 | 注文検索 API、返品システム API |
| 官公庁 | 休暇日数の計算 | 休暇日数や年次有給休暇の日数を尋ねられたとき | 職員区分の確認 → 関連法規の事例検索 → 照合・計算 → 結果の出力 | ナレッジベース検索 |
| EC プラットフォーム | 顧客情報の収集 | 顧客が購入の意向を示したり、見積もりを依頼したりしたとき | 氏名、会社、連絡先の入力を案内 → CRM に登録 | Google Sheet API、CRM ツール |
| マーケティングチーム | メール送信サービス | メール送信や顧客への連絡を依頼されたとき | 宛先の確認 → メール本文の作成 → 送信 | Gmail MCP ツール |
## 何をすればよいですか？
1. **スキルを作成します**：手動で記述するか、`.skill`／`.zip` のスキルパッケージをアップロードします。[スキル管理：スキルの作成](/maiagent-user-guide/ja/build/skills/skills-management.md#create-skill) をご覧ください
2. **手順を記述します**：指示内容に処理手順全体を自然言語で記述します
3. **ツールとファイルを追加します**：必要に応じて 追加ツール、ファイル タブで追加します。[スキルの編集と設定](/maiagent-user-guide/ja/build/skills/skills-management.md#edit-and-configure-skill) をご覧ください
4. **Agent に紐付けます**：Agent の設定でこのスキルを有効にします。[スキルを Agent に紐付ける](/maiagent-user-guide/ja/build/skills/skills-management.md#bind-skill-to-ai-agent) をご覧ください
5. **テストします**：ユーザーとの会話をシミュレーションし、処理がスムーズに進むか確認します
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.maiagent.ai/maiagent-user-guide/ja/build/skills.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
