Agentic Awesome Skills 入门指南：5 分钟为你的 AI 代理装好技能库（V14.0.0）

• AI 技能
• AI 插件

这篇指南面向第一次接触 Agentic Awesome Skills 的开发者，讲解"技能"(Skills) 的核心概念、两种安装方式、角色化捆绑包的选择方法，以及 Claude Code、Gemini、Cursor、Antigravity 等主流代理工具的支持路径与风险分级机制。读完你就能独立完成仓库安装、按角色挑选技能、并在日常对话中通过@技能名调用它们，让 AI 代理按照标准操作程序（SOP）精准执行任务。

什么是"技能"(Skills)？

AI 代理（如Claude Code、Gemini、Cursor）本身非常智能，但它们缺少关于你所用工具链的特定知识。技能就是专门的操作手册（markdown 文件），用于教授你的 AI 如何完美地执行某一类特定任务。

类比：你的 AI 是一个聪明的实习生，技能是让实习生成长为高级工程师的 SOP（标准操作程序）。

在仓库中，每个技能对应skills/目录下的一个子目录，内含标准的SKILL.md文件。例如 skills/brainstorming/SKILL.md 的开头就以 YAML front-matter 声明了技能名称、用途、风险等级与来源：

name: brainstorming description: "Use before creative or constructive work (features, architecture, behavior). Transforms vague ideas into validated designs through disciplined reasoning and collaboration." risk: critical source: community date_added: "2026-02-27"

这份元数据正是仓库分类、风险过滤和索引生成的基础——risk:字段会直接映射到下文"信任与安全"中的风险分级。

快速入门："入门包"(Starter Packs)

面对拥有 2,000+ 技能的巨型仓库，你不需要一次性安装所有内容。仓库为此策划了入门包（Starter Packs）。

请注意关键一点：你只需安装一次完整的仓库（通过 npx 或 git clone）；入门包是按角色策划的选择清单，帮助你决定"该用哪些技能"（例如 Web Wizard、Hacker Pack），它并不是另一种安装方式。

1. 安装仓库

选项 A — npx（最简单）：

npx agentic-awesome-skills

默认情况下，这会克隆到~/.agents/skills。常用参数如下：

运行npx agentic-awesome-skills --help可查看全部帮助信息。如果看到 404 错误，请改用：npx github:sickn33/agentic-awesome-skills。

从源码看，安装器入口为 tools/bin/install.js（在 package.json 的bin字段中声明为agentic-awesome-skills），它通过 Git 的 partial clone 与 sparse-checkout（要求 Git 2.25+）把"经过验证的发布版本"拉取到临时目录，再按目标工具复制选中的技能。--risk、--category、--tags均支持用逗号分隔多个值，且可用尾部-表示排除（例如--tags debugging,typescript-legacy-表示排除 typescript-legacy 标签）；--all不能与--skills、--risk、--category、--tags混用，否则安装器会直接报错。

选项 B — git clone：

# 通用（适用于大多数代理） git clone https://github.com/sickn33/agentic-awesome-skills.git .agent/skills

2. 选择你的角色

找到与你的角色匹配的捆绑包（参见 bundles.md）：

捆绑包的真实定义可在 data/editorial-bundles.json 中查看。以Essentials为例，它包含concise-planning（先规划）、test-driven-development（红-绿-重构循环）、lint-and-validate（自动保持代码整洁）、systematic-debugging（基于证据而非猜测调试）、git-pushing（安全保存工作）五项基础技能；Web Wizard则包含frontend-design、tailwind-patterns、react-patterns、react-best-practices等 Web 开发技能。每个捆绑包条目还带有audience（适用人群）与why（推荐理由），方便你判断是否契合自身角色。

捆绑包 vs 工作流

捆绑包和工作流解决不同的问题：

• 捆绑包= 按角色策划的集合（选择什么）。
• 工作流= 分步剧本（如何执行）。

首先从 bundles.md 中的捆绑包开始，然后在需要指导执行时从 workflows.md 运行工作流。

示例：

"使用@antigravity-workflows并为我的项目想法运行ship-saas-mvp。"

如何使用技能

安装后，只需自然地与你的 AI 对话，用@技能名的形式引用即可。

示例 1：规划功能（Essentials）

"使用@brainstorming帮助我设计新的登录流程。"

发生什么：AI 加载头脑风暴技能，向你提出结构化问题，并生成专业规范。对应技能定义于 skills/brainstorming/SKILL.md，它明确要求在实现开始前把原始想法通过结构化对话转化为"经过验证的设计与规范"，且激活期间不允许实现、编码或修改行为。

示例 2：检查代码（Web Wizard）

"在此文件上运行@lint-and-validate并修复错误。"

