claude-skills 中文教程：先装一个技能，验证后再扩容
alirezarezvani/claude-skills 是一个社区 Agent Skills 大仓库。v2.12.0 发布说明记录 380 个技能、96 个 marketplace 插件、20 个领域、706 个 Python 工具、823 份参考资料、114 个 agents 和 138 条命令。
1. 先选技能，不要先全量安装
从 README 的领域列表进入具体目录，依次读 SKILL.md、scripts 和 references。重点看三个问题：什么请求会触发、脚本会执行什么命令、结果会写到哪里。若技能调用外部 CLI 或服务，还要核对凭据和数据去向。
Claude Code 可以按单技能安装：
/plugin marketplace add alirezarezvani/claude-skills
/plugin install skill-security-auditor@claude-code-skillsREADME 也给出 engineering、marketing、product 等领域 bundle。第一次试用单技能更容易检查失败原因，也便于删除。
2. Codex 安装前要看目标目录
项目给 Codex 的入口是：
npx agent-skills-cli add alirezarezvani/claude-skills --agent codex
# 另一条官方路径
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills
./scripts/codex-install.sh这两条命令都可能写入客户端技能目录。执行前先查看帮助与脚本，确认是复制还是符号链接、安装全部还是筛选目录。Windows 用户还要按官方 INSTALLATION 处理 Git 符号链接和 UTF-8，否则镜像目录可能只剩一行指针文本。
3. 用四个小测试验收
| 检查 | 做法 | 失败信号 |
|---|---|---|
| 触发 | 准备 3 个应触发、3 个不应触发的请求 | 泛化请求也频繁加载技能 |
| 写入 | 在临时仓库运行，比较前后文件 | 修改了任务范围外文件 |
| 命令 | 先运行脚本的帮助或无副作用样例 | 未经说明访问网络、安装包或读取凭据 |
| 升级 | 固定 release/commit，再比较新版差异 | 自动更新后规则或工具权限改变 |
README 称 Python CLI 使用标准库，但该结论是仓库层声明。本轮没有逐个执行 706 个工具。实际采用哪个技能，就检查哪个目录。
4. 和 Anthropic 官方 skills 仓库的区别
相比 Anthropic 官方 anthropics/skills，alirezarezvani/claude-skills 更强调数量、业务领域和 13 种客户端适配。Anthropic 官方仓库提供规范、模板、示范技能和 Claude Code 安装入口，并明确提醒关键任务要在自己的环境充分测试。
需要现成的营销、合规、研究或经营流程时，社区仓库更容易找到候选；要学习官方 SKILL.md 格式、许可边界和最小实现时，官方仓库更清楚。两者都不能跳过本地审查。
5. 当前版本和已知限制
最新正式 Release 是 v2.12.0。README 同一页一处写 706 个 Python 工具，另一处写 727 个，说明主分支计数可能已继续变化或口径不一致。引用统计时应带版本，不把动态首页数字混入 v2.12.0。
- 全量安装会放大触发冲突与升级审查成本。
- “production-ready”“security-audited”属于项目方描述，仍需针对目标技能检查。
- 领域资料可能随外部工具、法规和 API 更新。
- 脚本虽可能没有 pip 依赖，仍可能读写文件、调用系统命令或外部程序。
6. 验证状态与验证边界
验证边界：没有验证具体技能触发、706 个脚本的输出、外部服务、转换脚本、安全扫描结果或 Windows 符号链接。教程里的安装命令来自官方资料，不代表已经在本机成功运行。
这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。
先判断这个项目是否适合你
近期变化与关注原因
它把工程、产品、营销、合规、研究和经营类工作流放进同一仓库，并同时提供 SKILL.md、脚本和参考材料。覆盖面很广，适合用现成目录找起点；同样因为体量大，安装全部内容之前更需要逐项检查触发条件、脚本和工具权限。
适合谁用
适合为团队寻找现成的工程、产品、研究或运营工作流，也适合比较同一技能在多种编码代理中的打包方式。只需要一条短规则、必须控制上下文体积，或不能审计第三方脚本时，直接写一个项目级小技能更稳妥。
采用建议
这个仓库适合作为技能目录和工作流样本库，不适合不经审查地全量装入日常代理。实用做法是按任务挑一个技能，固定 release 或 commit，审查 SKILL.md 与脚本，再用几个会触发和不会触发的真实请求验收。
原教程未展开的系统信息
核心功能
技能、代理和 persona 分层
仓库把执行方法、任务角色和跨领域思考身份分开，README 还提供组合编排入口。
配套脚本与参考材料
技能目录除 SKILL.md 外可带 Python CLI、模板、检查表和领域资料；项目称 Python 工具只使用标准库。
多客户端适配
README 提供 Claude Code、Codex、Gemini CLI、OpenClaw 等安装路径，并用转换脚本生成其他客户端格式。
架构与数据流
仓库按领域组织技能目录，每个技能以 SKILL.md 为入口，可附 scripts、references 和 assets。Claude Code 通过 marketplace 插件清单按领域或单技能分发；Codex 路径使用 agent-skills-cli 或仓库脚本；其他客户端依赖镜像目录、符号链接或 convert.sh。它是指令与工具集合，不是持续运行的服务。
常见问题
claude-skills v2.12.0 到底有多少个技能？
v2.12.0 发布说明给出的口径是 380 个技能、96 个 marketplace 插件和 20 个领域。旧 Wiki 与搜索摘要仍可能显示 192 或 345，那些数字已经过期。
需要一次安装全部 380 个技能吗？
不需要。Claude Code 的 marketplace 支持按领域 bundle 或单个 skill 安装。先装一个能解决当前任务的技能，检查触发与脚本，再决定是否扩大范围。
仓库里的 Python 工具真的不需要 pip 依赖吗？
官方把这些 CLI 描述为标准库工具。本轮没有逐个运行 706 个脚本，因此仍应打开目标脚本并在隔离目录执行 --help 或测试样例，不能把仓库总说明当作逐文件实测。
claude-skills 可以直接装进 Codex 吗？
README 提供 agent-skills-cli 和 codex-install.sh 两条路径。安装前要确认目标目录、符号链接和会复制的技能范围；本轮只核对文档，没有实际安装。