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

# Skills

> 1 つのタスクと関連ファイルを再利用可能なスキルにまとめ、ワークスペース全体で共有

> このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、[英語版](/en/self-host/use-dify/build/skills) を参照してください。

スキルは一度作成すれば繰り返し使える、自己完結型のパッケージです。`SKILL.md` には、1 つのタスクの手順と Agent がそのスキルを使うタイミングを記述します。タスクに必要な参考資料やスクリプトも含められます。完全な形式は [Agent Skills](https://agentskills.io/home) を参照してください。

**Skills** ページで、スキルライブラリのスキルを作成、インポート、管理します。

スキルライブラリには最大 500 個のスキルを保存し、ワークスペース全体で共有できます。スキルの更新を公開すると、そのスキルを利用するすべての Agent に最新バージョンが反映されます。

スキルは次の場所で利用できます：

* [新しい Agent アプリ](/ja/self-host/use-dify/build/new-agent/build#スキル)
* [Workflow アプリ](/ja/self-host/use-dify/build/workflow-chatflow) 内の [新しい Agent ノード](/ja/self-host/use-dify/nodes/agent)

<Info>
  スキルの作成と管理には、エディター以上のロールが必要です。
</Info>

## スキルの作成

**Skills** で **作成する** をクリックします。既存のスキルを複製して始めるには、そのスキルの **⋯** メニューから **複製** を選択します。公開済みのスキルを複製しても、ドラフトの変更は含まれません。どちらの方法でもエディターが開きます。自分で書くことも、[Skill Builder](#skill-builder-による下書き) で下書きを作ることもできます。

`SKILL.md` の本文には、Agent が従う手順を書きます。frontmatter では次の項目を設定します：

* **表示名**：スキルがサイドバー上部や各所に表示されるときの名前です。見分けやすい名前にします。
* **名前**：Agent がスキルを参照するための一意の名前です。例：`refund-requests`。
* **説明**：Agent がそのスキルを使うか判断するために読みます。具体的に記述します。
* **メタデータ**：参考情報を記録するためのカスタムフィールドです。例：`owner: payments-team`、`source: https://wiki.example.com/refund-policy`。

ファイルツリーから、スクリプト、参考資料、その他の関連ファイルを追加します。ファイルの種類によって操作が異なります：

* **テキストとコード**（Markdown、スクリプト、JSON、YAML など）：その場で編集できます。
* **CSV、画像、PDF**：その場でプレビューできます。
* **その他のファイル**：ダウンロードして確認します。

### Skill Builder による下書き

Skill Builder とチャットすると、スキルの下書きを作成できます。シナリオを説明するか、既存の手順書を添付してください。Skill Builder が `SKILL.md` を記述し、確認や修正に使える関連ファイルも作成します。

次のファイル形式に対応しています：

| 種類         | 例                                           |
| :--------- | :------------------------------------------ |
| PDF        | `.pdf`                                      |
| Word       | `.docx`                                     |
| Excel      | `.xlsx`                                     |
| PowerPoint | `.pptx`                                     |
| RTF        | `.rtf`                                      |
| 画像         | `.png`、`.jpg`、`.jpeg`、`.gif`、`.webp`、`.svg` |
| テキストとデータ   | `.txt`、`.md`、`.csv`、`.json`、`.yaml`         |

1 回のメッセージに最大 10 個のファイルを添付できます。画像は 10 MB、その他のファイルは 15 MB までです。添付ファイルは Skill Builder のコンテキストとして使われ、スキルには含まれません。スキルに含めるファイルは、ファイルツリーから追加します。

## スキルのインポート

ほかで作成したスキルをスキルライブラリに取り込むには、**インポート** をクリックします。
`.zip` または `.skill` パッケージを選択してください。
パッケージには `SKILL.md` が必要です。
サイズはデフォルトで最大 50 MB で、[`UPLOAD_SKILL_FILE_SIZE_LIMIT`][upload-skill-file-size-limit] で調整できます。
インポートすると、確認して公開できるドラフトとして追加されます。

## スキルへのタグ付け

スキルのカードまたはエディターでタグを追加し、タグでスキルを絞り込みます。

## 公開とバージョン

編集内容はドラフトとして自動保存されます。Agent に追加するには、ドラフトを公開してください。公開するたびにバージョンが保存され、後から確認したり復元したりできます。変更内容を記録するには、対象バージョンの **⋯** メニューを開き、タイトルとメモを追加します。

<Note>
  バージョンを復元すると、現在のドラフトが置き換わります。そのドラフトを公開すると、最新バージョンになります。
</Note>

## スキルのエクスポート

ワークスペース外でスキルを使うには、カードの **⋯** メニューから **エクスポート** を選択します。最新の公開バージョンが `.zip` ファイルとして出力されます。

## スキルの削除

スキルを削除すると、すべてのバージョンとともにワークスペースから削除されます。そのスキルを使うすべての Agent からも削除されます。削除したスキルは復元できません。後で必要になる可能性があれば、先にコピーをエクスポートしてください。

[upload-skill-file-size-limit]: /ja/self-host/deploy/configuration/environments#upload_skill_file_size_limit
