arc skill | ArcBlock

arc skill は、ARC に同梱された how-to ブックレット（L0 と呼ばれることもある）のための CLI インターフェースです：一覧表示、1 つを出力、またホストのエージェント skill ディレクトリ（.agents/skills、.claude/skills）へコピーします。

これは（まだ）gh skill のような完全なエージェント skill パッケージマネージャーではありません。また、活きた AFS マウントの下にしか存在しない skill（/{mount}/.skills）を棚卸ししません。そちらは AFS のパス（arc afs ls / read / exec）として残ります。3 層構成の全体像と設計上の未解決点については、エンジニアリング記事 arc skill は今どうなっているかと arc#1398 を参照してください。

ブックレットは短く、オフラインでも安全です。デーモンが起動した後は、ライブの AFS（arc afs ls / explain / read /.knowledge）が、マウントと action に関する真実の源です。ブックレットの本文は、ライブツリーに存在しないパスを作り出してはなりません。

skill コマンドを含む CLI ビルドが必要です（ARC 2.0.0-beta.30 / epic #3595 以降）。arc --help | grep skill または arc skill --help で確認してください。

使用法

arc skill
arc skill list
arc skill show <name>
arc skill show all
arc skill install <name>
arc skill install all

サブコマンドなしの arc skill は arc skill list と同じです。

グローバルオプション（すべての skill サブコマンド）

オプション	意味
`--json`	デフォルトのテキストではなく構造化された JSON
`--view <default\|llm\|human\|json>`	コマンドの出力のレンダリングスタイル（`--help` には影響しない）；`json` は `--json` と等価
`--instance <name>` / `-i`	このコマンドがどのローカル ARC インスタンスに対して実行されるか；省略すると `default`（グローバル、概要を参照）
`--home <dir>`	インスタンスのルート（グローバル）。どのインスタンスにするかを選ぶには `--instance` を使う
`-h`, `--help`	このコマンドまたはサブコマンドのヘルプ
`-v`, `--version`	CLI のバージョン

--yaml は削除されました（--help では宣伝されていたが実装されたことは一度もない）；--json または --view json を使ってください。

list

skill の索引を表示します：名前、1 行の説明、ブックレットの入手方法。

arc skill list
# 同じ：
arc skill

--source <bundled|host|afs|all>（デフォルト bundled）：どこから一覧表示するか —— bundled はこの CLI に同梱された L0 ブックレット、host はこのマシン上に既にある .agents/.claude の skill ディレクトリを読む、afs はライブの AFS（デーモンが動いていればそれ、なければ ad-hoc）経由でマウントされた provider の .skills ルートを読む、all は三者の和集合

例（テキスト、省略あり）

ARC skill index (L0 bootstrap — not a full manual)

Skills:
  daemon       Start, attach, and check the ARC daemon / service without breaking a live session.
  afs          Use AFS paths via `arc afs` (list/read/write/exec/explain) once a world is available.
  blocklet     Discover, scaffold, build, and inspect Arc blocklets via `arc blocklet` without reading the monorepo.
  mcp          Connect MCP clients (`arc mcp`) and explore the live AFS tool surface.

How to obtain:
  • Prefer per-name load: arc skill show <name>
  • Avoid full dump unless needed: arc skill show all
  • Install into host agent dirs (when available): arc skill install <name>
  • After a daemon is up, explore live AFS paths — this catalog is L0 bootstrap only

Commands:
  ...

例（JSON）

arc skill list --json

{
  "kind": "index",
  "skills": [
    {
      "name": "daemon",
      "description": "Start, attach, and check the ARC daemon / service without breaking a live session."
    },
    {
      "name": "afs",
      "description": "Use AFS paths via `arc afs` (list/read/write/exec/explain) once a world is available."
    },
    {
      "name": "blocklet",
      "description": "Discover, scaffold, build, and inspect Arc blocklets via `arc blocklet` without reading the monorepo."
    },
    {
      "name": "mcp",
      "description": "Connect MCP clients (`arc mcp`) and explore the live AFS tool surface."
    }
  ],
  "howTo": [
    "Prefer per-name load: arc skill show <name>",
    "Avoid full dump unless needed: arc skill show all",
    "Install into host agent dirs (when available): arc skill install <name>",
    "After a daemon is up, explore live AFS paths — this catalog is L0 bootstrap only"
  ]
}

名前の集合は、この CLI ビルドが同梱しているものそのままです。バージョンをまたいでエージェントの記憶にこの一覧を固定しないでください —— アップグレード後は改めて list を実行してください。

show

1 つのブックレット本文、またはすべてのブックレットを一度に表示します。

arc skill show <name>
arc skill show --name <name>
arc skill show all

引数 / オプション	必須	意味
`<name>` または `--name`	はい	索引にある skill id、または `all`

できるだけ単一の名前を使ってください。show all はすべてのブックレットを連結します（現在のビルドではテキスト量がおおよそ 10KB 程度）—— 意図的に全量ダンプが欲しい場合にのみ使ってください。

例

arc skill show daemon

---
name: daemon
description: Start, attach, and check the ARC daemon / service without breaking a live session.
---

# ARC skill: daemon
...

エラー

未知の名前は fail closed し、既知の一覧を表示します:

arc skill show not-a-skill

ERROR: unknown skill 'not-a-skill'. Known: daemon, afs, blocklet, mcp. Prefer: arc skill list

install

1 つのブックレット（またはすべて）を、ホストのエージェント skill ディレクトリに SKILL.md としてコピーします。オフラインで動作し、対象が既に存在する場合は上書きします。

arc skill install <name>
arc skill install --name <name>
arc skill install all

引数 / オプション	必須	意味
`<name>` または `--name`	はい	索引にある skill id、または `all`

書き込まれるパス（現在の作業ディレクトリを基準とする）：

.agents/skills/<name>/SKILL.md
.claude/skills/<name>/SKILL.md

例

mkdir -p /tmp/demo-agent && cd /tmp/demo-agent
arc skill install afs

Installed afs (2 file(s))
Policy: overwrite — same source as `arc skill show`; no second body tree

  /tmp/demo-agent/.agents/skills/afs/SKILL.md
  /tmp/demo-agent/.claude/skills/afs/SKILL.md

本文は arc skill show afs と一致します（末尾の改行の有無を除く）。CLI をアップグレードした後は、インストールした skill を更新するために install を再実行してください。

組み込みブックレット（現在の同梱セット）

名前	役割
`daemon`	ライブセッションを壊さずに ARC サービスを start/attach/status する
`afs`	パス操作 + discover プロトコル + UI/WM マルチターミナルのサンプル
`blocklet`	monorepo を読まずに `arc blocklet` で discover / scaffold / build する
`mcp`	MCP クライアントをライブの AFS へブリッジする

daemon を読んでサービスが稼働したら、続けてライブの AFS へ進みます:

arc service status
# 必要な場合のみ start する —— arc skill show daemon を参照
arc afs ls /
arc afs explain /
arc afs read /.knowledge

稼働中のデーモンでは、/.knowledge の先頭にAgent bootstrapセクションがあります。マウント表を記憶するより、そちらを優先してください。

グローバルオプション（すべての skill サブコマンド）

list

show

install

組み込みブックレット（現在の同梱セット）

関連