企业官网建设流程全解析

Agentic Awesome Skills 可视化指南：从安装、调用到自建 Skill 的完整图解

【免费下载链接】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,115+ agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址: https://gitcode.com/gh_mirrors/an/agentic-awesome-skills

本篇指南以图示化方式系统讲解 agentic-awesome-skills 仓库的核心用法：你将通过 ASCII 流程图直观理解"开发者 → AI 助手 → Skill"的完整调用链路、仓库目录结构与 SKILL.md 文件解剖，并掌握安装、搜索、调用、创建与验证 Skill 的每一步实操命令。读完本文，你既能熟练使用npx agentic-awesome-skills安装器与@skill-name调用语法，也能独立完成第一个 Skill 的创建、校验与提交。

一、一目了然：从"一句话需求"到"专家级支持"

整个仓库解决的核心问题可以用一条链路概括：你不需要自己成为每个领域的专家，AI 助手借助 Skill 可以临时"变身"为该领域的专家。

┌─────────────────────────────────────────────────────────────┐ │ 你（开发者） │ │ ↓ │ │ "帮我把支付系统搭起来" │ │ ↓ │ ├─────────────────────────────────────────────────────────────┤ │ AI 助手 │ │ ↓ │ │ 加载技能 @stripe-integration │ │ ↓ │ │ 成为 Stripe 支付领域的专家 │ │ ↓ │ │ 提供深度支持（含可直接使用的代码示例） │ └─────────────────────────────────────────────────────────────┘

这条链路的四个关键角色是：开发者（提出需求）→AI 助手（读取并执行 Skill）→Skill（领域知识载体）→最终产出（专家级代码与建议）。仓库本身并不运行 AI，它只负责把 Skill 整理成 AI 助手能直接读取、索引和执行的标准化文件集合。

二、仓库结构可视化：每个目录解决什么问题

仓库根目录（即 README.md 所在的仓库根）的组织方式如下：

agentic-awesome-skills/ │ ├── 📄 README.md ← 总览与 Skill 列表 ├── 📄 CONTRIBUTING.md ← 贡献指南 │ ├── 📁 skills/ ← 2,126+ 个 Skill 的规范来源（canonical source） │ │ │ ├── 📁 brainstorming/ │ │ └── 📄 SKILL.md ← Skill 定义文件 │ │ │ ├── 📁 stripe-integration/ │ │ ├── 📄 SKILL.md │ │ └── 📁 examples/ ← 可选的补充材料 │ │ │ └── ...（其余 2,100+ 个 Skill） │ ├── 📁 tools/ │ ├── 📁 scripts/ ← 管理、校验、生成 catalog 的脚本 │ ├── 📁 lib/ ← 安装器共用逻辑（skill-utils.js、symlink-safety.js 等） │ └── 📁 bin/ ← CLI 入口（install.js / aas.js / aas-mcp.js） │ ├── 📁 .github/ │ └── 📄 MAINTENANCE.md ← 维护者指南 │ └── 📁 docs/ ← 文档 ├── 📄 GETTING_STARTED.md ← 从这里开始（入门） ├── 📄 FAQ.md ← 常见问题 ├── 📄 BUNDLES.md ← 起步组合包 ├── 📄 QUALITY_BAR.md ← 质量标准 ├── 📄 SKILL_ANATOMY.md ← Skill 内部机制深入解析 └── 📄 VISUAL_GUIDE.md ← 本可视化指南的英文原版

从源码结构可以印证这一划分：

• skills/是唯一的内容源（single source of truth），每个 Skill 是一个目录，目录内至少有一个SKILL.md。例如 skills/brainstorming/SKILL.md 就是 243 行结构化指令。
• tools/bin/install.js是 package.json 中bin字段注册的agentic-awesome-skills可执行文件（另有aas与aas-mcp两个入口，对应 AAS Core 控制平面与本地 MCP 服务器）。
• tools/lib/skill-utils.js提供listSkillIdsRecursive、readSkill等安装器核心函数，负责递归扫描 skills 目录、解析每个 SKILL.md。
• tools/scripts/下有validate_skills.py、generate_index.py、build-catalog.js等脚本，分别对应npm run validate、npm run index、npm run catalog命令。

三、Skill 工作原理：五步流程

一个 Skill 从"躺在仓库里"到"真正帮到你"需要经历五个阶段：

