Agentic Awesome Skills 上手指南可安装 Agentic Skills 库的安装、工具选型与 Workflows 实战【免费下载链接】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本文基于仓库中docs/maintainers/backups/README-2026-06-02.md这一份历史快照对应 V11.11.0 时代的 README当时收录 1,494 个 skills系统讲解 Agentic Awesome Skills曾用名 Antigravity Awesome Skills作为可安装技能库的核心用法一条 npx 命令完成全库安装、按宿主工具选择正确的安装路径与调用语法、借助 Bundles 与 Workflows 组织起可执行的技能编排以及面向自定义集成方的 Stable Skills Manifest v1 契约。读完本文你将掌握从发现仓库到跑通第一个技能再到接入自有宿主的完整链路并能把当前仓库中的 skills/、data/、skills_index.json 等真实资源用于日常开发。一、这是一份什么样的文档docs/maintainers/backups/README-2026-06-02.md是仓库在某次发布周期V11.11.0生成的 README 归档快照文件头部的 registry-sync 注释记录了当时的同步状态version11.11.0; skills1494; stars39451。也就是说这份文档描述的是项目可安装技能库时代的完整产品形态而非当前仓库的全部。对照当前仓库根目录的 README.md 与 package.json 可以看到项目的演进npm 包名已由快照中的antigravity-awesome-skills变为agentic-awesome-skills版本 17.3.0技能规模由 1,494 增长到 2,124并新增了 AAS Core本地 Agent 优先控制平面提供只读 MCP 工具search_skills、get_skill、compose_stack等。本文以历史快照为骨架讲解其中仍然成立且可复用的安装与使用知识并在相关小节补充当前仓库的对应实现证据。二、核心概念Installable而不是 Inspirational快照文档开篇即点明项目定位这不是一份仅供参考的提示词合集而是一个可安装的 GitHub 技能库——用 npm 安装器把可复用的SKILL.mdplaybook 分发到各个 AI 编码助手期望的目录中。该设计针对的问题是一次性收集的 prompt 片段难以复用而结构化操作指令SKILL.md可以沉淀为可搜索、可安装、带约束的目录。仓库交付的不只是 skills还包括技能库本体位于 skills/每个技能一个目录核心文件是SKILL.md安装器 CLI由 package.json 中的 bin 声明指向tools/bin/install.js生成式目录与元数据根目录 CATALOG.md、skills_index.json以及 data/ 下的各类 JSON角色化 Bundles 与执行型 Workflows分别对应 docs/users/bundles.md 与 docs/users/workflows.md面向 Claude Code / Codex 的插件发行面见 docs/users/plugins.md。快照文档给出的Why This Repo理由可以概括为五点可安装而非仅供阅读、为主流 Agent 工作流设计Claude Code、Cursor、Codex CLI、Gemini CLI、Antigravity、Kiro、OpenCode、Copilot 等、覆盖面广且有实际效用、Bundles/Workflows 缩短上手路径、同时满足广度与策展两种需求。三、安装与验证一条命令装下整个技能库快照文档把安装分成了四个动作安装、验证、首次使用、按需切换发行方式。3.1 全库安装# 默认安装到 ~/.agents/skillsAntigravity 2.0 全局目录可用 --path 指定其他位置 npx antigravity-awesome-skills # Antigravity CLI 斜杠命令agy安装到 ~/.gemini/antigravity-cli/skills/skill/SKILL.md npx antigravity-awesome-skills --agy当前仓库的对应关系快照中 npm 包名为antigravity-awesome-skills当前 package.json 中的包名为agentic-awesome-skills并暴露了三个 binagentic-awesome-skills指向tools/bin/install.js、aas指向tools/bin/aas.js、aas-mcp指向tools/bin/aas-mcp.js。在最新版本中使用npx agentic-awesome-skills等价于快照时代的全库安装。安装器默认使用浅克隆且锁定发布版本shallow, release-pinned clone因此首次安装比完整克隆仓库历史更轻量同时与已发布的 npm 包版本保持一致。只有当你有意获取仓库最新提交tip时才使用--tag main。3.2 验证安装test -d ~/.agents/skills echo Skills installed in ~/.agents/skills该命令检查技能目录是否存在若输出提示文本说明安装位置正确。3.3 跑通第一个技能Use brainstorming to plan a SaaS MVP.快照以brainstorming为例——该技能在仓库中的真实实现位于 skills/brainstorming/SKILL.md其 frontmatter 声明了description: Use before creative or constructive work...、risk: critical、source: community正文要求以设计 facilitator 的角色将模糊想法转化为经过验证的设计且在技能激活期间不得动手实现——这正好演示了SKILL.md可搜索、可安装、带约束的价值。3.4 全库安装 vs 插件发行需要最全目录 直接掌控技能目录时用全库安装需要marketplace 风格的插件安全发行面向 Claude Code / Codex时走插件路线详细对比见 docs/users/plugins.md。四、按工具选型同一仓库不同安装方式与调用语法快照文档提供了一张核心表格——同一个技能库不同宿主工具有各自的安装目标目录和首用调用语法工具安装方式首次使用Claude Codenpx antigravity-awesome-skills --claude或 Claude 插件市场 /brainstorming help me plan a featureCursornpx antigravity-awesome-skills --cursorbrainstorming help me plan a featureGemini CLInpx antigravity-awesome-skills --geminiUse brainstorming to plan a featureCodex CLInpx antigravity-awesome-skills --codexUse brainstorming to plan a featureAntigravity IDEnpx antigravity-awesome-skills --antigravityUse brainstorming to plan a featureAntigravity CLIagynpx antigravity-awesome-skills --agy/brainstorming help me plan a featureKiro CLInpx antigravity-awesome-skills --kiroUse brainstorming to plan a featureKiro IDEnpx antigravity-awesome-skills --path ~/.kiro/skillsUse brainstorming to plan a featureGitHub Copilot无安装器——手动粘贴 skills 或规则Ask Copilot to use brainstorming to plan a featureOpenCodenpx antigravity-awesome-skills --path .agents/skills --category development,backend --risk safe,noneopencode run brainstorming help me plan a featureAdaL CLInpx antigravity-awesome-skills --path .adal/skillsUse brainstorming to plan a feature自定义路径npx antigravity-awesome-skills --path ./my-skills取决于你的工具这张表揭示了安装器的一个关键设计通过--tool级 flag 定向写入已知的技能目录通过--path应对未收录的宿主通过--category/--risk/--tags做精简安装见下节。各宿主的路径细节、提示词示例与配置注意事项可继续查阅docs/users/claude-code-skills.mddocs/users/cursor-skills.mddocs/users/codex-cli-skills.mddocs/users/gemini-cli-skills.mddocs/users/ai-agent-skills.md五、快速 FAQ它是什么面向 Claude Code、Cursor、Codex CLI、Gemini CLI、Antigravity 等 AI 编码助手的可安装SKILL.mdplaybook 库打包了安装器 CLI、Bundles、Workflows、生成的目录与文档。怎么装默认npx antigravity-awesome-skills执行全库安装需要定向安装时使用--codex、--cursor、--gemini、--claude、--antigravity等 flag。全库还是插件想要最大目录与文件系统直接控制用全库想要 Claude Code / Codex 的 marketplace 风格安全发行用插件完整说明见 docs/users/plugins.md。去哪里浏览 Bundles、Workflows 与完整目录角色化推荐看 docs/users/bundles.md按顺序执行的 playbook 看 docs/users/workflows.md完整注册表看 CATALOG.md。六、按工具的最佳技能推荐与真实提示词快照强调与其浏览全部 1,494 技能不如先看按工具整理的指南各指南分别覆盖安装路径、入门技能、提示词示例Claude Code / Cursor / Codex CLI / Gemini CLI 各有专页见第四节链接。6.1 通用入门技能Universal starter skills快照给出了一组跨工具通用的起点技能在仓库中均有真实实现可点击查看各自SKILL.mdskills/brainstorming/SKILL.md——实现前先做规划skills/test-driven-development/SKILL.md——TDD 导向的开发循环skills/debugging-strategies/SKILL.md——系统性故障排查skills/lint-and-validate/SKILL.md——轻量质量检查skills/security-auditor/SKILL.md——安全聚焦的代码评审skills/frontend-design/SKILL.md——UI 与交互质量skills/api-design-principles/SKILL.md——API 形态与一致性skills/create-pr/SKILL.md——把工作打包成干净的 Pull Request。6.2 真实提示词示例Use brainstorming to turn this product idea into a concrete MVP plan.Use security-auditor to review this API endpoint for auth and validation risks.第一句演示规划先行第二句演示安全评审——两者都可直接粘贴到支持技能调用的宿主中运行。七、Bundles 与 Workflows从有哪些技能到怎么用技能快照文档用一句话区分了两类编排资源Bundles 帮你选择从哪里开始Workflows 帮你按正确顺序执行技能。7.1 用 Bundles 起步Bundles 是推荐组合而非独立安装——安装仓库一次然后按 docs/users/bundles.md 挑选起点集合仓库内的真实 bundle 数据在 data/bundles.json按id - {description, skills[]}组织例如core-dev覆盖跨语言、框架与前后端基础技能快照给出的三个经典组合SaaS MVPEssentialsFull-Stack DeveloperQA Testing生产加固Security DeveloperDevOps CloudObservability MonitoringOSS 发布EssentialsOSS Maintainer。7.2 用 Workflows 做结果导向的执行人类可读的 playbook 见 docs/users/workflows.md机器可读的工作流元数据见 data/workflows.json其结构为workflows[]每条包含id、name、description、category、relatedBundles与steps[]每个 step 有title、goal、recommendedSkills、notes——例如ship-saas-mvp工作流的第一步Plan the scope就推荐brainstorming、concise-planning、writing-plans快照列出的初始工作流覆盖发布 SaaS MVP、安全审计、AI Agent 系统、QA/浏览器自动化、DDD 导向设计等场景。7.3 运行时技能过多怎么办两个官方缓解路径Antigravity 场景若激活的技能过多导致上下文受限按 docs/users/agent-overload-recovery.md 的激活指引只把需要的 Bundles 或技能 id 物化到实时目录OpenCode /.agents/skills宿主场景优先在安装阶段做精简而不是把全库复制进对上下文敏感的运行时。安装器已支持--risk、--category、--tags可保持安装集足够窄例如npx antigravity-awesome-skills --path .agents/skills --category development,backend --risk safe,none八、浏览 1,494 技能仓库内的探索入口快照文档强调根 README 是高信号落地页更深的探索应进入以下资源技能库本体skills/安装器 CLI由 package.json 的 bin 字段声明生成的目录与元数据CATALOG.md、根目录skills_index.json、data/本地 Web 应用apps/web-app当前仓库中的技能浏览与 Workbench 界面角色化 Bundlesdocs/users/bundles.md插件路线图docs/users/specialized-plugin-roadmap.md执行工作流docs/users/workflows.md新用户建议从 docs/users/getting-started.md 与 docs/users/usage.md 开始。快照还提供了对比与选型入口与 Awesome Claude Skills 的广度对比见 docs/users/agentic-awesome-skills-vs-awesome-claude-skills.md高意图短名单见 docs/users/best-claude-code-skills-github.md 与 docs/users/best-cursor-skills-github.md。九、故障排查先读对文档快照文档刻意保持根 README 简短把恢复场景交给专项文档安装后困惑先看 docs/users/usage.md把技能库集成进自定义宿主先读发现契约 docs/users/discovery-manifest.md即下一节的 Stable Skills Manifest v1Windows 截断 / 上下文崩溃循环docs/users/windows-truncation-recovery.mdLinux/macOS 过载或选择性激活docs/users/agent-overload-recovery.mdOpenCode 等.agents/skills宿主优先用精简安装见 7.3 节的命令插件安装细节、宿主兼容性与 marketplace 安全发行docs/users/plugins.md贡献者期望与护栏见 CONTRIBUTING.md、CODE_OF_CONDUCT.md 与 SECURITY.md。十、Stable Skills Manifest v1自定义集成的发现契约这是快照文档中面向开发者最具契约价值的一节也恰好是当前仓库仍然遵守的稳定接口。要点如下规范文件仓库根目录skills_index.json规范数组格式 manifestJSON Schemaschemas/skills-index.v1.schema.json兼容镜像data/skills_index.json 必须是skills_index.json的完全一致镜像见 docs/users/discovery-manifest.md 的说明。10.1 Manifest 条目字段每条技能记录包含字段含义id技能标识同skill-idpath相对技能目录如skills/brainstormingcategoryUI/搜索使用的分组name显示名description简短用途/触发摘要risk仓库风险标签之一source权威/信任元数据来源date_addedISO 日期字符串或null10.2 推荐的主机行为懒加载稳定的集成方不得一次性加载所有技能指令文件快照给出的标准流程是读取 manifestskills_index.json只解析对话中请求的skill-id值对每个解析出的技能按需读取那一个SKILL.md强制每轮最大值让用户提示保持在上下文限制之内校验每个解析路径均落在你配置的SKILLS_ROOT之下。这是自定义多技能宿主防止上下文截断与轨迹转换错误的主要手段。需要说明的是它属于发现契约而不是 AAS Core 的目录与栈生命周期契约——当前仓库建议 Codex / Claude Code 用户优先使用 docs/users/aas-core.md 描述的 AAS Core只读本地 MCP 目录搜索、Agent 自选技能、compose_stack内存校验原始 manifest 留给没有 Core 适配器的集成方。10.3 结构示例{ id: brainstorming, path: skills/brainstorming, category: planning, name: brainstorming, description: Use before any creative or constructive work., risk: safe, source: official, date_added: 2026-02-27 }十一、贡献、社区与许可快照文档同时给出了社区协作约定这些内容在仓库中均有对应实体文件新技能放在skills/skill-name/SKILL.md遵循贡献者指南 CONTRIBUTING.md模板见 docs/contributors/skill-template.md提交 PR 前运行npm run validate当前仓库在 package.json 中将其映射到tools/scripts/validate_skills.py社区 PR 保持源码纯净不要提交生成的注册表产物如CATALOG.md、skills_index.json、data/*.json修改SKILL.md的 PR 除常规校验与安全扫描外还会触发自动化的skill-review检查改动技能或高风险指引时即便自动化检查全绿仍需人工逻辑评审。快照还列出了完整致谢台账HackTricks、OWASP、Anthropic/OpenAI/Google 官方技能仓库及大量社区贡献者可在 docs/sources/sources.md 查看归属与第三方许可细节。许可方面原始代码与工具采用 MIT见 LICENSE原始文档与其他非代码书面内容采用 CC BY 4.0见 LICENSE-CONTENT。十二、从快照到当前仓库这份指南的适用边界最后回到本文的定位docs/maintainers/backups/README-2026-06-02.md是 2026-06-02 的 README 归档其命令基于当时 npm 包名antigravity-awesome-skills、技能规模 1,494。在当前仓库中npm 包名已是agentic-awesome-skills见 package.json技能规模按当前 README.md 为 2,124并已加入 AAS Core 这一层Agent 自选、你掌控、栈可复现的控制平面。因此安装、验证、按工具选型、Bundles/Workflows 用法、Manifest 契约这些方法与结构仍然成立只需把包名替换为当前名称涉及技能数量的表述以各文档自身标注为准快照为 1,494当前 README 为 2,124不应混用若你使用 Codex 或 Claude Code 并希望 Agent 基于完整本地目录自选技能优先阅读 docs/users/aas-core.md 与根 README.md 的 AAS Core 预览章节而非仅依赖本文介绍的 manifest 直连方式。从找到仓库到跑通第一个技能再到把技能库接入自己的宿主这份快照给出了一条完整、可复现的路径——它至今仍是理解本仓库安装与分发架构的最佳起点之一。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考