Agentic Awesome Skills 技能目录完全指南：从目录结构、搜索查找到按需加载与自定义创作-尧图手机网站定制

Agentic Awesome Skills 技能目录完全指南：从目录结构、搜索查找到按需加载与自定义创作

【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,600+ agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址: https://gitcode.com/GitHub_Trending/an/agentic-awesome-skills

本篇指南以 Agentic Awesome Skills 仓库中的技能目录（Skills Directory）为核心，系统讲解其 1,936+ 个 AI 技能的组织方式、SKILL.md文件结构、@技能名按需调用方法、关键词搜索与角色化技能包（Bundles）的使用路径，并结合仓库源码（安装激活脚本、技能 frontmatter、目录索引）进行底层验证。读完本文，你将掌握如何安装、检索、激活、组合乃至创作一个可被 Claude Code、Gemini CLI、Codex、Cursor 等 Agent 识别的专业技能。

一、技能目录是什么：Agent 的"专家模块库"

Agentic Awesome Skills 仓库维护了一个规模庞大的技能目录（Skills Directory）。根据 docs/vietnamese/SKILLS_README.vi.md 的定义，技能（Skills）是教 AI 助手处理特定任务的专用指令集合，可以理解为 AI 可随时按需加载的专家知识模块。

一个简单而准确的类比：就像人类可以咨询不同的专家（设计师、安全工程师、市场营销人员），技能让 AI 在你需要的那一刻，成为对应领域的专家。每个技能本质上是一个或多个 Markdown 指令文件，AI 助手（如 Claude Code、Gemini CLI、Codex CLI、Cursor、Antigravity、Kiro、OpenCode）读取后即获得该领域的操作规程（SOP）——正如 docs/vietnamese/GETTING_STARTED.vi.md 所述：AI 是优秀的实习生，技能是把它变成资深工程师的标准作业流程。

仓库根目录下的 skills_index.json 与 CATALOG.md 共同构成了该目录的索引层，而skills/目录下的每一个子目录则是一个具体的技能。仓库内所有技能均基于 MIT 许可证发布，可自由用于个人与商业场景（详见 LICENSE 与 docs/vietnamese/FAQ.vi.md）。

二、目录结构解剖：每个技能的标准骨架

技能目录采用"一技能一目录"的扁平组织方式。原文档给出了如下标准结构：

skills/ ├── skill-name/ # 单个技能目录 │ ├── SKILL.md # 核心技能定义（必需） │ ├── scripts/ # 辅助脚本（可选） │ ├── examples/ # 使用示例（可选） │ └── resources/ # 模板与资源（可选）

核心规则：只有SKILL.md是强制要求，其余一切皆为可选。这一点在 docs/vietnamese/SKILL_ANATOMY.vi.md 中得到了更细致的展开——技能目录还可以包含templates/（可复用代码模板）、references/（API 文档等参考资料）与README.md（补充说明）。

以仓库实际存在的技能为例验证该结构：

skills/brainstorming/SKILL.md：单文件技能，frontmatter 声明name: brainstorming、risk: critical、source: community，正文用 7 个步骤（理解上下文 → 逐个提问 → 非功能性需求 → 理解锁定 → 探索方案 → 增量呈现 → 决策日志）描述"如何把模糊想法转化为经过验证的设计"，并要求在实现开始前完成文档化与交接。
skills/systematic-debugging/SKILL.md：以"Iron Law（铁律）——无根因调查不修复"为核心，规定了四个强制阶段（Root Cause Investigation → Reproduction → Verification → Prevention），文件总长约 299 行，属于典型的多阶段高复杂度技能。
skills/git-pushing/SKILL.md、skills/concise-planning/SKILL.md 等则属于聚焦型轻量技能。

从源码结构看，仓库中大量技能（如 skills/react-best-practices、skills/loki-mode）采用"SKILL.md + 多份辅助文档/脚本"的组织形式，SKILL.md 只负责总控指令，细节被拆入同目录的其他文件中，这正对应 SKILL_ANATOMY 中"渐进式披露（Progressive Disclosure）"的设计理念。

2.1 SKILL.md 的两段式结构

每个SKILL.md由两部分组成：

① Frontmatter（YAML 元数据）——供目录索引、分类与风险管控使用：

--- name: my-skill-name # 必填：kebab-case，须与目录名完全一致 description: "..." # 必填：一句话功能描述，建议 150 字符内 category: development # 分类：development / security / testing / infrastructure 等 risk: safe # 风险等级，见下文 source: community # 来源：community / self / 来源 URL source_repo: "..." # 可选：外部来源仓库地址 source_type: "github" # 可选：来源类型 date_added: 2026-06-25 # 必填：加入 registry 的日期 tags: ["react", "typescript"] # 可选：标签 ---

② 正文（指令）——技能的"灵魂"，建议依次包含：H1 标题、Overview（2~4 句解释"为什么存在"）、When to Use（何时触发，帮助 AI 判断激活时机）、Core Instructions（可执行的分步指令）、Examples（给 AI 展示"好的输出长什么样"）、Best Practices、Common Pitfalls 与 Related Skills。

