今天的 `arc skill` 是什么（以及它还不是什么）
装好 ARC 后输入 arc skill，你会看到几个名字：daemon、afs、blocklet、mcp。你可以打印其中一本的正文，或拷进 .claude/skills/ / .agents/skills/。这就是当前命令实际做的事。
很容易从字面「skill」联想到更大的东西——尤其对照 GitHub CLI 的 gh skill（从 GitHub 搜索/安装/更新 agent skills），或注意到 AFS 挂载下还有 /.skills。本文把人们口头说的 三种 skill 拆开，给出可粘贴步骤，并写明我们还没做完的设计缺口。
完整参数表见 arc skill 参考文档。
三种 “skill”，一个词太挤
| 层 | 在哪 | 谁用 | 今天归 arc skill 管吗？ |
|---|---|---|---|
| 内置 booklet（L0） | arc 二进制里 | 需要“怎么启动”的人/agent | 是 — list / show / install |
| 宿主 agent skills | 磁盘上的 .claude/skills/、.agents/skills/ | Claude Code、Codex 等 | 仅作 L0 的安装目标 — 不负责列出/更新/删除任意 skill |
| AFS provider skills | 活 daemon 上 /{mount}/.skills/** | 探索已挂载 provider 的 agent | 否 — 用 arc afs ls/read/exec（和 explain） |
若只把 arc skill 说成「教 agent 用 ARC」，既偏窄，也和 install、以及 AFS 自带 skill 树对不上。
现在就能做的事（可粘贴）
0. 版本
arc --version # 需要带 skill 的构建（约 2.0.0-beta.30+）
arc skill --helparc --help 里没有 skill → 先升级二进制。
1. 看内置目录
arc skill list
arc skill list --json2. 读一本 booklet
arc skill show daemon
arc skill show afsbooklet 里典型流程：
arc service status→ 需要才 startarc afs ls /·explain /·read /.knowledge- UI/WM：session 在
/dev/ui下，panels 样例见afsbooklet
优先单名。show all 是离线/调试用全量 dump。
3. 写进宿主 agent 目录
cd /path/to/your-project
arc skill install afs
ls .agents/skills/afs/SKILL.md .claude/skills/afs/SKILL.md真相源仍是 CLI 构建。升 arc 后若要刷新文件，再跑一次 install。
4. 活世界上的 provider skills（不走 arc skill）
export ARC_INSTANCES_DIR=/tmp/arc-skill-instances
arc service start --instance skill-demo --home /tmp/arc-skill-demo --port 19890
arc afs ls /
arc afs ls /some-mount/.skills
arc afs read /some-mount/.skills/SKILL.md这是 AFS，不是 arc skill。混在一起读者就会懵。
gh skill 有、我们还没有的
gh skill 是 agent skills 的包管理器：搜索、预览、从 GitHub 安装、列已装、更新、发布。
今天的 arc skill 更接近：
- ARC 自带的 帮助包，外加
- 向宿主 skill 目录的 单向拷贝。
还没有：
- 列出
.claude/skills/.agents/skills里已有内容（除刚从 ARC install 的） - 从 registry 搜索/安装第三方 skill
- 盘点各挂载上的
/.skills - 通用的 uninstall / update
这是首期有意收窄（防 over-engineering），但读完文档就会觉得 名字 邀请的是更完整的产品。原始 idea：ArcBlock/arc#1398；窄版 L0 在 #3549 / #3595 落地。
设计方向（提案，未实现）
把 arc skill 当作 围绕 ARC 的 agent skill CLI，源显式：
arc skill list [--source bundled|host|afs|all]
arc skill show <id> [--source …]
arc skill install <id> # 今天：bundled → host；以后可接 registry
arc skill search … # 以后应保持的约束：
- L0 booklet 短、可离线 —
bundled不依赖 daemon - 活 AFS 仍是挂载/action 真相 — booklet 不得编路径
- 不要另起一套全球 skill 生态 — GitHub 源可与
gh skill组合；ARC 拥有的挂载走 AFS
在那之前，文档和本文只应写 「内置目录 + 宿主安装」，不要写成「整个 skill 系统」。
什么时候够用 / 不够用
够用： 干净 agent 或同事要从 help 起步，起 daemon → 探 AFS → 脚手架 blocklet，不读 monorepo。
不够用： 指望 arc skill list 列出 Claude Code 里所有已装 skill，或 daemon 上每个 provider 的 skill。那些请列宿主目录 / afs ls …/.skills，或等 multi-source CLI。