Skills
turing-cli skills 把图灵发布的 Agent Skills 安装到你本机使用的 Agent 中,并负责之后的更新和卸载。需要 turing-cli 0.4.0 或更高版本。
可安装的 Skills
| Skill | 用途 |
|---|---|
turing-memory | 在多个 Agent 之间 Recall / Remember 同一份个人长期记忆,见 Memory |
turing-operations | 查询图灵平台的用量、费用和 token,见 Operations |
turing-artifacts | 在图灵平台创建、修改、渲染和分享 Artifact |
everything-2-markdown | 把 PDF / Word / Excel / PowerPoint 转成 Markdown,见 Documents |
运行 turing-cli skills list 查看当前发布渠道中的全部 Skills。
安装
在终端里运行:
turing-cli skills install
CLI 依次请你选择 Skill、安装范围和 Agent,列出将要写入的目录后再确认:
- 安装范围默认是当前用户,对所有项目生效;也可以选当前项目,以执行命令时的工作目录为项目目录。
- Agent 列表预选检测到的 Agent,也可以手动选择任何已支持的 Agent。只列出在所选范围内有目录的 Agent。
也可以用参数直接指定:
turing-cli skills install --skill turing-operations --agent claude-code --agent opencode --global --yes
turing-cli skills install --skill '*' --agent codex --project --yes
| 参数 | 说明 |
|---|---|
--skill | Skill 名称,可重复;'*' 表示全部,且只能单独使用 |
--agent | Agent 名称,可重复,取值见支持的 Agent |
-g, --global | 安装到当前用户范围 |
-p, --project | 安装到当前项目 |
-y, --yes | 不再提问,见下方说明 |
--catalog-url | 指定 Skill 清单地址,默认与 CLI 的发布渠道一致 |
--yes 等同于在每个提示处直接回车:使用当前用户范围和检测到的 Agent,并跳过确认;一个 Agent 都没检测到时报错。加了 --yes 的命令在任何环境中都不会停下来等输入,所以由 Agent 代为运行时,应当总是带上 --yes。Skill 没有默认选项,--skill 仍需显式给出。
不带 --yes 的非交互运行(例如在 CI 中)必须同时给出 --skill、--agent,以及 --global 或 --project。
支持的 Agent
| Agent | --agent | 当前用户目录 | 项目目录 |
|---|---|---|---|
| Claude Code | claude-code | ~/.claude/skills,跟随 CLAUDE_CONFIG_DIR | .claude/skills |
| OpenCode | opencode | ~/.config/opencode/skills,跟随 XDG_CONFIG_HOME | .agents/skills |
| Codex | codex | ~/.agents/skills | .agents/skills |
| CodeBuddy | codebuddy | ~/.codebuddy/skills | .codebuddy/skills |
| OpenClaw | openclaw | ~/.openclaw/skills | 不支持 |
- 多个 Agent 共用同一个目录时(例如项目中的
.agents/skills),只写入一次。 - Agent 的配置目录中除了
skills/还有其他内容,才算检测到该 Agent。 - 在用户主目录下使用
--project会被拒绝,因为它和当前用户范围是同一组目录。 - Codex 从
~/.agents/skills读取用户 Skills;$CODEX_HOME/skills是 Codex 已弃用、仅为兼容保留的位置,所以CODEX_HOME只用于检测 Codex 是否已安装。 - OpenClaw 从它自己配置的 workspace 读取项目 Skills,不读当前目录,因此不支持
--project。它会优先读取~/.agents/skills,同名时以那里为准,所以为 OpenClaw 安装时,那里已有的旧版副本或未改动的受管副本会一并更新(没有就不创建,改过的副本不动);status、update对 OpenClaw 也会包含这个目录。
查看与更新
turing-cli skills status
turing-cli skills update
status默认列出当前用户和当前项目中由 turing-cli 管理的 Skills;加--global或--project只看一个范围,加--agent只看指定 Agent。update默认更新当前用户范围,update --project更新当前项目。只有 SHA-256 与清单不一致时才会下载;某个 Skill 更新失败不会阻断其他 Skill,失败项在最后统一报告。- 每个 Skill 沿用安装时的发布渠道。需要切换渠道时,显式指定
--catalog-url。
卸载
turing-cli skills remove --skill turing-operations --agent opencode --global --yes
remove 只删除由 turing-cli 安装、且没有本地修改的副本。
remove --yes不指定--agent时,和status、update一样覆盖所有 Agent。此时遇到其他工具留下的同名目录(没有安装记录,例如npx skills放在~/.agents/skills的副本),会跳过并提示。- 在用
--agent指定或在选择器里选定的 Agent 下遇到这类目录时,整个卸载请求失败,什么都不删除。安装记录损坏的副本,以及指向受管副本的符号链接,也会让请求失败。 ~/.agents/skills是 Codex 的目录,remove --agent openclaw不会删除那里的副本,而是提示加上--agent codex才能一并移除。
安装记录与本地修改
每个安装目录中都有一份安装记录 .turing-cli-skill.json,记录来源清单、版本和每个文件的 SHA-256。turing-cli 只更新或卸载它自己安装并记录的目录:
- 遇到已有的同名 Skill(不是 turing-cli 安装的)时拒绝覆盖。
- 修改过的副本不会被更新或卸载覆盖。
.DS_Store、__pycache__等文件不算本地修改。
发布渠道
Skills 和 CLI 二进制一起发布,正式版和开发快照各有独立的版本与 latest 指针:
- 正式版 CLI 默认读取
https://live-public-aigc-resources.s3.cn-north-1.amazonaws.com.cn/turing/turing-cli/latest/skills/manifest.json。 - 开发快照默认读取
turing-cli-dev下的同名路径。
安装前,CLI 会按清单中的 SHA-256 校验完整的 Skill 包,并拒绝跳转到非 HTTPS 地址。CLI 自身的升级见 Upgrade & Version,它和 Skill 更新是两个独立操作。
Memory
turing-memory 还需要登录并导入 Space 配置。用 skills install 安装后,依次运行:
turing-cli memory login
turing-cli memory install --config ~/turing-agent-memory.json --config-only
turing-cli memory doctor
--config-only 只导入配置,不改动 Agent 目录。也可以不先运行 skills install,直接运行 memory install --config,它使用同一个 Agent 选择器。详见 Memory。
旧版 memory install 留下的副本
0.4.0 之前的 memory install 把 turing-memory 固定写入 ~/.claude/skills、~/.codex/skills、~/.codebuddy/skills、~/.openclaw/skills 和 ~/.agents/skills,并且不写安装记录。
- 只有内容与旧版发布的原文逐字节一致的副本,才会被识别为旧版副本;内容不同的同名目录一律按"不是 turing-cli 安装的"处理,不会被覆盖或删除。
- 再次为对应 Agent 安装
turing-memory时,旧版副本会被接管。status会把它显示为legacy,并给出可以直接执行的接管命令;update和remove会跳过它。 - 为 Codex 安装时,
~/.agents/skills中的旧版副本会被接管。只要这次安装把新副本写入了~/.agents/skills(为 Codex 安装,或为 OpenClaw 同步),已弃用的~/.codex/skills中的旧版副本就会被删除,避免 Codex 同时加载两份。删除前,交互确认会列出这个目录。