risk字段是技能安全性的第一道闸门，五种取值对应不同的危险等级（直接对应各SKILL.md的 frontmatter）：

unknown：旧内容或未分类内容，使用前需人工审视；
none：纯文本/论证类指令，无 shell 命令、无状态变更；
safe：只读或低风险操作（如 lint、review、分析）；
critical：会修改文件、删除数据或执行网络扫描等可能造成破坏的操作，需谨慎；
offensive：渗透测试/红队攻击技术，仅限已获授权的目标使用。

三、三步上手：从安装到"AI 变身专家"

原文档给出的使用流程高度凝练，结合 docs/vietnamese/GETTING_STARTED.vi.md 与 docs/vietnamese/FAQ.vi.md 可完整还原为以下三步：

第一步：安装并确保技能已就位

使用官方安装器（CLI），默认安装到~/.agents/skills/（Antigravity 全局目录）：

npx agentic-awesome-skills

也可通过工具专属 flag 指定目标目录：

npx agentic-awesome-skills --claude # 安装到 .claude/skills/ npx agentic-awesome-skills --gemini # 安装到 .gemini/skills/ npx agentic-awesome-skills --codex # 安装到 .codex/skills/ npx agentic-awesome-skills --cursor # 安装到 .cursor/skills/ npx agentic-awesome-skills --kiro # 安装到 ~/.kiro/skills/ npx agentic-awesome-skills --agy # Antigravity CLI npx agentic-awesome-skills --path <dir> # 自定义目录

各工具的目标路径速查（详见 docs/vietnamese/GETTING_STARTED.vi.md 的工具支持表）：Claude Code 用.claude/skills/，OpenCode 用.agents/skills/，Cursor 用.cursor/skills/，AdaL CLI 用.adal/skills/，Antigravity 还支持.agent/skills/，agy则使用~/.gemini/antigravity-cli/skills/。GitHub Copilot 目前通过gh skill提供预览支持，安装时需使用仓库内的精确路径（如skills/brainstorming/SKILL.md）以避免与插件镜像混淆。

仓库自带的激活脚本 scripts/activate-skills.sh 揭示了这套目录体系底层的安装机制：脚本通过AG_BASE_DIR/AG_SKILLS_DIR/AG_LIBRARY_DIR等环境变量控制安装位置，先将skills/仓库目录同步到 skills_library，再借助tools/scripts/get-bundle-skills.py（BUNDLE_HELPER变量）展开技能包（Bundles），最后把被选中的技能（默认concise-planning git-pushing kaizen lint-and-validate systematic-debugging）从库中恢复到激活目录；--clear参数可将现有技能先归档为带时间戳的skills_archive_*目录再重置，实现"分层叠加（APPEND）"或"重置（RESET）"两种激活模式。Windows 用户无需再配置core.symlinks=true或开启开发者模式，直接运行上述安装命令即可。

第二步：在对话中以`@`符号调用技能

安装完成后，在 AI 对话中直接以@技能名触发对应技能：

@brainstorming 帮我设计一个 todo 应用

@stripe-integration 给应用加上支付处理

@即"加载该技能知识并让 AI 以专家身份处理当前任务"的开关。多技能可以同时调用，例如"先用@brainstorming设计，再用@writing-plans生成任务清单"。注意技能名是精确匹配的（如@brainstorming而非@brain-storming），AI/IDE 安装后需要重启才能识别新技能。

第三步：AI 以专家身份交付

一旦技能被加载，AI 就会严格遵循技能正文中的分步指令完成任务——例如加载@brainstorming后，AI 会被约束为"设计引导者"而非"实现者"，必须逐个提问、显式声明假设、维护决策日志，直到满足退出条件才允许进入实现阶段（见 skills/brainstorming/SKILL.md 的 Exit Criteria）。这正是"AI 变身为专家"的机制：技能不是把知识注入模型，而是把可验证的操作规程注入上下文。

四、三种检索方式：在 1,936+ 技能中找到你要的

技能数量庞大（原文档标注 1,936+，仓库索引随社区贡献持续增长），无需也不可能一次全部了解。目录提供三种检索路径：

方式一：直接浏览目录

ls skills/

方式二：按关键词过滤

ls skills/ | grep "关键词"

例如查找与支付相关的技能：ls skills/ | grep "stripe"。

方式三：查阅官方清单

CATALOG.md：仓库根目录的全量技能目录，按类别组织，是系统化浏览的入口；
skills_index.json：机器可读的技能索引（含 frontmatter 元数据），供目录检索、自动分类与工具链消费；
根目录 README.md 及 docs/vietnamese/README.vi.md 提供分类概览（架构、业务、数据与 AI、开发、通用、基础设施、安全、测试、流程九大类）。

此外，仓库在plugins/下维护了面向不同生态的插件包（如agentic-awesome-skills-claude），并在data/下提供catalog.json、bundles.json、aliases.json等数据文件，供需要程序化消费目录的开发者使用。

五、新手到专家的推荐技能清单

