CODEX · CLAUDE CODE · CURSOR

装上 Skill，
然后证明它会用。

这不是“复制一条命令就结束”的教程。我们把列出、安装、文件位置、自动触发和任务完成分开核对。

最短安装路径

$ npx skills add <repo> --list
$ npx skills add <repo> --skill <name>

# 本机 skills CLI 1.5.22
✓ ~/.agents/skills/<name>

01 · DISCOVERCLI 能列出来

02 · INSTALL文件确实落盘

03 · ACTIVATEAI 主动读取

04 · DELIVER真实任务完成

安装前，先审计第三方 Skill

先读 SKILL.md 和 scripts/。也可以运行本站的只读本地审计器，定位脚本、联网、凭据词、文件写删和高风险命令；它不执行目标，规则零命中也不等于安全。

打开安装前只读审计指南 →

四步安装与核对

以下命令使用本站仓库作例子。一次只处理当前需要的 Skill，保留 CLI 版本与本机观察结果。

STEP 01

先列出，不要盲装全部

npx skills add https://github.com/sanhuang520-ship-it/awesome-chinese-ai-tools --list

确认目标名称，也能及早发现仓库结构不被 CLI 识别。

STEP 02

一次只装一个

npx skills add https://github.com/sanhuang520-ship-it/awesome-chinese-ai-tools --skill chinese-typography

Skill 越多，客户端用于发现描述的上下文预算越紧。本次 Codex 实测出现过 description 被缩短的警告。

STEP 03

核对实际文件

ls -la ~/.agents/skills/chinese-typography
ls -la ~/.claude/skills/chinese-typography

本机实测文件位于 ~/.agents/skills/；Claude 目录可见符号链接。版本变化后请以本机结果为准。

STEP 04

测试自动触发

请审查这个中文网页的字体、行高、断行、标点和中英混排问题。

不要在任务里说出 Skill 名称。观察 AI 是否主动读取正确说明，再检查输出是否真正完成任务。

哪些结论已经实测

格式相似不等于跨客户端兼容。没有运行过，就写“待测”。

客户端	当前证据	不能外推的部分
Codex	13/13 自动触发过一次 10 项当次任务完成；1 项等待必要输入；2 项缩小复测通过	不代表所有提示词、版本或大型任务都通过
Claude Code	待真实客户端测试	只看到符号链接不能证明自动触发与完成
Cursor	待真实客户端测试	安装入口、发现和触发需要分别验证

常见误判：命令显示成功，不代表 Skill 被客户端读到；客户端读到了，也不代表任务能在输出预算内完成。

安装后不会自动跟随仓库更新

2026-08-13 隔离复测中，固定版本 skills@1.5.22 安装的 13 项与当前仓库逐字一致；但 8 月 8 日留下的全局副本已经是 0/13 一致，因为仓库后来补充了元数据并修订内容。

先确认版本与来源：未固定版本的 npx skills --version 可能命中本机缓存。复现问题时记录实际版本，必要时固定已知版本；确认上游可信后，再使用 CLI 的更新或重新安装流程。

查看隔离安装命令、结果和证据边界 →

没有触发时，按这个顺序查

① CLI 的 --list 是否能看到目标名称

② ~/.agents/skills/<name>/SKILL.md 是否存在

③ 客户端入口是否能看到同一个 Skill

④ 重启客户端后，用不点名名称的自然任务复测

⑤ 减少同时安装的 Skill，避免描述预算拥挤

⑥ 记录客户端版本、任务原文和错误，不只写“不能用”

需要逐层定位？ 查看 Codex Skill 安装后不自动触发的 5 步诊断树，区分发现失败、安装失败、未触发、未完成和环境阻断。

复现一次，提交成功或失败。

Claude Code 和 Cursor 的真实结果尤其需要。

提交实测 →

装上 Skill，然后证明它会用。