┌──────────────┐ │ 1. 安装 │ npx agentic-awesome-skills └──────┬───────┘ ↓ ┌──────────────┐ │ 2. 调用 │ 在 AI 聊天中输入：@skill名 └──────┬───────┘ ↓ ┌──────────────┐ │ 3. 加载 │ AI 读取 SKILL.md 文件 └──────┬───────┘ ↓ ┌──────────────┐ │ 4. 执行 │ AI 遵循 Skill 中的指令 └──────┬───────┘ ↓ ┌──────────────┐ │ 5. 产出 │ 你获得专家级帮助 └──────────────┘

值得强调的是第 2 步的@skill名语法：这是 AI 聊天场景下的约定俗成调用方式，@号用于唤起某个已安装 Skill，后面紧跟你的具体需求描述。第 3 步中 AI 读取的是SKILL.md中的 frontmatter（元数据）与正文（指令），frontmatter 的description字段帮助 AI 判断"这个 Skill 什么时候该用"。

四、Skill 分类地图：仓库里都有什么

仓库内的 Skill 覆盖面很广，原文档给出了一幅按领域划分的示意图：

┌─────────────────────────┐ │ 2,126+ AWESOME SKILLS │ └────────────┬────────────┘ │ ┌─────────────────────────┼─────────────────────────┐ │ │ │ ┌────▼────┐ ┌──────▼──────┐ ┌──────▼──────┐ │ 创意 │ │ 开发 │ │ 安全 │ └────┬────┘ └──────┬──────┘ └──────┬──────┘ │ │ │ • UI/UX 设计 • TDD • 道德黑客 • Canvas 艺术 • Debugging • Metasploit • 界面/主题 • React 设计模式 • Burp Suite • SQLMap │ │ │ └─────────────────────────┼─────────────────────────┘ │ ┌─────────────────────────┼─────────────────────────┐ │ │ │ ┌────▼────┐ ┌──────▼──────┐ ┌──────▼──────┐ │ AI │ │ 文档 │ │ 营销 │ └────┬────┘ └──────┬──────┘ └──────┬──────┘ │ │ │ • RAG 系统 • DOCX • SEO • LangGraph • PDF • Copywriting • Prompt 工程 • PPTX • CRO • Voice Agents • XLSX • 付费广告

结合当前仓库的实际数据，这一分类图可以得到更精确的印证：skills_index.json 收录2,126 条Skill 记录，每条包含id、path、category、name、description、risk、source、date_added等字段。按category字段统计，数量靠前的类别包括development（187）、cloud（146）、ai-ml（129）、security（86）、content（67）、business（67）、web-development（65）、workflow（62）、marketing（57）、automation（55）等。这说明了原文档图示的领域划分是有数据支撑的——分类字段是结构化的，可以被脚本和 Agent 直接检索，这正是"agent-first"（以 Agent 为先）设计的体现。

五、SKILL.md 文件解剖：一个 Skill 的内部结构

每个 Skill 的核心是一个SKILL.md文件，其标准结构如下：

┌─────────────────────────────────────────────────────────┐ │ SKILL.md │ ├─────────────────────────────────────────────────────────┤ │ │ │ ┌───────────────────────────────────────────────┐ │ │ │ FRONTMATTER（元数据） │ │ │ │ ───────────────────────────────────────────── │ │ │ │ --- │ │ │ │ name: my-skill │ │ │ │ description: "这个 Skill 的用途" │ │ │ │ --- │ │ │ └───────────────────────────────────────────────┘ │ │ │ │ ┌───────────────────────────────────────────────┐ │ │ │ 正文（指令） │ │ │ │ ───────────────────────────────────────────── │ │ │ │ │ │ │ │ # Skill 标题 │ │ │ │ │ │ │ │ ## 概述 │ │ │ │ 这个 Skill 做什么... │ │ │ │ │ │ │ │ ## 何时使用 │ │ │ │ - 在...场景下使用 │ │ │ │ │ │ │ │ ## 指南 │ │ │ │ 1. 第一步... │ │ │ │ 2. 第二步... │ │ │ │ │ │ │ │ ## 示例 │ │ │ │ ```javascript │ │ │ │ // 示例代码 │ │ │ │ ``` │ │ │ │ │ │ │ └───────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────┘

