> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/jp/advanced-basic/extensions/skills.md).

# スキルと能力ライブラリ

スキルは再利用可能な作業手順と付随リソースのセットです。外部システムへの接続は担当せず、Agent にどのような流れ、基準、形式でタスクを完了すべきかを伝えます。

{% hint style="success" %}
ある作業方法が必要なときは、まず【作業】で Agent に目的を伝え、適切なスキルの検索やインストールを手伝ってもらいます。出所の確認、一括管理、ローカルからのインポートが必要な場合にのみ、【設定】→【スキル】を開いてください。
{% endhint %}

<figure><img src="/files/b6beb2514fff587db11871f8a59ffdfe859c1947" alt="根据任务需要选择知识库、技能、内置工具或 MCP 的关系图"><figcaption><p>繰り返し使う方法はスキルとして蓄積するのに向いています。資料、内蔵操作、外部システムはそれぞれ対応する入口を使います。</p></figcaption></figure>

### スキルをインストールする

手動の手順：【設定】→【スキル】。

このページは4種類のソースに対応しています：

* オンラインでスキルレジストリを検索する；
* オンライン検索で【GitHub】を選び、あるスキルの `SKILL.md` ファイルのリンクを貼り付ける；
* ローカルの ZIP ファイルからインストールする；
* を含む `SKILL.md` フォルダからインストールする。

<figure><img src="https://raw.githubusercontent.com/SiinXu/cherry-studio-docs/2446b25878f69e98f33d50623a3c4cf5e836680a/.gitbook/assets/cherry-guide-skill-github-source.png" alt="技能在线搜索中选择 GitHub 并粘贴 SKILL.md 链接"><figcaption><p>①【GitHub】を選んだら、対象スキルの `SKILL.md` ファイルのリンクを貼り付けます。ページはまず具体的なスキルを解析し、その後インストールを提供します。</p></figcaption></figure>

{% stepper %}
{% step %}

#### 1. まず用途を確認する

1文で、そのスキルに解決してほしい問題を説明します。たとえば「会議メモを、決定事項・担当者・期限に整理する」。名前が似ていても手順が同じとは限らないので、インストール前に説明を確認してください。
{% endstep %}

{% step %}

#### 2. ソースと内容を確認する

スキルの詳細を開き、Agent に何をさせるのか、スクリプトが含まれているか、追加ツールや外部アカウントが必要かを確認します。出所不明のスキルは、機密ディレクトリに直接使わないでください。
{% endstep %}

{% step %}

#### 3. Agent に紐づける

まず【設定】→【スキル】でそのスキルのグローバル切り替えが有効になっていることを確認し、次に【作業】→ Agent メニュー→【編集】→【スキル】を開いて、この Agent で有効にします。スキルの切り替えは Agent の設定に応じて自動保存され、次のメッセージから有効になります。
{% endstep %}

{% step %}

#### 4. 実際のタスクで検証する

Agent に小さなサンプルを渡し、手順、出力形式、境界条件が期待どおりか確認してから、一括タスクや定期タスクに使います。
{% endstep %}
{% endstepper %}

### グローバル有効化と Agent 有効化

<figure><img src="https://raw.githubusercontent.com/SiinXu/cherry-studio-docs/2446b25878f69e98f33d50623a3c4cf5e836680a/.gitbook/assets/cherry-guide-skills-global-toggle.png" alt="技能设置页中的全局启用开关和已安装技能列表"><figcaption><p>① カード右側のスイッチで、そのスキルをすべての Agent で選択可能にするかを切り替えます。オフにすると、Agent の編集ウィンドウにはそのスキルが表示されなくなります。</p></figcaption></figure>

| 状態         | 役割                                         | いつ使うか                                    |
| ---------- | ------------------------------------------ | ---------------------------------------- |
| グローバル有効化   | Agent の選択可能なスキル一覧に表示する                     | スキルの出所は信頼でき、なおかつ1つ以上の Agent で使用される可能性がある |
| グローバル無効化   | すべての Agent によるこのスキルの使用を一時停止し、インストール内容は保持する | 一時的な無効化、トラブルシューティング、または安全確認待ち            |
| Agent で有効化 | 現在の Agent のみにそのスキルを読み込ませる                  | 手順が現在の Agent の長期的な役割に合っている               |

<figure><img src="https://raw.githubusercontent.com/SiinXu/cherry-studio-docs/2446b25878f69e98f33d50623a3c4cf5e836680a/.gitbook/assets/cherry-guide-skill-github-source.png" alt="技能在线搜索中选择 GitHub 并粘贴 SKILL.md 链接"><figcaption></figcaption></figure>

グローバルスイッチをオフにしてもスキルはアンインストールされません。再度オンにしたあとも、各 Agent の有効状態を確認する必要があります。アンインストールすると、スキル内容が削除され、関連付けも整理されます。

### スキル、プロンプト、MCP の使い分け

| 必要なもの                  | 選ぶべきもの           | 理由                      |
| ---------------------- | ---------------- | ----------------------- |
| 一時的な要望を一言で             | 現在のタスク用プロンプト     | 長期設定を追加する必要はない          |
| 同じ手順を何度も使う             | スキル              | 説明、テンプレート、リソースを同時に保存できる |
| Agent の長期的な役割を設定する     | Agent のシステムプロンプト | すべてのタスクで従う必要がある         |
| データベースまたは外部サービスにアクセスする | MCP              | スキル自体には接続機能がない          |

### ユーザー事例：チーム週報スキル

チームは週報の項目、トーン、データ確認、禁止表現をスキルにまとめ、「週報整理」Agent に紐づけました。毎週は今週の資料を渡すだけで、Agent はスキルに従って固定構成で出力します。データが外部システムから来る場合は、アカウント情報や API の詳細をスキル本文に書くのではなく、MCP を組み合わせます。

{% hint style="danger" %}
スキルをアンインストールすると、グローバルな機能ライブラリから削除され、Agent ワークスペース内の関連付けも整理されます。実行前に、そのスキルを使用中のタスクがないことを確認してください。チーム独自のスキルは、復元可能なソースファイルを残しておくべきです。
{% endhint %}

<details>

<summary>インストール後、なぜ Agent はスキルを使っていないのですか？</summary>

まず、そのスキルがグローバルで無効になっていないことを確認し、次に Agent 編集ウィンドウの【スキル】で有効化するか、Agent に紐づけを手伝ってもらいます。その後、新しいメッセージを送ってテストしてください。

</details>

<details>

<summary>スキルにプログラムを含められますか？</summary>

スキルパッケージには説明、リソース、スクリプトを含めることができます。スクリプトを実行できるかどうかは、Agent のツール、作業ディレクトリ、環境依存、権限モードにも左右されます。

</details>

<details>

<summary>スキルにプログラムを含められますか？</summary>

スキルパッケージには説明、リソース、スクリプトを含めることができます。スクリプトを実行できるかどうかは、Agent のツール、作業ディレクトリ、環境依存、権限モードにも左右されます。

</details>


---

# 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.cherryai.com.cn/docs/jp/advanced-basic/extensions/skills.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.