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
# 同：
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 —— 见 arc skill show daemon
arc afs ls /
arc afs explain /
arc afs read /.knowledge

活 daemon 上 /.knowledge 开头是 Agent bootstrap 段。优先信它，不要背挂载表。

全局选项（所有 skill 子命令）

list

show

install

内置 booklet（当前发布集）

相关