以仓库中的真实文件 skills/brainstorming/SKILL.md 为例，其 frontmatter 实际包含比图示更多的字段：

--- 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" ---

可以看到，除了name和description，真实仓库还使用risk（风险等级，如 safe / critical）、source（来源，如 community / personal）、date_added（入库日期）等字段。正文则按 "Purpose / Operating Mode / The Process" 的结构组织，严格限定 AI 在 Skill 激活期间的"操作模式"（例如 brainstorming 明确禁止直接写代码，只做设计引导）。

更完整的字段规范与编写要求，可阅读 SKILL_ANATOMY.vi.md（深入解析）与 QUALITY_BAR.vi.md（质量标准）。

六、安装与验证：三步上手

第 1 步：使用安装器安装

npx agentic-awesome-skills

┌─────────────────────────────────────────┐ │ Terminal │ ├─────────────────────────────────────────┤ │ $ npx agentic-awesome-skills │ │ │ │ ✓ 安装到 '~/.agents/skills'... │ │ ✓ 完成！ │ └─────────────────────────────────────────┘

结合 tools/bin/install.js 的源码，这条命令背后其实支持相当丰富的参数，帮助文本显示完整用法为npx agentic-awesome-skills [install] [options]，常用参数包括：

例如 README 中演示的按需预演安装：

npx agentic-awesome-skills --antigravity --skills brainstorming,systematic-debugging --dry-run

第 2 步：验证安装结果

┌─────────────────────────────────────────┐ │ 文件管理器 │ ├─────────────────────────────────────────┤ │ 📁 ~/.agents/ │ │ └── 📁 skills/ │ │ ├── 📁 brainstorming/ │ │ ├── 📁 stripe-integration/ │ │ ├── 📁 react-best-practices/ │ │ └── ...（2,100+ 个 skills） │ └─────────────────────────────────────────┘

验证要点：确认目标目录下每个 Skill 都是一个独立子目录，且目录内含SKILL.md。

第 3 步：在 AI 助手中使用 Skill

┌─────────────────────────────────────────┐ │ AI 助手对话窗口 │ ├─────────────────────────────────────────┤ │ 你: @brainstorming 帮我设计一个 │ │ todo 应用 │ │ │ │ AI: 太好了！让我先帮你把需求想清楚。 │ │ 首先，请告诉我主要用途： │ │ a) 个人任务管理 │ │ b) 团队协作 │ │ c) 项目规划 │ └─────────────────────────────────────────┘

注意：安装器本身只负责把文件复制到目标目录；真正"使用"Skill 的是你配置了该 skills 目录的 AI 助手（如 Claude、Cursor 等支持该目录约定的编码工具）。安装器的源码（tools/bin/install.js）还实现了多项安全防护：拒绝符号链接安装根、拒绝越界写入、写入前生成--dry-run预演、安装前静态审计风险信号等，安装过程不会执行任何 Skill 内容。

七、实战演练：给应用接入 Stripe 支付

原文档用"给应用添加 Stripe 支付"作为完整示例，完整还原了从需求到交付的五个步骤：

┌─────────────────────────────────────────────────────────────┐ │ 第 1 步：明确需求 │ ├─────────────────────────────────────────────────────────────┤ │ "我需要给应用添加支付处理能力" │ └─────────────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────────────┐ │ 第 2 步：找到正确的 Skill │ ├─────────────────────────────────────────────────────────────┤ │ 搜索关键词: "payment" 或 "stripe" │ │ 找到: @stripe-integration │ └─────────────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────────────┐ │ 第 3 步：调用 Skill │ ├─────────────────────────────────────────────────────────────┤ │ 你: @stripe-integration 帮我加订阅支付 │ └─────────────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────────────┐ │ 第 4 步：AI 加载 Skill 知识 │ ├─────────────────────────────────────────────────────────────┤ │ • Stripe API 模式 │ │ • Webhook 处理 │ │ • 订阅管理 │ │ • 最佳实践 │ └─────────────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────────────┐ │ 第 5 步：获得专家级支持 │ ├─────────────────────────────────────────────────────────────┤ │ AI 提供: │ │ • 代码示例 │ │ • 配置指引 │ │ • 安全注意事项 │ │ • 测试策略 │ └─────────────────────────────────────────────────────────────┘