原文档按受众给出三档推荐，直接可复现于本仓库：

面向新手：

@brainstorming——编码前先设计（skills/brainstorming/SKILL.md）；
@systematic-debugging——有方法地排查故障（skills/systematic-debugging/SKILL.md）；
@git-pushing——写出高质量 commit 信息（skills/git-pushing/SKILL.md）。

面向开发者：

@test-driven-development——测试先行（仓库含完整的 TDD 系列：skills/tdd-workflows-tdd-red、skills/tdd-workflows-tdd-green、skills/tdd-workflows-tdd-refactor）；
@react-best-practices——现代 React 模式（skills/react-best-practices）；
@senior-fullstack——全栈开发（skills/senior-fullstack）。

面向安全：

@ethical-hacking-methodology——安全基础（skills/ethical-hacking-methodology/SKILL.md）；
@burp-suite-testing——Web 应用安全测试（skills/burp-suite-testing/SKILL.md）。

5.1 用"技能包（Bundles）"按角色起步

面对海量技能，官方推荐的起步方式是挑选按角色编排的技能包（详见 docs/vietnamese/BUNDLES.vi.md）。安装一次仓库后，让 AI 按包内清单依次使用即可：

角色	技能包	代表技能
Web 开发者	`Web Wizard`	`react-patterns`、`tailwind-patterns`、`frontend-design`、`form-cro`、`seo-audit`
安全工程师	`Hacker Pack`	`ethical-hacking-methodology`、`burp-suite-testing`、`owasp-top-10`、`linux-privilege-escalation`、`cloud-penetration-testing`
产品/管理者	`Product Pack`	`brainstorming`、`planning`、`seo`、`strategy`
人人必备	`Essentials`	`concise-planning`、`lint-and-validate`、`git-pushing`、`kaizen`

Essentials 包正是激活脚本 scripts/activate-skills.sh 默认展开的四个技能，与仓库内data/bundles.json、data/editorial-bundles.json中定义的包清单保持一致。仓库还内置了大量角色包目录（如plugins/agentic-bundle-essentials、plugins/agentic-bundle-security-engineer、plugins/agentic-bundle-web-wizard），可作为按需扩展的选装来源。

六、创作你自己的技能：从模板到验证

原文档给出三条创作路径，均可在仓库内找到落点：

阅读 docs/vietnamese/CONTRIBUTING.vi.md 了解贡献规范与技能模板；
阅读 docs/vietnamese/SKILL_ANATOMY.vi.md 掌握结构规范（frontmatter 字段、正文章节建议、最小/标准/全面三级规模指南、质量检查清单）；
直接让 AI 使用@skill-creator技能（skills/skill-creator）自动生成新技能。

6.1 质量标准与验证

SKILL_ANATOMY 提供了一套可操作的技能质量检查清单：内容层面（指令可执行、示例真实、无错别字、技术准确性已验证）、结构层面（frontmatter 为合法 YAML、name与目录名一致、标题层级规范 H1→H2→H3）、完整性层面（Overview 讲"为什么"、Instructions 讲"怎么做"、Examples 展示"是什么"、覆盖边界情况）。仓库配套提供了自动化验证工具链：

执行npm run validate本地校验（贡献 PR 时 Quality Bar 也会自动执行同样的检查）；
scripts/validate-glossary.sh 与 scripts/validate-links.sh 分别校验术语一致性与文档链接有效性；
根目录 package.json 定义了这些校验命令的入口。

6.2 编写技巧速览

用祈使句与明确动作："检查用户是否已认证后再继续"优于"你或许应该考虑检查认证"；
给出具体步骤："1. 创建 PostgreSQL 数据库；2. 运行npm run migrate；3. 执行npm run seed"优于"正确配置数据库"；
用条件逻辑：针对不同场景（React vs Vue）给出分支指令；
渐进式披露：基础用法与高级模式分层组织，避免一次性灌输；
交叉引用：串联相关技能形成工作流，例如@brainstorming设计 →@writing-plans规划 →@test-driven-development实现；
案例学习：仓库中brainstorming（结构清晰）、git-pushing（简洁聚焦）、systematic-debugging（全面系统）、react-best-practices（多文件组织）、loki-mode（复杂工作流）分别代表了不同复杂度与组织风格的范本。

七、常见问题与排错速查

基于 docs/vietnamese/FAQ.vi.md 整理：

需要安装全部技能吗？不需要。仓库全量下载后 AI 只按@指令读取所需技能，按需加载、非常轻量。
AI 识别不到技能？依次排查：安装路径是否正确（对照工具支持表）、是否重启了 AI/IDE、@技能名是否拼写准确。
技能给出过时建议？在仓库提交 issue，附上技能名、实际行为与期望行为。
能否离线使用？技能文件存在本地，但 AI 助手本身需要联网运行。
能否修改官方来源的技能？不建议直接修改以source_repo/source_type标记的外部来源技能，应提交附带清晰来源的 issue 或小 PR。
PR 未通过 Quality Bar？多为缺少合法description或使用示例，先本地执行npm run validate自查。