Agentic Awesome Skills 使用指南：从安装到熟练调用 2,000+ 技能的完整实战手册

AI 技能AI 插件人工智能【免费下载链接】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点击查看免费下载本文是面向普通用户的实操型指南。假设你已经完成了仓库安装本文将从下一步该做什么开始一步步教你理解捆绑包Bundles机制、掌握不同 AI 工具的skill调用语法、写出高质量的技能提示词并带你完成第一个真实技能调用最终具备独立规划、编排并安全使用整个技能库的能力。安装后第一件事理解技能在等待被调用很多人在安装完成后会感到困惑我已经安装了仓库接下来该做什么 答案是你已经拥有了全部技能文件但它们都在等待被你调用。你刚刚做了什么当你运行npx agentic-awesome-skills或克隆仓库时你实际上完成了三件事✅下载了 2,000 个技能文件到你的计算机。默认路径为~/.agents/skills/如果你使用了--path参数则落在自定义路径如~/.agent/skills/。✅使它们对你的 AI 助手可用。❌并未自动启用所有技能——它们只是静静地躺在那里等待使用。关于技能总数不同版本与文档口径略有差异原使用指南写作时提及 1,936 个技能而当前仓库的 package.json 中的描述为 2,126 agentic skillsdocs_zh-CN/users/bundles.md 末尾标注总技能数1,936、编辑捆绑包数59。可以把它理解为一个持续增长的技能库具体以你安装的仓库版本为准。把它想象成安装一个工具箱你现在拥有所有工具但你需要为每项工作选择使用哪些工具。技能不会自动运行只有当你在对话中显式点名skill-name时AI 才会读取对应的SKILL.md文件并按其中的操作手册执行。验证你的安装安装后可以用几种方式快速确认技能确实就位# 查看实际安装路径下的技能目录默认路径 ls ~/.agents/skills/ # 查看仓库内规范技能清单可用于发现技能 ls skills/ | head -20仓库根目录下的 skills_index.json 是技能的规范轻量级清单包含id、path、category、name、description、risk、source、date_added等元数据字段。例如brainstorming技能在清单中的条目是{ id: brainstorming, path: skills/brainstorming, category: uncategorized, 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 }id就是你在对话中mention时使用的标识符path则指向包含SKILL.md的目录。步骤 1理解捆绑包Bundles—— 这不是另一次安装常见困惑我需要分别下载每个技能吗答案不需要捆绑包不是另一层安装而是按角色分组的技能推荐清单。捆绑包是什么捆绑包是按角色组织的技能推荐列表帮助你决定从 2,000 个技能中优先开始使用哪些你安装的是一个包含全部技能的工具箱✅ 已完成。捆绑包就像贴有标签的整理托盘上面写着如果你是木匠从这 10 个工具开始。你通常从捆绑包中选择技能维护者也可以把它们用作插件子集或 Antigravity 激活预设。捆绑包不是什么❌ 可调用的单个超级技能❌ 与技能本身不同的内容格式❌ 大多数用户每天都必须单独管理的东西❌ 可调用的超级技能如essentials或/web-wizard注意docs_zh-CN/users/bundles.md中明确提示捆绑包不是可调用的大型技能……在对话中仍应调用包中列出的各个技能。 也就是说你调用的是包里的react-best-practices这样的具体技能而不是捆绑包本身。示例Web Wizard 捆绑包当你看到 Web Wizard 捆绑包 时它列出了frontend-designreact-best-practicestailwind-patterns等等这些是关于 Web 开发人员应该首先尝试哪些技能的推荐。它们已经安装了——你只需要在你的提示词中使用它们。使用激活脚本将捆绑包作为活动子集如果你希望一次只激活一个捆绑包例如在 Antigravity 中让~/.agents/skills/只保留该包内的技能请使用仓库提供的激活脚本而不是尝试直接调用捆绑包名称# macOS / Linux ./scripts/activate-skills.sh --clear Essentials ./scripts/activate-skills.sh --clear Web Wizard:: Windows .\scripts\activate-skills.bat --clear Essentials从 scripts/activate-skills.sh 的源码可以看到其工作方式--clear参数会触发[RESET]流程将现有~/.agents/skills/下内容归档到skills_archive_时间戳目录再从skills_library中恢复所选技能不带--clear则是在现有文件夹上**叠加APPEND**新技能。脚本默认展开Essentials捆绑包无参数时其回退清单为concise-planning、git-pushing、kaizen、lint-and-validate、systematic-debugging。展开捆绑包依赖tools/scripts/get-bundle-skills.py你可以通过AG_BASE_DIR、AG_SKILLS_DIR、AG_LIBRARY_DIR、AG_REPO_SKILLS_DIR等环境变量覆盖默认目录。脚本对传入的 skill id 做了安全校验is_safe_skill_id只允许A-Za-z0-9._-与/组成的路径并拒绝.、..、/.对目录符号链接也做了越界检查避免把源目录外的内容拷入。步骤 2如何实际执行 / 使用技能这是整个使用过程中最需要讲清楚的部分只需在与 AI 助手的对话中提及技能名称AI 便会加载对应技能并按其指引执行。确切的语法因工具而异但总是很简单工具语法示例使用场景Claude Code (CLI) Use brainstorming to help me design a todo app终端 / CLI 工作流Cursor (IDE)brainstorming help me design a todo appIDE 聊天面板Gemini CLIUse the brainstorming skill to help me plan my app与 Gemini 的自然对话Codex CLIApply brainstorming to design a new feature与 Codex 的自然对话Antigravity IDEUse brainstorming to plan this feature代理模式专业提示大多数现代工具使用skill-name语法。如有疑问先试试这个Gemini CLI 特别提示如果 Gemini CLI 在几轮对话后开始挂起请尝试新开一个对话并暂时将活动集减少到只有 2-5 个技能以排除上下文增长的问题。安装时也可以针对具体工具指定安装方式。根据 docs_zh-CN/users/getting-started.mdnpx agentic-awesome-skills支持--cursor、--claude、--gemini、--codex、--kiro、--antigravity、--agy等参数为特定工具安装并用--path dir指定自定义位置--risk、--category、--tags可缩小安装范围。若技能未被识别也可尝试显式路径npx agentic-awesome-skills --claude或--cursor、--gemini等。步骤 3我的提示词应该是什么样的技能的使用效果高度依赖提示词质量。以下是真实示例的良好提示词示例 1开始一个新项目糟糕的提示词Help me build a todo app良好的提示词Use brainstorming to help me design a todo app with user authentication and cloud sync为什么更好你明确调用了技能并提供了上下文。示例 2审查代码糟糕的提示词Check my code良好的提示词Use lint-and-validate to checksrc/components/Button.tsxfor issues为什么更好特定技能 特定文件 精确结果。示例 3安全审计糟糕的提示词Make my API secure良好的提示词Use api-security-best-practices to review my REST endpoints inroutes/api/users.js为什么更好AI 知道确切要应用哪个技能的标准。示例 4组合多个技能良好的提示词Use brainstorming to design a payment flow, then apply stripe-integration to implement it为什么好你可以在单个提示词中链接技能步骤 4你的第一个技能动手教程让我们现在实际使用一个技能目标是规划一个新功能选择一个技能使用brainstorming来自 Essentials 捆绑包。打开你的 AI 助手Claude Code、Cursor 等。输入这个确切的提示词Use brainstorming to help me design a user profile page for my app按 Enter 键。接下来会发生什么AI 加载brainstorming技能它将开始向你提出结构化问题一次一个它将引导你完成理解、需求和设计你回答每个问题它构建完整的规范结果你最终会得到一个详细的设计文档——还没有写一行代码如果你想了解这个技能背后发生了什么可以直接阅读技能本体 skills/brainstorming/SKILL.md。它的前置元数据声明了risk: critical即会引导 AI 进入工作状态、产出设计文档的技能正文则定义了完整的运行模式技能激活期间不允许实现、编码或修改行为AI 以设计促进者与资深评审者身份工作第一步强制理解当前上下文然后一次一个问题地澄清想法最后产出经过验证的设计规格。这正是你在对话中看到结构化提问的来源。步骤 5选择你的前几个技能实用建议不要试图一次使用所有技能。这里有一个明智的分层策略0. 需要工具特定起点时如果在选择技能之前你需要特定于工具的起点请使用Claude Code 技能Cursor 技能Codex CLI 技能Gemini CLI 技能1. 从 Essentials 开始5 个技能每个人都需要brainstorming- 在构建之前规划lint-and-validate- 保持代码整洁git-pushing- 安全地保存工作systematic-debugging- 更快地修复错误concise-planning- 组织任务如何使用它们在编写新代码之前 →brainstorming编写代码之后 →lint-and-validate在提交之前 →git-pushing当卡住时 →systematic-debugging2. 然后添加特定于角色的技能再添加 5-10 个在 bundles.md 中找到你的角色并从该捆绑包中选择 5-10 个技能。Web 开发人员示例frontend-designreact-best-practicestailwind-patternsseo-audit安全工程师示例api-security-best-practicesvulnerability-scannerethical-hacking-methodology3. 最后按需添加即时技能将 CATALOG.md 保持打开作为参考。当你需要特定的东西时我需要集成 Stripe 付款 → 搜索目录 → 找到stripe-integration→ 使用它完整示例端到端构建功能让我们通过一个现实场景把前面的知识串起来——任务为我的 Next.js 网站添加博客。步骤 1规划使用 brainstormingYou: Use brainstorming to design a blog system for my Next.js site AI: [询问关于需求的结构化问题] You: [回答问题] AI: [生成详细的设计规范]步骤 2实现使用 nextjs-best-practicesYou: Use nextjs-best-practices to scaffold the blog with App Router AI: [创建文件结构设置路由添加组件]步骤 3样式使用 tailwind-patternsYou: Use tailwind-patterns to make the blog posts look modern AI: [应用 Tailwind 样式和响应式设计]步骤 4SEO使用 seo-auditYou: Use seo-audit to optimize the blog for search engines AI: [添加 meta 标签、站点地图、结构化数据]步骤 5测试和部署You: Use test-driven-development to add tests, then vercel-deployment to deploy AI: [创建测试设置 CI/CD部署到 Vercel]结果使用最佳实践构建的专业博客无需手动研究每个步骤这正是工作流的价值所在——workflows.md 中定义了一整套可执行的端到端剧本如发布 SaaS MVPWeb 应用安全审计构建 AI 代理系统将多个技能按顺序编排成一个完整流程。如果你希望以流程而不是单点技能的方式推进任务可以从工作流开始。技能发现与上下文安全为什么不要一次加载所有技能一个非常常见的问题我可以一次将所有技能加载到模型中吗不可以。即使你本地安装了全部技能你不应该将每个SKILL.md连接到单个系统提示词或上下文块中。2,000 个技能文档会迅速填满模型的上下文窗口导致截断甚至崩溃在 Jetski/Cortex Gemini 这类宿主上会表现为TrajectoryChatConverter: could not convert a single message before hitting truncation。预期的设计模式是使用根目录 skills_index.json规范清单来发现存在哪些技能——它只含元数据体积轻量仅在宿主必须读取data/子树时使用 data/skills_index.json 兼容性镜像仅为你实际在对话中使用的特定skill-id值加载对应的SKILL.md文件延迟加载。如果你正在构建自己的宿主 / 代理例如 Jetski/Cortex Geminidocs_zh-CN/integrations/jetski-cortex.md 提供了完整的集成伪代码与安全约束核心要点包括轻量级清单启动时读取skills_index.json构建id - meta映射不加载全文。消息解析用正则/([a-zA-Z0-9-_./])/g从用户 / 系统消息中提取所有skill-id引用。延迟加载仅针对解析出的 id 读取SKILL.mdfullPath path.join(SKILLS_ROOT, meta.path, SKILL.md)并设置maxSkillsPerTurn上限建议每轮 5-10 个。溢出策略设置上下文窗口 70-80% 的安全阈值超限时减少技能数量或通过overflowBehavior: error明确报错而不是静默截断。路径安全读取前验证解析出的路径始终位于SKILLS_ROOT之内。常见问题我应该使用哪个工具Claude Code、Cursor、Gemini任何一个都可以技能通用适用。选择你已经使用或喜欢的工具Claude Code- 最适合终端 / CLI 工作流Cursor- 最适合 IDE 集成Gemini CLI- 最适合 Google 生态系统Codex CLI- 最适合 OpenAI 生态系统我可以查看所有可用的技能吗可以三种方式浏览 CATALOG.md可搜索列表运行ls ~/.agents/skills/或你的实际安装路径询问你的 AI你有哪些关于[主题]的技能安装后我需要重启 IDE 吗通常不需要但如果你的 AI 无法识别技能尝试重启你的 IDE / CLI检查安装路径是否与你的工具匹配尝试显式路径npx agentic-awesome-skills --claude或--cursor、--gemini等技能和 MCP 工具有什么区别技能是可复用的SKILL.md剧本用于指导 AI 助手完成工作流。MCP 工具是集成或可调用功能让助手能够与外部系统交互。当你想要更好的流程、结构和执行质量时使用技能当你需要访问 API、服务、数据库或其他系统时使用 MCP 工具。详细对比可阅读 skills-vs-mcp-tools.md。我可以创建自己的技能吗可以使用skill-creator技能Use skill-creator to help me build a custom skill for [your task]如果技能没有按预期工作怎么办直接在安装路径中检查技能的SKILL.md文件例如~/.agents/skills/[skill-name]/SKILL.md阅读描述以确保你正确使用它在本仓库的 Issues 页面提交问题并提供详细信息技能名、使用工具、复现步骤这些技能如何避免溢出模型上下文一些主机工具例如基于 Jetski/Cortex Gemini 构建的自定义代理可能想将每个SKILL.md连接到单个系统提示词中这不是设计的使用方式几乎肯定会溢出上下文窗口。正确做法是使用根目录 skills_index.json 作为规范轻量级清单进行发现仅在调用技能时例如通过对话中的skill-id加载单个SKILL.md文件。详见 docs_zh-CN/integrations/jetski-cortex.md。这些技能有风险吗每个SKILL.md的前置元数据中都包含risk:字段用于标注风险等级⚪unknown遗留或未分类内容使用前需手动检查none纯参考或规划内容——无 shell 命令、无变更、无网络访问safe非破坏性指导如只读命令、规划、代码审查和分析critical会修改文件、删除数据或执行破坏性操作的技能谨慎使用offensive渗透测试等进攻性技术仅限授权使用必须确认目标在范围内快速参考卡保存此内容以供快速查找任务使用的技能示例提示词规划新功能brainstormingUse brainstorming to design a login system审查代码lint-and-validateUse lint-and-validate on src/app.js调试问题systematic-debuggingUse systematic-debugging to fix login error安全审计api-security-best-practicesUse api-security-best-practices on my API routesSEO 检查seo-auditUse seo-audit on my landing pageReact 组件react-patternsUse react-patterns to build a form component部署应用vercel-deploymentUse vercel-deployment to ship this to production下一步既然你了解了如何使用技能✅现在就尝试一个技能- 从brainstorming开始尝试任何想法从你的角色捆绑包中选择 3-5 个技能来自 bundles.md将CATALOG.md加入书签当你需要特定东西时使用从workflows.md尝试一个工作流以获得完整的端到端流程最大化效果的专业提示提示 1使用 brainstorming 开始每个功能在编写代码之前使用brainstorming进行规划。你将节省数小时的重构时间。提示 2按顺序链接技能不要试图一次完成所有事情。按顺序使用技能规划 → 构建 → 测试 → 部署提示 3在提示词中具体化糟糕Use react-patterns 良好Use react-patterns to build a modal component with animations提示 4引用文件路径帮助 AI 专注Use security-auditor on routes/api/auth.js提示 5组合技能以完成复杂任务Use brainstorming to design, then test-driven-development to implement with tests提示 6把技能清单当作路由表而不是全量内存让 AI 用 skills_index.json 或 CATALOG.md 做技能发现按需加载对应SKILL.md——这是让 2,000 技能与有限上下文窗口共存的关键。仍然困惑如果有些东西仍然不合理查看 FAQ查看 真实示例在本仓库发起 Discussion 或 Issues帮助我们改进此指南记住你并不孤单这个项目的全部意义是让 AI 助手更易于使用。如果本指南没有帮助请告诉我们以便我们修复它。赞分享AI 技能AI 插件人工智能【免费下载链接】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 使用指南从安装到实战正确调用 2,000 个 Agentic 技能Agentic Awesome Skills 使用指南从安装到实战正确调用 2,000 个 Agentic 技能 本指南承接 docs_zh CN/useAI 技能AI 插件人工智能AAS Core 与 Agentic Awesome Skills 入门指南从代理选栈到技能安装与使用AAS Core 与 Agentic Awesome Skills 入门指南从代理选栈到技能安装与使用 本文是 Agentic Awesome SkillsAI 技能AI 插件人工智能Agent Skills 通用 AI 技能库从安装使用到自建技能的完整实战指南Agent Skills 通用 AI 技能库从安装使用到自建技能的完整实战指南 让 AI 快速学会新技能 在前面的文章中我们已经学习了如何用 AI 生成代码人工智能教程知识库文档上一篇Decepticon CVE-APT 映射参考指南从主动利用漏洞到威胁组织与攻击技能落地下一篇x64dbg 硬件断点命中计数重置指南ResetHardwareBreakpointHitCount 命令深度解析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考