Claude Code 和 Codex Skills 哪里找？awesome-agent-skills 使用指南

awesome-agent-skills 可以当 Claude Code 和 Codex Skills 的查找入口用。它不是单个 skill，也不是安装器，而是 VoltAgent 维护的 GitHub 导航仓库，README 收集官方和社区的 agent skills，并标注兼容 Claude Code、Codex、Gemini CLI、Cursor、OpenCode、Windsurf 等工具。实际用法是先在清单里找技能，再回到对应项目 README 或 SKILL.md 核对安装方式。把它当目录用，比把它当下载页更准确。

怎么在清单里找 Skills

打开 GitHub 仓库 VoltAgent/awesome-agent-skills 后，先看 README 的目录和 Official Skills by 分组。想找 Claude Code 相关技能，优先看 Official Claude Skills；想找 Codex、Cursor 或 Gemini CLI 可用资源，再按分类继续筛。条目数量多时，不要只看名字，要看描述、来源、是否有官方仓库、是否维护，以及技能是否真的解决当前问题。比如写作、代码审查、图像生成、数据处理是不同类型，混着安装只会增加排错成本。

实操时先写下需求关键词，例如“代码评审”“前端设计”“PDF 处理”“记忆管理”。再在 README 页面搜索关键词，打开候选条目，确认它是否有清楚的 SKILL.md、示例输入和限制说明。没有这些信息的条目，可以收藏观察，不急着进项目。

Claude Code 和 Codex 放哪里

README 的 Skills Paths for Other AI Coding Assistants 表格给出常见路径：Claude Code 项目级目录是 .claude/skills/，全局目录是 ~/.claude/skills/；Codex 项目级目录是 .agents/skills/，全局目录是 ~/.agents/skills/。这些路径是查找和安装前的检查点，实际命令、目录结构、版本变化仍以对应工具官方文档和目标 skill 的 README 为准。项目级适合跟仓库一起管理，全局级适合个人常用技能；团队场景先用项目级更容易审查。

使用前怎么避坑

1. 不要从第三方压缩包安装，先回到原始 GitHub 仓库。
2. 优先读 SKILL.md，确认 description、触发场景和限制。
3. 安装到项目目录前，先确认不会覆盖现有 .claude 或 .agents 配置。
4. 安装后查看 Git Diff，确认新增文件只和 skill 有关。
5. 涉及凭据、命令执行或联网能力的技能，先在测试项目验证。
6. 不确定命令、路径或版本时，写“以官方文档为准”。