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,445 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址https://gitcode.com/gh_mirrors/an/agentic-awesome-skills点击查看免费下载本篇文章围绕 Agentic Awesome SkillsAAS官方中文常见问题解答展开系统梳理技能到底是什么、如何安装与调用、风险标签如何解读、遇到上下文溢出或截断如何恢复、PR 如何通过质量检查等高频疑问并结合仓库内的skills_index.json清单、scripts/activate-skills.sh激活脚本与具体SKILL.md前置元数据给出源码级佐证。读完本文你将能独立完成从安装、选包、调用、排障到贡献技能的完整闭环。一、一般问题先搞清楚技能的基本概念1.1 技能究竟是什么在 Agentic Awesome Skills 中技能Skill是专门的指令文件用于教 AI 助手如何处理特定任务。你可以把它们想象成 AI 可以按需加载的专业知识模块。一个最简单的类比就像你遇到法律问题会咨询律师、身体不适会找医生、车坏了会找机械师一样这些技能让你的 AI 在需要时成为不同领域的专家——写代码时调用编程技能做安全审计时调用渗透测试技能做设计时调用 UI 技能。每个技能在仓库中都是一个独立目录核心文件是SKILL.md。以 brainstorming 技能 为例其文件开头使用 YAML 前置元数据声明了技能的name、description、risk、source、date_added等字段正文则详细规定 AI 在激活该技能后应遵循的工作流程先理解、再确认、后设计、禁止直接实现。这份文件就是技能在磁盘上的真实形态——它本质上是纯文本由 AI 运行时解析并执行。1.2 我需要安装每个技能吗不需要。当你克隆仓库或通过npx agentic-awesome-skills安装时全部技能文件就已经在你的计算机上了但你的 AI仅在你显式调用它们时才加载。这就像一个图书馆——所有书籍都在书架上但你只需要在阅读时抽出需要的那一本。仓库根目录的skills_index.json就是这座图书馆的目录检索系统也是规范轻量级清单供各主机工具做技能发现而data/skills_index.json仅是兼容性镜像只有在宿主必须读取data/子树时才使用。专业提示建议从 入门包 开始先专注于与你的角色匹配的技能而不是一次性探索全部 2,000 个技能。1.3 捆绑包Bundle和工作流Workflow有什么区别这是最容易被混淆的两个概念两者的定位完全不同概念本质用途捆绑包按角色或领域分类的精选推荐清单帮你决定应该包含哪些技能工作流面向具体结果的有序执行剧本帮你决定如何逐步执行一个目标当你纠结于我该装哪些技能时使用捆绑包当你明确知道我要完成某个任务时使用工作流。查看全部捆绑包bundles.md查看全部工作流workflows.md从仓库实现来看两者也是完全不同的数据形态编辑推荐的捆绑包由 bundles.md 人工维护而生成式的目录/工作流分组则沉淀在 data/bundles.json 与 data/workflows.json 中它们面向更广泛的自动化消费场景。1.4 技能和 MCP 工具有什么区别技能是可复用的SKILL.md剧本用来指导 AI 助手完成工作流——它改变的是 AI 的思考与执行方式。MCP 工具是集成或可调用的功能让助手能够与外部系统交互——它提供的是访问 API、服务、数据库的能力。简单判断标准想要更好的流程、结构和执行质量 → 用技能需要访问外部系统 → 用 MCP 工具两者可以同时使用实现可靠的工作流 外部功能的组合。更长的解释请阅读 skills-vs-mcp-tools.md。1.5 哪些 AI 工具可以使用这些技能技能采用通用的SKILL.md格式因此兼容性很广✅Claude CodeAnthropic CLI✅Gemini CLIGoogle✅Codex CLIOpenAI✅CursorAI IDE✅Antigravity IDE✅OpenCode✅Kiro CLIAmazon✅Kiro IDEAmazon✅AdaL CLI⚠️GitHub Copilot通过复制粘贴部分支持各工具的具体接入方式可参考 usage.md 中的分工具语法说明。1.6 这些技能可以免费使用吗可以。仓库采用双重许可原始代码和工具MIT 许可见 LICENSE原始文档/非代码书面内容CC BY 4.0 许可见 LICENSE-CONTENT因此你可以✅ 免费供个人使用✅ 免费供商业使用✅ 修改它们第三方许可与来源归属细节见 sources/sources.md。1.7 这些技能如何避免溢出模型上下文这是本仓库设计中一个非常关键的原则。某些主机工具例如基于 Jetski/Cortex Gemini 构建的自定义代理可能会试图把每个SKILL.md文件都拼接到单个系统提示词中——这不是本仓库的设计用法如果真把整个仓库拼进一个提示词几乎必然溢出上下文窗口。正确的宿主接入模式是使用根目录skills_index.json作为规范轻量级清单进行发现data/skills_index.json仅作为兼容性镜像仅在调用技能时例如对话中出现skill-id才加载单个SKILL.md文件。具体示例含伪代码见 integrations/jetski-cortex.md。1.8 技能可以离线工作吗技能文件本身存储在本地计算机上但你的 AI 助手需要互联网连接才能运行。也就是说技能离线和AI 在线是两回事——离线仓库只是让你拥有完整的技能库备份。二、安全与信任先看清你在运行什么2.1 风险标签risk label是什么意思仓库对每个技能都进行了风险分类以便你清楚知道正在运行什么。这些值直接映射到每个SKILL.md前置元数据中的risk:字段可在 skills_index.json 清单中查看共五档标签颜色含义使用建议unknown⚪遗留或未分类内容使用前手动检查技能none纯参考或规划内容无 shell 命令、无变更、无网络访问可放心使用safe非破坏性指导如只读命令、规划、代码审查和分析常规使用critical会修改文件、删除数据、使用网络扫描器或执行破坏性操作谨慎使用offensive聚焦安全的进攻技术渗透测试、利用仅授权使用务必确认目标在范围内以仓库中的实际技能为例brainstorming 技能 的元数据为risk: critical——因为它在激活期间严格禁止 AI 实现或修改代码属于高风险边界约束型技能而大量纯参考类技能如架构评审类则标记为safe。在 skills_index.json 中每个技能条目都带有一个risk字段你可以直接检索确认。2.2 这些技能可以入侵我的计算机吗不可以。技能是文本文件。但是——它们会指示AI 运行命令。如果某个技能写着删除所有文件一个顺从的 AI 可能会真的尝试这样做。因此核心安全守则是始终检查风险标签审查技能内容后再使用尤其是来自社区、标记为critical或offensive的技能。三、安装与设置把技能放到正确的位置3.1 我应该在哪里安装技能这取决于你的安装方式仓库提供三条路径使用安装程序 CLInpx agentic-awesome-skills默认安装目标是 Antigravity 全局库的~/.agents/skills/。使用特定于工具的标志通过--claude、--cursor、--gemini、--codex、--kiro或--antigravity自动定位匹配的工具路径。使用手动克隆或自定义工作区路径.agent/skills/是 Antigravity/自定义设置下的通用工作区约定。如果从 npm 拉取时收到 404可改用 GitHub 直接安装方式。使用 git clonegit clone 仓库地址 .agent/skills特定于工具的路径工具推荐路径Claude Code.claude/skills/Gemini CLI.gemini/skills/Codex CLI.codex/skills/Cursor.cursor/skills/或项目根目录Claude Code 插件市场替代方案/plugin marketplace add sickn33/agentic-awesome-skills /plugin install agentic-awesome-skills仓库本身包含.claude-plugin/marketplace.json与.claude-plugin/plugin.json因此 Claude Code 可以通过插件市场安装同一套技能树对应目录位于 plugins/agentic-awesome-skills 与 plugins/agentic-awesome-skills-claude。3.2 这可以在 Windows 上使用吗可以。使用与其他平台相同的标准安装流程npx agentic-awesome-skills如果在旧的符号链接解决方法上创建了旧克隆请重新安装到新目录或重新运行npx agentic-awesome-skills。仓库同时提供了 Windows 批处理激活脚本 scripts/activate-skills.bat。3.3 我在 Windows 上遇到截断或上下文崩溃循环如何恢复如果 Antigravity 或基于 Jetski/Cortex 的主机不断重新打开到类似下面的报错TrajectoryChatConverter: could not convert a single message before hitting truncation请使用专用的 Windows 恢复指南windows-truncation-recovery.md。该指南包含针对损坏的本地存储/会话存储/IndexedDB 状态的手动清理步骤首先要备份的默认 Antigravity Windows 路径可选批处理脚本改编自社区 issue #274 的讨论。3.4 我在 Linux 或 macOS 上遇到上下文过载该怎么办如果 Antigravity 仅在激活完整技能库时变得不稳定请切换到按需激活流程而不是一次暴露每个技能。参考 agent-overload-recovery.md。该指南展示了如何从本仓库的克隆副本运行 scripts/activate-skills.sh让只有你需要的捆绑包或技能 ID 在~/.agents/skills中保持活动状态。查看该脚本源码可以看到其核心机制将仓库skills/树同步到~/.agents/skills_library完整库归档仅将请求的捆绑包或技能 ID 激活到~/.agents/skills实时目录--clear会先将当前活动目录归档到带时间戳的skills_archive_*再恢复选定集合支持环境变量覆盖AG_BASE_DIR、AG_SKILLS_DIR、AG_LIBRARY_DIR、AG_REPO_SKILLS_DIR等捆绑包展开依赖tools/scripts/get-bundle-skills.py辅助脚本无参数时默认激活Essentials捆绑包的 5 个核心技能。典型用法./scripts/activate-skills.sh Web Wizard Integration APIs ./scripts/activate-skills.sh --clear ./scripts/activate-skills.sh brainstorming systematic-debugging自定义基础目录AG_BASE_DIR/custom/antigravity ./scripts/activate-skills.sh --clear Essentials AG_REPO_SKILLS_DIR/path/to/repo/skills ./scripts/activate-skills.sh brainstorming3.5 Gemini CLI 在几轮之后挂起或提示 This is taking a bit longer, were still on it该怎么办首先做快速隔离检查按顺序执行开始一个全新的 Gemini CLI 对话尝试一个完全没有技能的提示词仅使用一个小技能例如brainstorming再次尝试同样的任务临时将活动技能集减少到 2–5 个技能并重试。如何解释结果如果即使没有技能普通 Gemini CLI 也挂起问题可能出在 Gemini CLI/运行时层面与本仓库无关如果普通 Gemini 工作正常但只要存在技能或在几轮对话后就挂起则可能原因是对话/上下文增长。对应的处理策略保持更小的活动技能集更频繁地开启新对话使用过载指南 agent-overload-recovery.md。3.6 如何更新技能导航到你的技能目录并拉取最新更改cd .agent/skills git pull origin main也可以使用仓库维护者侧的npm run update:skills即generate_index.py 拷贝skills_index.json到 web-app public 目录保持索引与技能树同步——该命令会重建根目录索引清单并同步到 apps/web-app/public/skills.json。四、使用技能在对话中真正用起来 有关包含完整示例的调用指南请参阅 usage.md4.1 如何调用技能使用符号后跟技能名称skill-idbrainstorming help me design a todo app各工具语法略有差异详见 usage.mdClaude CodeCLI Use brainstorming to help me design a todo appCursorIDE在聊天面板输入brainstorming help me design a todo appGemini CLIUse the brainstorming skill to help me plan my appCodex CLIApply brainstorming to design a new featureAntigravity IDE代理模式Use brainstorming to plan this feature专业提示大多数现代工具统一使用skill-name语法拿不准时先试它。4.2 我可以调用整个捆绑包如Essentials或/web-wizard吗不可以。捆绑包是技能的精选列表不是独立的可调用超级技能。正确用法有两种从捆绑包中选择单个技能并直接调用它们如果只想在 Antigravity 中激活该捆绑包的技能使用激活脚本./scripts/activate-skills.sh --clear Essentials ./scripts/activate-skills.sh --clear Web Wizard这一点在脚本源码中也有印证脚本会把捆绑包名称交给get-bundle-skills.py展开成具体技能 ID 列表再逐一恢复到活动目录——它永远不会创建一个名为Web Wizard的超级技能文件。4.3 我可以一次使用多个技能吗可以你可以在一条提示词中链接多个技能让它们按顺序协作brainstorming help me design this, then use writing-plans to create a task list.4.4 我如何知道该用哪个技能三步法浏览目录查看 技能目录可搜索的完整列表命令行搜索ls skills/ | grep keyword直接问 AI你有哪些关于测试的技能五、故障排除常见问题与应对5.1 我的 AI 助手无法识别技能按可能性排查三个原因错误的安装路径检查你的工具文档尝试.agent/skills/需要重启安装技能后重启你的 AI/IDE拼写错误你是否输入了brain-storming而不是brainstorming技能 ID 与目录名严格对应见 skills_index.json5.2 技能给出了不正确或过时的建议请提交 issue 反馈并在报告中包含哪个技能skill-id出了什么问题实际行为应该发生什么预期行为。六、贡献把好技能带回社区6.1 我是开源新手可以贡献吗当然可以社区欢迎初学者可以从低门槛任务开始修复拼写错误添加示例改进文档。贡献流程详见 CONTRIBUTING.md。6.2 我的 PR 未通过质量标准检查为什么仓库强制执行自动质量控制对应npm run validate内部调用tools/scripts/validate_skills.py。技能可能缺少有效的description字段清晰的使用指导或示例PR 主体中的预期 PR 模板检查清单。在推送前本地运行npm run validate并确保使用默认模板打开 PR以包含质量标准检查清单。6.3 我的 PR 未通过安全文档检查该怎么办在本地运行安全文档门并处理发现的问题npm run security:docs常见修复用更安全的替代方案替换有风险的示例如curl ... | bash、wget ... | sh、irm ... | iex这类管道执行模式删除或修改类似令牌的命令行示例对于故意的高风险指导通过以下注释添加明确理由!-- security-allowlist: reason and scope --6.4 我的 PR 触发了skill-review自动检查它是什么从 v8.0.0 开始GitHub 会自动在任何添加或修改SKILL.md文件的 PR上运行skill-review工作流。它根据质量标准审查技能标记常见问题——缺少章节、触发器过弱或存在风险的命令模式。如果它报告了发现在 PR 上打开检查Checks选项卡阅读skill-review作业输出解决任何可操作的发现缺少何时使用、触发器不清晰、被阻止的安全模式将新提交推送到同一分支——检查会自动重新运行。你不需要关闭并重新打开 PR。纯信息性或仅涉及风格的发现不会阻止合并。6.5 社区 PR 需要生成的文件如CATALOG.md或skills_index.json吗不需要。社区 PR 应保持仅源代码不要包含以下生成式注册表工件CATALOG.mdskills_index.jsondata/*.json维护者在合并后会于main分支上重新生成并规范化这些文件对应npm run chain链validate → plugin-compat → index → bundles → catalog 等。如果你改动了文档、工作流或基础设施请改为在本地运行npm run validate:references npm test6.6 我可以更新官方技能吗先检查skills/skill-id/SKILL.md中的来源元数据source字段和该目录的说明。注意供应商来源并不意味着存在统一的skills/official/目录请保持来源与许可证不变需要上游同步时先提交 issue。七、专业提示把技能用得更好在构建任何新内容之前使用brainstorming——它会强制 AI 先理解、再确认、后设计完整流程见 brainstorming 技能 中的Understanding Lock硬门禁与决策日志要求在遇到错误时使用systematic-debugging尝试test-driven-development以获得更好的代码质量探索skill-creator制作你自己的技能保持活动技能集精简2–5 个需要时再扩展避免上下文膨胀。如果仍有疑问可参考 usage.md 中的快速参考卡任务 → 技能 → 示例提示词对照表或在仓库讨论区发起讨论社区会协助解答。赞分享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,445 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址https://gitcode.com/gh_mirrors/an/agentic-awesome-skills点击查看免费下载相关推荐agentic-awesome-skills 安全技能全景128 个 Security Skill 的检索、编排与实战指南agentic awesome skills 安全技能全景128 个 Security Skill 的检索、编排与实战指南 导读 agentic awesomAI 技能AI 插件Agentic Awesome Skills 安全技能全景128 项安全技能的构成、选型与实战应用指南Agentic Awesome Skills 安全技能全景128 项安全技能的构成、选型与实战应用指南 本文以 Agentic Awesome SkillsAI 技能AI 插件Agentic Awesome Skills 上手指南可安装 Agentic Skills 库的安装、工具选型与 Workflows 实战Agentic Awesome Skills 上手指南可安装 Agentic Skills 库的安装、工具选型与 Workflows 实战 本文基于仓库中 dAI 技能AI 插件创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考