发生什么：AI 遵循技能中定义的严格代码检查规则来清理你的代码。见 skills/lint-and-validate/SKILL.md：它要求先阅读仓库说明与 package scripts，再运行只读的 lint/type-check 命令（如 Node 项目的npm run lint、npm run typecheck，Python 项目已安装的ruff check .或mypy .），并如实上报"命令、退出码、范围与剩余限制"——lint 通过不代表没有运行时或安全缺陷。该技能还自带scripts/lint_runner.py与scripts/type_coverage.py两个辅助脚本，前者保守执行候选检查，后者做只读的类型标注盘点。

示例 3：安全审计（Hacker Pack）

"使用@api-security-best-practices审查我的 API 端点。"

发生什么：AI 根据 OWASP 标准审计你的代码。对应技能位于 skills/api-security-best-practices/SKILL.md，属于 Security Developer 捆绑包，聚焦安全 API 设计模式；Hacker Pack相关的安全技能则在 data/editorial-bundles.json 的security-engineer捆绑包中，包含ethical-hacking-methodology、threat-modeling-expert、top-web-vulnerabilities、burp-suite-testing等。

支持的工具

仓库为多种 AI 代理工具提供了预定义安装路径：

各工具目标路径的映射逻辑可在 tools/bin/install.js 的getTargets()函数中直接验证，例如--claude对应~/.claude/skills，--codex优先读取环境变量CODEX_HOME（缺省回退到~/.codex/skills），未指定任何工具参数时默认安装到~/.agents/skills（Antigravity）。

GitHub Copilot（预览）：gh skill目前处于 preview 阶段。由于本仓库规模较大且同时包含 canonical 与 plugin 镜像，请使用精确路径，避免歧义；除非你确实要安装所有发现的副本，否则不要使用--all：

gh skill preview sickn33/agentic-awesome-skills skills/brainstorming/SKILL.md gh skill install sickn33/agentic-awesome-skills skills/brainstorming/SKILL.md --agent github-copilot --scope user --pin v14.2.0

信任与安全

仓库对技能进行分类，让你了解正在运行的内容。这些值直接映射到每个SKILL.md前置元数据中的risk:字段（如前面brainstorming示例中的risk: critical）：

• ⚪unknown：遗留或未分类内容，仍需要维护者分流。
• 🟢none：纯文本/推理指导。
• 🔵safe：只读或低风险操作指导。
• 🟠critical：会改变状态或影响部署的指导。
• 🔴offensive：渗透测试/红队指导，必须包含明确的 Authorized Use Only 警告。

从源码看，--risk safe,none这类过滤就是读取该字段并执行选择逻辑；--all之所以被设计为"显式选择完整目录"，正是因为完整目录中包含offensive与unknown等级别的技能。添加新技能时，高风险指导会在发布前通过仓库范围的security:docs扫描（package.json 中的npm run security:docs，指向 tools/scripts/tests/docs_security_content.test.js）进行额外审查。

查看 技能目录 获取完整列表。

FAQ

如果你更喜欢使用 Claude Code 的插件市场流程而不是复制到.claude/skills/，请使用：

/plugin marketplace add sickn33/agentic-awesome-skills /plugin install agentic-awesome-skills

问：我需要安装每个技能吗？答：你只需克隆一次整个仓库；你的 AI 仅_读取_你调用（或相关）的技能，因此保持轻量级。bundles.md 中的入门包是策划的列表，帮助你发现适合你角色的正确技能——它们不会改变你的安装方式。

问：我可以制作自己的技能吗？答：可以！使用@skill-creator技能来构建你自己的技能（技能位于 skills/skill-creator/SKILL.md）。

问：如果 Antigravity 在 Windows 上遇到截断崩溃循环卡住怎么办？答：按照 windows-truncation-recovery.md 中的恢复步骤操作。它说明了哪些 Antigravity 存储文件夹需要备份和清除，并包含可选的批处理助手。

问：如果 Antigravity 在 Linux 或 macOS 上因太多技能激活而过载怎么办？答：使用 agent-overload-recovery.md 中的激活流程。它展示如何从克隆的仓库运行scripts/activate-skills.sh（脚本位于 scripts/activate-skills.sh），以便你可以将完整的库归档，并仅激活实时 Antigravity 目录中所需的捆绑包或技能。

问：这是免费的吗？答：是的。原始代码和工具采用 MIT 许可证，原始文档/非代码编写内容采用 CC BY 4.0。参见 LICENSE 和 LICENSE-CONTENT。

下一步

首先需要特定工具的起点？

• Claude Code 技能
• Cursor 技能
• Codex CLI 技能
• Gemini CLI 技能

1. 浏览捆绑包
2. 查看真实示例
3. 贡献技能

• AI 技能
• AI 插件