第 2 步的"搜索"在当前仓库中有三条真实可行路径（详见下一节），第 4 步中 AI 读取的正是 skills/stripe-integration/ 目录下的SKILL.md。这个 Skill 在 skills_index.json 中有结构化记录（含category、risk、source、plugin兼容目标等元数据），因此既可以被 AI 通过索引文件检索到，也可以被用户直接阅读。

八、三种搜索 Skill 的方式

方式 1：按目录浏览

README.md → 滚动到 "Full Skill Registry" → 找类别 → 选 Skill

方式 2：命令行关键词过滤

ls skills/ | grep "关键词"

例如ls skills/ | grep stripe会直接列出仓库内所有名称含 stripe 的 Skill 目录；ls skills/ | grep react则列出 React 相关 Skill。

方式 3：使用结构化索引

打开 skills_index.json → 搜索关键词 → 找到 Skill 的 path

skills_index.json 是根目录下的结构化 JSON 文件，每条记录形如：

{ "id": "00-andruia-consultant", "path": "skills/00-andruia-consultant", "category": "andruia", "name": "00-andruia-consultant", "description": "...", "risk": "safe", "source": "personal", "date_added": "2026-02-27", "plugin": { "targets": { "codex": "supported", "claude": "supported" } } }

这个索引文件是整个仓库"可被 Agent 发现"的关键设施：Agent 可以把它作为目录（catalog）读取，按category、risk、description等字段精确筛选，而不需要逐个扫描目录。它与npm run index（执行 tools/scripts/generate_index.py）保持同步生成。

九、创建你的第一个 Skill：六步流程

┌──────────────┐ │ 1. 想法 │ "我想分享 Docker 知识" └──────┬───────┘ ↓ ┌──────────────┐ │ 2. 初始化 │ mkdir skills/docker-mastery └──────┬───────┘ touch skills/docker-mastery/SKILL.md ↓ ┌──────────────┐ │ 3. 写作 │ 添加 frontmatter + 正文 └──────┬───────┘ （参考 CONTRIBUTING 中的模板） ↓ ┌──────────────┐ │ 4. 测试 │ 用 npx 或 --path 本地试装 └──────┬───────┘ 尝试调用: @docker-mastery ↓ ┌──────────────┐ │ 5. 校验 │ npm run validate └──────┬───────┘ ↓ ┌──────────────┐ │ 6. 提交 │ git commit + push + Pull Request └──────────────┘

对应到当前仓库的具体操作：

1. 想法：确定 Skill 要解决的具体问题，并明确其边界（不要贪多）。
2. 初始化：在skills/下新建目录与SKILL.md。注意仓库是只读镜像，你应在自己的 fork / 本地副本中完成这些写入操作。
3. 写作：参考 CONTRIBUTING.vi.md 中的模板与 SKILL_TEMPLATE.md，按第五节的 frontmatter + 正文结构撰写。
4. 测试：安装器支持--path参数指向任意本地目录，例如npx agentic-awesome-skills --path .agents/skills --skills docker-mastery，把本地 Skill 试装到临时目录后即可在 AI 助手中用@docker-mastery实测。也可以先用--dry-run预演。
5. 校验：运行npm run validate（实际执行node tools/scripts/run-python.js tools/scripts/validate_skills.py，定义于 package.json），通过后可进一步运行npm run validate:strict严格校验。
6. 提交：完成git commit后创建 Pull Request，按 CONTRIBUTING.md 的流程提交。

十、Skill 的复杂度等级：三种形态

并不是所有 Skill 都是单文件，仓库里存在从"轻量提示"到"完整工具链"的三种典型形态：

┌─────────────────────────────────────────────────────────────┐ │ SKILL 的复杂度等级 │ ├─────────────────────────────────────────────────────────────┤ │ │ │ 简单 标准 复杂 │ │ ──────── ────────── ──────── │ │ │ │ • 1 个文件 • 1 个文件 • 多文件 │ │ • 100-200 词 • 300-800 词 • 800-2000 词│ │ • 基础结构 • 完整结构 • 含脚本 │ │ • 无附属文件 • 含示例 • 含示例 │ │ • 最佳实践 • 含模板 │ │ • 含文档 │ │ 例如: 例如: 例如: │ │ git-pushing brainstorming loki-mode │ │ │ └─────────────────────────────────────────────────────────────┘

仓库源码可以验证这三种形态确实存在：

