> 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/maiagent-user-guide-ja/skills/skill-overview.md).
# スキル機能の概要
## スキルとは？
スキルは AI アシスタントにとっての**専門資格**のようなものです。スキルを一つ習得するたびに、AI アシスタントは専門能力を一つ増やします。ツールが AI アシスタントの「工具箱の中のドライバー」だとすれば、スキルは「ひとそろいの標準作業手順（SOP）」にあたります。どのツールを使うかを AI アシスタントに伝えるだけでなく、**いつ使うか、どう使うか、使った後どう返答するか**まで伝えます。
あなたがコールセンターを運営していると想像してみてください。
**スキルがない場合：**
* お客様：「返品したいのですが」
* AI カスタマーサポート：「かしこまりました。ご注文番号を教えていただけますか？」*（基本的な質問応答しかできません）*
**スキルがある場合：**
* お客様：「返品したいのですが」
* AI カスタマーサポート：「かしこまりました！」💫 *（返品処理スキルを自動的に展開）* → 注文を照会 → 返品資格を確認 → 返品伝票を作成 → 「お客様の返品申請を受け付けました。返品伝票番号は RT-20260324 で、3〜5 営業日で処理が完了する見込みです。」✅
### スキルの中核を構成する要素
各スキルは 3 つの部分で構成されています。
```
スキル = 指示内容 + 付加ツール + リソースファイル
│ │ │
▼ ▼ ▼
SOP フロー 呼び出せる 補助的に参照する
（どう行うか） 外部能力 添付ファイル
```
* **指示内容**：Markdown 形式の詳細な指示で、SOP のように AI アシスタントを一歩ずつタスク完了へと導きます
* **付加ツール**：スキルが使用するツール（MCP ツール、API ツールなど）で、AI アシスタントが実際の操作を実行できるようにします
* **リソースファイル**：スキルの実行時に参照できる添付資料（アップロード方式で作成したスキルのみ対応）
## スキルの動作フロー
完全なスキルの動作フローは次のとおりです。
1. **スキルを作成する：**
* スキルの名前と説明を定義する（説明によって AI がこのスキルをいつトリガーするかが決まります）
* 詳細な指示内容を記述する（Markdown 形式の SOP）
* 必要なツールを紐付ける
2. **AI アシスタントに紐付ける：**
* AI アシスタントの設定で使用するスキルを選択する
* 1 つの AI アシスタントに複数のスキルを紐付けられます
3. **ユーザーが質問する：**
* ユーザーが自然言語で AI アシスタントにリクエストを行う
* *例：* 「私の有給休暇の残日数を調べてください」
4. **AI アシスタントが判断してスキルを展開する：**
* AI アシスタントはユーザーの質問をもとに、紐付け済みスキルの説明と照合する
* その質問をどのスキルで処理すべきかを判断する
* 当該スキルの完全な指示内容を自動的に展開する
5. **指示を実行しツールを呼び出す：**
* AI アシスタントはスキルの指示に書かれた手順を一つずつ実行する
* 必要に応じてスキルに付加されたツールを自動的に呼び出す（データベースの照会、API の呼び出しなど）
6. **最終的な返答を生成する：**
* AI アシスタントはツールが返した結果をとりまとめる
* スキルの指示で定義された返答フォーマットに従い、構造化された回答を生成する
## スキルの主なメリット
### ⚡ 複雑なタスクの標準化
* **スキルがない場合**：AI アシスタントは汎用的な知識でしか回答できず、品質が安定しません
* **スキルがある場合**：毎回 SOP に従って実行するため、回答品質の一貫性が保たれます
### 🎯 的確なトリガーと役割分担
* 説明に含まれるトリガー条件によって、AI アシスタントはいつどのスキルを使うかを自動的に判断できます
* スキルごとに異なるタスクを担当し、モジュール化された能力の役割分担を実現します
### 🔄 再利用と共有が可能
* 1 つのスキルを複数の AI アシスタントに紐付けられます
* スキルは `.skill` ファイルとしてエクスポートでき、他の組織に共有して利用してもらえます
### 📦 指示とツールのカプセル化
* 「何をするか」（指示）と「何を使うか」（ツール）を一つにまとめます
* AI アシスタントのロール指示に、大量のフロー詳細を繰り返し記述する必要がありません
## スキルとツールの違い
| 比較項目 | ツール | スキル |
| ---------- | ---------------------- | --------------------- |
| **本質** | 単一の外部能力（API、MCP） | ひとそろいの完全な実行フロー |
| **含まれる内容** | API エンドポイント / MCP サーバー | 指示 + ツール + リソース |
| **たとえ** | ドライバー | 組み立てマニュアル + ドライバー |
| **トリガー方式** | AI が呼び出すかどうかを自ら判断 | 説明内のトリガー条件で照合 |
| **適した場面** | 単一の動作（天気の照会、メール送信） | 複数ステップのフロー（返品処理、休暇計算） |
{% hint style="info" %}
スキルとツールは互いに補完し合う関係です。スキルは「付加ツール」を通じてツールの能力を呼び出し、ツールはスキルが必要とする実際の実行能力を提供します。
{% endhint %}
## 具体的な活用シーン
### 🏢 企業のカスタマーサポート
```
スキル：返品処理フロー
トリガー：お客様が返品・交換を要求したとき
手順：注文を照会 → 返品資格を確認 → 返品伝票を作成 → 処理結果を返答
付加ツール：注文照会 API、返品システム API
```
### 🏛️ 行政機関
```
スキル：休暇日数の計算
トリガー：ユーザーが休暇日数、特別休暇の日数を尋ねたとき
手順：人員区分を確認 → 法令の事例を検索 → 照合して計算 → 結果を作成
付加ツール：ナレッジベース検索
```
### 🏪 EC プラットフォーム
```
スキル：顧客情報の収集
トリガー：お客様が購入意欲を示す、見積もりを求めたとき
手順：氏名／会社名／連絡先の提供を案内 → CRM に書き込む
付加ツール：Google Sheet API、CRM ツール
```
### 📧 マーケティングチーム
```
スキル：メール送信サービス
トリガー：ユーザーがメール送信、顧客への連絡を求めたとき
手順：宛先を確認 → メール本文を作成 → 送信
付加ツール：Gmail MCP ツール
```
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/skills/skill-overview.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.