---
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` でタスク中に新規インストールもできます。

## スキルの追加（Settings → Skills）

Settings → **Skills**（またはユーザーフォルダ → skills）で管理します。2 カラムの list + detail 構成です。

### 手動作成

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

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

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

### 編集・削除

一覧から選ぶと右に詳細（説明・トリガー・本文・セキュリティ検査結果）が出ます。**Edit** / **Delete** で更新できます。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 段までという追加制限があります。
