claude-skills 怎么安装？Claude Code/Codex Agent Skills 使用教程（含避坑）

安装 claude-skills 前，先想清楚你用的是 Claude Code 还是 Codex。两者都能用这套技能库，但入口不一样：Claude Code 推荐走插件市场，Codex 更像把技能同步到本地 .codex/skills。入口选错，最常见的结果不是报一个清楚的错误，而是你以为装好了，Agent 实际没有加载任何技能。

仓库 README 当前把 Claude Code 放在推荐安装位：先添加 marketplace，再按领域安装插件包。Codex 则给出 npx agent-skills-cli 的方式，同时保留 git clone 加脚本安装的路线。对大多数人来说，先装一个领域包比手动复制 355 个文件夹更安全，出问题也容易回滚。

Claude Code 安装：先加市场，再选领域包

在 Claude Code 里，README 给出的核心步骤是：

/plugin marketplace add alirezarezvani/claude-skills
/plugin install engineering-skills@claude-code-skills

第二行只是示例。你也可以换成 engineering-advanced-skills、product-skills、marketing-skills、ra-qm-skills、c-level-skills 等。安装后不要急着把全部包都装上，先用一个明确任务验证，比如“用 pr-review-expert 检查这个 PR 的风险”。失败场景：装了营销、财务、合规、工程一大堆包，却没有告诉 Claude 当前任务要用哪个技能，模型可能只按普通聊天完成。

Codex 安装：用 agent-skills-cli 或手动复制

OpenAI Codex 的 README 命令是：

npx agent-skills-cli add alirezarezvani/claude-skills --agent codex

如果不用 npx，也可以克隆仓库，然后把需要的技能文件夹复制到 ~/.codex/skills。手动方式的好处是可控：你只拿一个技能，先读 SKILL.md，再看 scripts 和 references 是否会触及本地文件或网络。失败场景：直接同步全库但不看脚本内容，后面遇到本地命令、扫描工具或转换脚本时，很难判断是哪一个技能触发了行为。

安装后先做三个检查

1. 确认目标目录存在。Claude Code 看插件安装状态，Codex 看 ~/.codex/skills 下是否出现目标技能目录。
2. 打开 SKILL.md。重点看 description、触发条件、是否要求读取 references、是否会调用 scripts。
3. 用一个小任务触发。比如让 Agent 只做审查、只生成 checklist、只解释某个技能的使用边界。

这三个检查比“能不能安装成功”更重要。Skill 的风险不在文件大小，而在它会不会让 Agent 过度行动。尤其是包含安全审计、依赖扫描、迁移生成、CI/CD 配置的技能，最好先在测试仓库里跑。

什么时候不要继续安装

如果你无法解释某个技能会读哪些目录、会运行哪些脚本、会把输出写到哪里，就先停。claude-skills 本身是 MIT 开源仓库，里面大量 Python 工具标注为标准库、零 pip 依赖，但“开源”不等于“可以不审查”。更稳的顺序是：先装一个、读一遍、跑小任务、确认输出，再扩展到第二个。技能包的好处是可复用，前提是你能控制它复用到哪里。