---
title: Skill
description: Agent が読む Skill を作成し、バージョンを管理します。
---

**Skill** は、Agent に付与して読ませるファイル一式です。指示を書いた `SKILL.md` と、その横に置いたスクリプトや参考資料からなります。モデルは付与された各 Skill の名前と説明だけを最初に受け取り、残りはタスクで必要になったときに読みます。そのため、長い手順を書いても、実際に使うまではコストがかかりません。

![Skill: Workspace の Skill と、それぞれの最新バージョン](/blume-assets/content/docs/_images/ja/skills.webp)

## Skill を書く

**新しい Skill** を選ぶと、`SKILL.md` のエディターが開きます。Frontmatter には、Skill の名前と、どんなときに使うかを書きます。

```md SKILL.md
---
name: refund-policy
description: How Acme decides refunds, and the steps to issue one.
---

# Refund policy

Refund an order within 30 days of delivery. Above $500, ask a manager first.

Run `scripts/eligible.py <order>` to check an order.
```

![新しい Skill のエディター: SKILL.md のテンプレートとそのファイル](/blume-assets/content/docs/_images/ja/skill-new.webp)

**ファイルを追加** では、Skill のルートからのパス (例: `scripts/eligible.py`) を指定して別のファイルを作成します。**アップロード** では、手元のディスクからファイルを追加します。エディターは入力中の `SKILL.md` を検査し、Subako が受け付けない箇所を示します。**Skill を作成** を選ぶと、バージョン 1 として保存されます。

Skill のフォルダーをまとめた `.tar.gz` (ルートに `SKILL.md` があるもの) を、**Archive をアップロード** で取り込むこともできます。

## バージョン

変更するたびに新しいバージョンになります。Skill のページでは、どのバージョンのファイルも表示でき、ファイルを 1 つずつ、または Archive 全体をダウンロードできます。**編集** を選ぶと、表示中のバージョンをもとに次のバージョンを作り始めます。

![Skill のページ: バージョン 1 の refund-policy と、SKILL.md、scripts/eligible.py](/blume-assets/content/docs/_images/ja/skill.webp)

Agent のバージョンで Skill を付与するときは、**最新** (Session 開始時点で最新のバージョン) を使うか、1 つのバージョンに **固定** するかを選びます。Agent のバージョンが付与している Skill や、Session が使用中の Skill は削除できません。

## Agent が Skill を読む場所

Skill のファイルは、Session の Sandbox と Function に `/skills/<name>/` として読み取り専用でマウントされます。そのため、Skill に同梱したスクリプトを、Agent がコマンドを実行する環境でそのまま実行できます。