---
id: skills
title: Skills（スキル）
category: advanced
order: 110
keywords: [Skills, スキル, インストール, Git URL, ReadSkill, per-task, ワークスペース, 共有, スペース]
---

# Skills（スキル）

スキルは、エージェントが必要に応じて読み込む **参照知識**（手順書・ガイド・規約）です。「この API はこう叩く」「このレポートはこの体裁で書く」といった再利用可能なノウハウを 1 つにまとめておけます。

## スキルとピースの違い

スキルとピース（→「[ピースの仕組み](05-pieces.md)」）は役割が違います。

| | スキル | ピース |
|---|---|---|
| 何か | 参照知識・手順書 | タスクの種類（実行テンプレート） |
| 役割 | エージェントが読んで参考にする | movement の流れと使えるツールを定義 |
| エージェントの操作 | `ReadSkill` で全文取得 / `ListSkills` で一覧 | piece 自体がワークフローを駆動 |

スキルは「知識」、ピースは「進め方」と覚えてください。

## エージェントからの利用

利用可能なスキルは、movement 開始時に system prompt の **Skills Index** として一覧注入されます。エージェントは概要を見て「これは使える」と判断したら `ReadSkill({ name })` で全文を読み込みます。`ListSkills` で一覧、`InstallSkill` でタスク中に新規インストールもできます。

スクリプト付きスキルは `ReadSkill` 時に workspace の `skills/{名前}/` へコピーされます。スキルが後から（別のタスクなどで）更新された場合も、次の `ReadSkill` でコピーが自動的に最新版へ置き換わるので、読み直すだけで更新が反映されます。

## スキルの追加（ワークスペース → 設定 → スキル）

ワークスペースを開いて **設定 → スキル** で管理します（旧「ユーザーフォルダ → skills」タブは廃止され、ワークスペース設定に集約されました）。2 カラムの list + detail 構成です。

### 手動作成

1. **+ New Skill**
2. **Name**: 小文字英数字・ハイフン・アンダースコアのみ
3. **Content**: SKILL.md の全文（frontmatter + 本文）
4. **Scope**: Personal（個人）/ System（全ユーザー共有、admin のみ）
5. **Create**

Name は Content の frontmatter `name:` と一致している必要があります（一覧上の表示名と保存先の名前がズレて管理できなくなるのを防ぐため、不一致は作成時に拒否されます）。エージェントの InstallSkill も同じ規則です。

### URL からインストール

左パネル上部の「Install from URL...」に Git URL を入力 → **Install**。個人スコープ（user）でインストールされます。

### 編集・削除

一覧から選ぶと右に詳細（説明・トリガー・本文・セキュリティ検査結果）が出ます。**Edit** / **Delete** で更新できます。system スコープのスキルは admin のみ編集可能です。削除や保存に失敗した場合、エラーはボタンのすぐ近くに表示されます。

## 共有ワークスペースでの可視性

個人スコープ（Personal / user）で作ったスキルの置き場所は、**いま作業しているワークスペースで決まります**。AGENTS.md・メモリ・ピースと同じ扱いです。

| 作業中のワークスペース | 見える人 |
|---|---|
| 共有ワークスペース（案件など） | そのワークスペースのメンバー全員 |
| 個人ワークスペース | 自分だけ |

共有ワークスペースで作ったスキルはメンバー間で共有され、各メンバーのエージェントの Skills Index にも出ます。個人ワークスペースで作ったスキルは自分専用で、他の人には見えません。

共有ワークスペースのスキルは他メンバーのジョブからも実行され得ます（共有ピース・共有 AGENTS.md と同じ信頼境界）。秘匿情報や自分専用の手順は、個人ワークスペースで作ってください。

System スコープは作業中のワークスペースに関係なく常に全ユーザー共有（admin のみ）です。

## セキュリティ検査

インストール・作成時にスキル内容がセキュリティスキャンされます。

- **HIGH** の検知があると **ブロック**（インストール不可）
- **MEDIUM** は警告付きで通過
- 詳細画面に検知行（パターン・該当箇所）が表示されます

## スキルをタスク単位で無効化

タスク作成ダイアログ（→「[タスクの作り方](02-tasks.md)」）に **「Skills を無効化」** チェックがあります。

- ON にすると、そのタスクでは Skills Index を注入しません
- スキルが不要なタスクでトークンを節約したいときに使います

## 上限

スキルにはサイズ・件数の上限があります（`config.yaml` の `skills` セクション、未指定時はデフォルト値）。

| 項目 | デフォルト |
|---|---|
| 個人スキル数 | 50 |
| スキル本文サイズ | 64 KB |
| ディレクトリ形式の合計サイズ | 5 MB |
| system スキル数 | 100 |
| Skills Index の最大文字数 | 2000 |

ディレクトリ形式（`scripts/` などを含む）のスキルは、ファイル数 100・階層 3 段までという追加制限があります。