• 简单型：skills/git-pushing/ 目录以单文件SKILL.md为主体（附少量脚本）；
• 标准型：skills/brainstorming/ 是一个 243 行、结构完整的单文件 Skill（Purpose / Operating Mode / Process 分层）；
• 复杂型：skills/loki-mode/ 是一个典型的多文件 Skill，包含 README、INSTALLATION、docs、examples、scripts、tests、benchmarks 等数十个子目录与文件，接近一个"嵌入式小型项目"。

选择哪种形态取决于你要封装的知识量：单一技巧用简单型，完整方法论用标准型，需要配套脚本与测试的复杂能力用复杂型。

十一、贡献的价值与学习路线

每一次贡献都在放大价值

你的贡献 │ ├─→ 改进文档 │ │ │ └─→ 让成千上万开发者更容易理解 │ ├─→ 创建新 Skill │ │ │ └─→ 为所有人带来新能力 │ ├─→ 修复 Bug / 拼写错误 │ │ │ └─→ 避免后来者误入歧途 │ └─→ 补充示例 │ └─→ 让新手学习更轻松

从新手到贡献者的推荐路线

从这里开始 │ ↓ ┌─────────────────┐ │ 读 GETTING_STARTED │ └────────┬────────┘ ↓ ┌─────────────────┐ │ 用 AI 助手试 2-3 个 Skill │ └────────┬────────┘ ↓ ┌─────────────────┐ │ 读 SKILL_ANATOMY │ └────────┬────────┘ ↓ ┌─────────────────┐ │ 研究现有 Skills │ └────────┬────────┘ ↓ ┌─────────────────┐ │ 创建简单 Skill │ └────────┬────────┘ ↓ ┌─────────────────┐ │ 读 CONTRIBUTING │ └────────┬────────┘ ↓ ┌─────────────────┐ │ 提交 PR │ └────────┬────────┘ ↓ 成为 CONTRIBUTOR！🎉

对应到仓库内的中文/越南语文档资源：GETTING_STARTED.vi.md 是入门首选（另有英文原版 docs/GETTING_STARTED.md），SKILL_ANATOMY.vi.md 提供机制层面的深入解析，CONTRIBUTING.md 说明贡献规范。发布前务必通过npm run validate校验，以保证 SKILL.md 的 frontmatter 与结构符合 skills-index.v1.schema.json 等规范。

十二、快速参考速查卡

┌─────────────────────────────────────────────────────────────┐ │ 快速参考 │ ├─────────────────────────────────────────────────────────────┤ │ │ │ 📥 安装 │ │ npx agentic-awesome-skills │ │ │ │ 🎯 使用 │ │ @skill名 [你的需求] │ │ │ │ 🔍 搜索 │ │ ls skills/ | grep "关键词" │ │ │ │ ✅ 校验 │ │ npm run validate │ │ │ │ 📝 创建 Skill │ │ 1. mkdir skills/你的-skill-名 │ │ 2. 创建带 frontmatter 的 SKILL.md │ │ 3. 添加正文内容 │ │ 4. 测试与校验 │ │ 5. 提交 Pull Request (PR) │ │ │ │ 🆘 帮助 │ │ • docs/GETTING_STARTED.md - 入门 │ │ • CONTRIBUTING.md - 贡献方式 │ │ • SKILL_ANATOMY.md - 深入理解 │ │ │ └─────────────────────────────────────────────────────────────┘

对应的仓库相对路径分别为：docs/GETTING_STARTED.md、CONTRIBUTING.md、docs/SKILL_ANATOMY.md（越南语版见 docs/vietnamese/ 目录）。

十三、下一步行动清单

1. ✅理解仓库的可视化结构：skills/（内容源）、tools/（工具链）、docs/（文档）三者职责分明；
2. ✅安装Skill 到你的 AI 工具：npx agentic-awesome-skills（或按需--skills+--dry-run组合）；
3. ✅试用不同分类下的 2～3 个 Skill（如brainstorming、stripe-integration）；
4. ✅阅读CONTRIBUTING.vi.md 了解贡献流程；
5. ✅创建你的第一个 Skill 并用npm run validate校验；
6. ✅分享给社区，让更多人受益。

【免费下载链接】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,115+ agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址: https://gitcode.com/gh_mirrors/an/agentic-awesome-skills