> 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/skills-management.md).

# スキル管理

{% hint style="info" %}
スキルとは何かをまだご存じでない場合は、先に次のページをお読みください：[スキル機能の概要](/maiagent-user-guide/maiagent-user-guide-ja/skills/skill-overview.md)
{% endhint %}

## スキルの作成 <a href="#create-skill" id="create-skill"></a>

左側のメニューで <mark style="color:blue;">スキル</mark> をクリックしてスキル管理ページに入り、右上の <mark style="color:blue;">スキルを追加</mark> ボタンをクリックします。

システムでは 2 種類の作成方法を提供しています。

### 方法 1：手動作成 <a href="#method-manual-create" id="method-manual-create"></a>

ゼロからスキルの指示を作成するケースに適しています。

1. スキル追加のポップアップで、下部の <mark style="color:blue;">手動作成に切り替える</mark> リンクをクリックし、手動モードに切り替えます
2. <mark style="color:blue;">基本設定</mark> タブを入力します：
   * **スキル名**（必須）：識別しやすい名前をスキルに付けます
   * **説明**（必須）：スキルの用途を簡潔に説明します

<figure><img src="/files/dLXgpgv0cgqwdQvowIYH" alt=""><figcaption><p>スキルの手動作成 — 基本設定タブ</p></figcaption></figure>

3. <mark style="color:blue;">指示内容</mark> タブに切り替え、Markdown 形式の指示内容を作成します。<mark style="color:blue;">テンプレートを適用</mark> ボタンをクリックして、システムが提供するデフォルトのテンプレートを出発点として利用することもできます

<figure><img src="/files/Z6o7xci0WjEr66xmExe6" alt=""><figcaption><p>指示内容タブ — Markdown 形式とテンプレート適用に対応</p></figcaption></figure>

4. （任意）<mark style="color:blue;">付加ツール</mark> タブに切り替え、スキルに必要なツールを選択します
5. <mark style="color:blue;">保存</mark> をクリックして作成を完了します

### 方法 2：スキルパッケージのアップロード <a href="#method-upload-skill-package" id="method-upload-skill-package"></a>

すでにパッケージ化された `.skill` または `.zip` ファイルをインポートするケースに適しています。

1. スキル追加のポップアップ（デフォルトはアップロードモード）で、`.skill` または `.zip` ファイルをアップロードエリアにドラッグするか、エリアをクリックしてファイルを選択します

<figure><img src="/files/3Uza2hWLWKd3wqXuLAll" alt=""><figcaption><p>スキルパッケージのアップロード — .skill または .zip 形式に対応</p></figcaption></figure>

2. アップロードが完了すると、システムがファイル内の `SKILL.md` を自動的に解析し、スキル名・説明・指示内容を抽出します
3. 作成に成功すると自動的に編集ページに遷移し、さらに設定を調整できます

{% hint style="info" %}
スキルパッケージ内には必ず `SKILL.md` ファイルを含める必要があり、形式は次のとおりです：

```markdown
---
name: スキル名
description: スキルの説明
---

ここに AI アシスタントの実行指示を記述します...
```

{% endhint %}

***

## スキルの編集と設定 <a href="#edit-and-configure-skill" id="edit-and-configure-skill"></a>

スキル一覧で、対象スキルの <mark style="color:blue;">編集</mark> アイコンをクリックすると、スキル設定ページに入ります。

### 基本設定 <a href="#basic-settings" id="basic-settings"></a>

スキルの名前と説明を編集します。

<figure><img src="/files/Zaqsx1NdPrkmJxDZOP7q" alt=""><figcaption><p>スキルの編集 — 基本設定</p></figcaption></figure>

### 指示内容 <a href="#instruction-content" id="instruction-content"></a>

Markdown 形式のスキル指示を編集します。これらの指示は、AI 助理がスキルを展開する際に実行の根拠となります。

<mark style="color:blue;">テンプレートを適用</mark> をクリックすると、デフォルトの指示テンプレートを読み込めます。

{% hint style="warning" %}
テンプレートを適用すると現在の指示内容が上書きされますので、確認のうえ実行してください。
{% endhint %}

### スキルパッケージ（アップロード方式で作成したスキルのみ） <a href="#skill-package" id="skill-package"></a>

スキルが `.skill` / `.zip` のアップロードによって作成された場合、このタブには次の内容が表示されます：

* **スキルパッケージ情報**：ファイル名、サイズ、アップロード日時
* <mark style="color:blue;">プレビュー</mark>：スキルパッケージ内のファイル構造を展開して確認します
* <mark style="color:blue;">ダウンロード</mark>：スキルパッケージファイルをエクスポートします
* <mark style="color:blue;">スキルパッケージを再アップロード</mark>：新しいバージョンをアップロードして既存のスキルパッケージを置き換えます

<figure><img src="/files/LcUYEnuQglNDq1ikBIiL" alt=""><figcaption><p>スキルの編集 — 指示内容（実際の例を含む）</p></figcaption></figure>

### 付加ツール <a href="#additional-tools" id="additional-tools"></a>

スキルに必要なツールを紐づけることで、AI 助理がスキルを実行する際に呼び出せるようにします。

1. <mark style="color:blue;">ツールを選択</mark> ボタンをクリックし、ツール選択のポップアップを開きます
2. 付加したいツールにチェックを入れ（複数選択に対応）、確認をクリックします
3. 選択済みのツールは一覧に表示され、ツール名・種類（API / MCP）・説明が含まれます
4. ツールを削除する場合は、該当ツールのカード上の削除アイコンをクリックします

<figure><img src="/files/aCVyXSnGI0Oni7ic7wVO" alt=""><figcaption><p>付加ツールタブ</p></figcaption></figure>

設定が完了したら、ページ右下の <mark style="color:blue;">保存</mark> ボタンをクリックします。

***

## スキルのエクスポート <a href="#export-skill" id="export-skill"></a>

スキル編集ページの <mark style="color:blue;">スキルパッケージ</mark> タブで <mark style="color:blue;">ダウンロード</mark> ボタンをクリックすると、スキルを `.skill` ファイルとしてエクスポートできます。

{% hint style="info" %}
手動で作成したスキルもエクスポートでき、システムが指示内容とリソースを自動的に `.skill` ファイルへパッケージ化します。エクスポートしたスキルパッケージは、他の組織に共有してインポートしてもらうことができます。
{% endhint %}

***

## スキルを AI 助理に紐づける <a href="#bind-skill-to-ai-agent" id="bind-skill-to-ai-agent"></a>

作成したスキルは、AI 助理に紐づけて初めて有効になります：

1. <mark style="color:blue;">AI 助理</mark> ページに移動し、対象の AI 助理を選択して設定に入ります
2. モデル設定エリアで <mark style="color:blue;">スキル</mark> 設定を見つけます
3. 紐づけたいスキルを選択し、確認をクリックします
4. AI 助理の設定を保存します

紐づけた後、AI 助理は対話の中でユーザーの質問に応じてスキルを展開すべきかどうかを自動的に判断し、スキルの指示に従って対応するタスクを実行します。

***

## スキルの削除 <a href="#delete-skill" id="delete-skill"></a>

スキル一覧で、対象スキルの <mark style="color:blue;">削除</mark> アイコンをクリックし、確認すると削除できます。

{% hint style="warning" %}
スキルを削除すると、このスキルを紐づけていた AI 助理ではそのスキルを使用できなくなります。この操作は元に戻せません。
{% endhint %}


---

# 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/skills-management.md?ask=<question>&goal=<endgoal>
```

`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.