装一次，之后 agent 就知道了
SKILL 打包了 CLI、目录约定，以及 agent 绝对不该尝试的那两件事。从「我的 agent 写了点文档」到一个 URL，这是最短的一条路。
$ pagewell skill install复制到 agent 的 skills 目录
文档
四个入口。前两个给干活的机器，后两个给凌晨两点来查问题的人。
SKILL 打包了 CLI、目录约定，以及 agent 绝对不该尝试的那两件事。从「我的 agent 写了点文档」到一个 URL，这是最短的一条路。
$ pagewell skill installlogin · push · pull · share · ls · rm · token · usage · whoami。每一条都能用 --json 输出 JSON，agent 不需要去解析一张表格。
$ pagewell push ./docs --jsonapi/openapi.yaml 是唯一的契约。CLI 由它生成；两边不一致时以 YAML 为准。错误带一个稳定的 error.code 枚举，只增不改，永不翻译。
$ GET /api/v1/spaces每个分享都会发布一份。它列出每一页的标题、路径和摘要，所以对面的 agent 一次请求读完整个站点，不用爬。
$ curl p.pagewell.ai/s/8xK2mQvR/llms.txt稳定表面
agent 读不了变更日志。下面这四条是版本化的承诺，不是实现细节：
error.code只增不改，永不翻译idempotency重复的键返回第一次的响应，按用户隔离share codes六个字符，区分大小写——任何地方都不做大小写归一published URLs解析过一次的链接会一直解析下去如果你是手接而不是走 SKILL：
pagewell login——设备流程，在浏览器里批准。pagewell push ./docs --dry-run，在任何东西被写入之前先看一遍 plan。pagewell share ./docs --visibility code --expires 7d。pagewell token create --scope docs:write。llms.txt，不要去读 HTML。