arc skill | ArcBlock

arc skill 管理 ARC 內建 how-to booklet（常稱 L0）：列出、列印一本、或拷進宿主 agent skill 目錄（.agents/skills、.claude/skills）。

它還不是像 gh skill 那樣的完整 agent-skill 包管理器，也不盤點只存在於活 AFS 掛載下的 skill（/{mount}/.skills）。後者仍走 AFS（arc afs ls / read / exec）。三層地圖與設計缺口見工程文今天的 arc skill 是什麼與 arc#1398。

booklet 短、可離線。daemon 起來之後，活 AFS（arc afs ls / explain / read /.knowledge）才是掛載與 action 的真相源。booklet 不得編造 live tree 裡不存在的路徑。

需要 CLI 已包含 skill 命令（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 索引：名稱、一行描述、如何取得 booklet。

arc skill list
# same:
arc skill

--source <bundled|host|afs|all>(預設 bundled)：從哪裡列——bundled 是這個 CLI 自帶的 L0 booklet，host 讀這臺機器上已有的 .agents/.claude skill 目錄，afs 通過活的 AFS 讀掛載的 provider 的 .skills 根目錄(daemon 在跑就走它，不然走 ad-hoc)，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

顯示一本 booklet 正文，或一次性全部。

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

引數 / 選項	必填	含義
`<name>` 或 `--name`	是	索引中的 skill id，或 `all`

優先 單個名稱。show all 會拼接全部 booklet（當前構建約 10KB 量級）——只有刻意要全量 dump 時才用。

示例

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

把一本（或全部）booklet 複製到宿主 agent 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 升級後重新 install 以重新整理。

內建 booklet（當前釋出集）

名稱	作用
`daemon`	起/掛/看狀態，不誤傷別人的 live session
`afs`	路徑操作 + discover 協議 + UI/WM 多樣本
`blocklet`	用 `arc blocklet` 發現 / 腳手架 / 構建，不必讀 monorepo
`mcp`	把 MCP 客戶端接到活 AFS

daemon + 服務起來之後，繼續走活 AFS：

arc service status
# start only if needed — see arc skill show daemon
arc afs ls /
arc afs explain /
arc afs read /.knowledge

活 daemon 上 /.knowledge 開頭是 Agent bootstrap 段。優先信它，不要背掛載表。

全域選項（所有 skill 子命令）

list

show

install

內建 booklet（當前釋出集）

相關