AAS Core：为 Codex/Claude 管理可审查的技能选择与计划
一个给Codex和Claude挑选可复用技能的本地控制面，先校验并预览计划，不替你推荐或直接应用。
GitHub sickn33/agentic-awesome-skills 更新 2026-10-21 分支 main 星标 48.1K 分叉 7.0K
Python JavaScript Shell TypeScript HTML Agent skills Local MCP Codex Claude Workbench

🧭 决策指南

为什么现在热： 无法从材料判断

适合，如果你

  • 你使用Codex或Claude，想从2,724+个SKILL.md中保存一组可审查技能。
    README的“AAS Core: Agent-First Preview”说明Codex或Claude可检查本地完整目录并记录精确选择。
  • 你需要在安装前检查aas-stack.json并生成计划预览。
    README的“AAS Core: Agent-First Preview”写明aas stack validate检查清单，aas stack plan写入不可变预览。
  • 你在Antigravity中遇到技能上下文过载，需要选择性激活。
    README的“Bundles & Workflows”建议遵循selective activation guide。
  • 你要把角色或目标映射到Web Wizard、Security Engineer或OSS Maintainer技能组。
    README的“Bundles & Workflows”列出这些Bundles示例。

不适合，如果你

  • 你需要Core自动排名或推荐候选技能。
    README明确写着“Core does not rank or recommend skills”。
  • 你需要在支持路径中直接Apply技能或依赖自动Recovery。
    README说明Apply和recovery仍是experimental，并且不属于supported preview。
  • 你的清单需要超过128个技能。
    README的“AAS Core: Agent-First Preview”规定manifests的技术上限为128 skills。
  • 你希望仅凭结构校验确认技能语义、兼容性或操作安全。
    README的IMPORTANT提示指出结构和身份有效不代表semantic fit、compatibility、setup correctness或operational safety。

前置条件

  • 需要使用Codex或Claude，并按对应的Codex setup或Claude Code setup配置local MCP。
  • 配置命令使用[email protected]，并提供Codex配置文件与cache-root的绝对路径。
  • 需要阅读v19.12.1的AAS Core preview guide以了解approval、reconnection、validation和planning。
  • 若直接安装已知技能，需要主机技能目录，例如命令中的--path .agents/skills。

第一步命令（README 原文）

npm exec --yes --ignore-scripts [email protected] -- aas mcp configure \
  --host codex \
  --scope user \
  --config /absolute/path/to/codex/config.toml \
  --cache-root /absolute/path/to/aas-cache

要注意

  • 直接安装器的--dry-run预览不会消费或应用Core plan。
    README的“Install selected skills directly”明确说明direct installer does not consume or apply a Core plan。
  • Antigravity的watched skill directory可能因安装过多技能而过载。
    README的“Install selected skills directly”与“Bundles & Workflows”均说明Antigravity可能出现context overload。
  • Core预览只做清单和结构验证，不证明技能配置正确。
    README的IMPORTANT警告明确排除了setup correctness与operational safety的保证。
  • GitHub README跟踪main，Unreleased内容可能要求更晚版本。
    README说明main中的Unreleased特性需要later release，versioned guide描述published package。

替代方案

  • agentic-awesome-skills直接安装器：你已经知道技能ID，只想用--dry-run预览focused install，而不需要Core的选择与计划流程。
    Installation / Install selected skills directly
  • skills_index.json直接主机发现：主机只加载单个SKILL.md文件，需要使用Stable Skills Manifest v1而不是aas-stack.json。
    Stable Skills Manifest v1
  • Workbench：你只需要在浏览器内存中查看已保存的Core stack和plan，不希望Workbench访问本地文件系统。
    AAS Core: Agent-First Preview

材料未说明

  • README未说明Node.js、npm或Python的最低版本要求。
  • README未给出Codex和Claude的具体兼容版本矩阵。
  • README未说明不同宿主对2,724+个SKILL.md的完整兼容范围。
  • README未提供Apply和recovery实验功能的具体限制、失败行为或恢复流程细节。
  • README未说明2,724+技能的逐项语义质量、维护频率和第三方内容审查标准。
  • README未说明将技能安装到生产环境时的权限边界与运行时隔离方式。

💡 深度解析

6
不适合 我想基于 MIT 许可的 AAS Core 结构做内部集成，但单个项目需要管理超过 128 个技能；我能否直接用一个 `aas-stack.json` 覆盖全部技能？
适合读者： 希望用 MIT 许可的开放结构构建内部技能目录，并受单个 manifest 最多 128 个技能限制的工程集成开发者

不适合直接用一个 stack 覆盖超过 128 个技能，因为项目明确限制单个 manifest 最多包含 128 个技能。

  • 项目数据表明许可证为 MIT，README 也提供开放的文件、索引和 schema 结构，因此内部定制和集成在许可层面有基础。
  • 但项目洞察明确记录：单个 manifest 最多可包含 128 个技能，超过范围需要拆分或重新设计技能集合。
  • AAS Core 的价值在于精确选择、stack validation 和 plan preview，而不是把完整 2,724+ 目录作为一个运行时集合。
  • 对超过 128 个技能的内部目录，还需要自行决定如何拆分 stack、协调多个计划以及处理主机上下文限制；README 没有提供统一的多-stack执行模型。
  • 项目数据：license 为 MIT License
  • 项目洞察 usage_limitations：技术上单个 manifest 最多可包含 128 个技能
  • README「Browse 2,724+ Skills」：完整库包含 2,724+ 个可浏览技能
  • 项目洞察 solution_analysis：以 stack manifest、身份校验、结构验证和不可变计划实现治理
材料未说明：README 未说明多个 stack 是否能被一次性组合、验证或生成统一 approval digest；README 未说明超过 128 个技能时推荐的拆分策略或主机侧切换机制
视情况 我在 Antigravity 中使用技能，而它会监视技能目录；面对 2,724+ 个候选 SKILL.md，我能否用 AAS Core 只安装明确选择的技能，避免上下文过载？
适合读者： 在 Antigravity 中使用技能、担心监视目录加载过多上下文并需要精确控制安装集合的开发者

视情况：AAS Core 能显著缩小 Antigravity 的安装集合，但不能保证技能之间不会产生上下文或行为干扰。

  • README 明确警告 Antigravity 的 watched skill directory 可能造成 context overload，并要求默认目标使用 selected set、filter 或显式 --all。
  • 直接安装器支持按技能 ID、--risk、--category 和 --tags 缩小范围，适合避免一次加载整个 2,724+ 技能目录。
  • README 还提供 selective activation 与 overload recovery 指南，说明该主机需要选择性激活。
  • 但项目只验证技能 ID、manifest 和结构，不证明技能在 Antigravity 中的语义适配、运行时兼容性或安全性。
  • README「Installation」：Antigravity's watched skill directory can overload its context
  • README「Bundles & Workflows」：use the installer's `--risk`, `--category`, and `--tags` filters
  • 项目洞察 usage_limitations：结构与身份校验不能证明语义适配、跨技能兼容性或运行时安全性
npm exec --yes --ignore-scripts [email protected] -- \
  agentic-awesome-skills --release 19.12.1 --path .agents/skills \
  --skills brainstorming,systematic-debugging --dry-run
材料未说明：README 未量化 Antigravity 在不同技能数量或 SKILL.md 长度下的上下文上限；README 未说明 selective activation 是否由 AAS Core 自动执行，还是需要用户在主机侧配置
适合 我正在使用 Codex，希望通过本地 MCP 让代理从 2,724+ 个 SKILL.md 中自主选择技能，但必须在修改目标项目之前看到可审查的精确集合；AAS Core 适合吗？
适合读者： 使用 Codex、希望让本地 MCP 根据项目上下文选择技能，并要求在修改前审查精确技能集合的开发者

适合，因为它正是面向 Codex 的本地、代理优先技能选择与计划预览控制平面。

  • README 明确写明 AAS Core 可让 Codex 或 Claude 搜索完整本地目录，并记录代理选择的技能。
  • 本地 MCP 暴露目录检索和 compose_stack，可按项目上下文选择具体技能 ID，而不是把整个目录加载给代理。
  • aas-stack.json、manifest 校验和 aas stack plan 用于保存、验证并预览精确集合；计划在实际修改前可审查。
  • 但 Apply 和 recovery 仍是实验性功能，因此它适合“选择、验证、预览”，不等于稳定的自动执行闭环。
  • README「AAS Core — Agentic Awesome Skills」：AAS Core helps Codex or Claude search the complete local catalog, record the skills the agent chooses, and preview a plan
  • 项目洞察 solution_analysis：通过本地 MCP 将目录检索和 compose_stack 暴露给 Codex 或 Claude
  • README「Current release」：Apply and recovery remain experimental
材料未说明：README 未说明 Codex MCP 在不同版本中的性能、连接稳定性和代理选择准确率；README 未说明代理如何处理相互冲突或语义相近的技能
适合 我负责从 2,724+ 个技能中为安全测试项目挑选集合，希望按 `risk` 和 `category` 过滤，并在写入主机目录前看到 dry-run；AAS Core 是否满足这个安装控制需求？
适合读者： 管理 2,724+ 技能、希望按风险和类别构建最小技能集合，并要求安装前看到 dry-run 结果的安全工程师

适合做技能发现、范围收窄和安装前预览，但不适合作为安全认证或自动批准系统。

  • README 说明直接安装器可按技能 ID、--risk、--category 或 --tags 进行更小范围安装，符合按安全属性和类别筛选的需求。
  • --dry-run 会先预览 focused install，完成后才可去掉该参数实际安装。
  • 项目提供 security guidance，并把结构有效性与语义适配、运行时安全性区分开；这使安装范围更可见，但不会替代安全审查。
  • 对涉及命令执行、文件修改、凭据或网络访问的自然语言技能，README 没有承诺运行时安全保证，因此不能把筛选结果直接视为可信安全工具。
  • README「Installation」：preview a focused install；`--dry-run`
  • README「Bundles & Workflows」：use the installer's `--risk`, `--category`, and `--tags` filters
  • README「Troubleshooting」：Security and antivirus alerts
  • 项目洞察 market_gap：结构验证不等同于语义适配或安全认证
npm exec --yes --ignore-scripts [email protected] -- \
  agentic-awesome-skills --release 19.12.1 --path .agents/skills \
  --skills brainstorming,systematic-debugging --dry-run
材料未说明：README 未说明 `--risk` 的具体等级定义、默认值和是否经过人工安全评级；README 未说明每个技能是否经过沙箱执行、恶意命令扫描或依赖审计
适合 我使用 Claude Code，需要把精确技能集合保存为 `aas-stack.json`，在团队评审后再安装，并且希望通过 dry-run 查看目标路径和变更范围；这个项目是否适合？
适合读者： 使用 Claude Code、需要把技能集合提交到团队仓库并在安装前审查变更的工程师

适合，因为 README 提供了可记录、可验证、可预览的技能集合流程，正好覆盖团队审查所需的边界。

  • Claude Code 是 README 明确支持的主机，并有单独的 Claude Code setup 指南。
  • aas-stack.json 可保存精确技能集合，aas stack validate 可检查 manifest；这比只保存一串安装命令更容易进入代码评审。
  • aas stack plan 生成不可变计划，Workbench 可在浏览器内审查保存的 stack 和 plan，且不会直接访问本地文件系统。
  • 直接安装器支持 --dry-run，但 README 特别说明它不会消费或应用 Core plan，所以团队必须区分 Core 计划流程与直接安装流程。
  • README「Support the Project」：For a complete setup ... follow Codex setup or Claude Code setup
  • 项目洞察 solution_analysis：通过 aas-stack.json 保存选择结果，并以计划文件和 approval digest 支持人工审查
  • README「Browse 2,724+ Skills」：Workbench 用于 inspect a saved Core stack and plan
  • README「Installation」：The direct installer does not consume or apply a Core plan
材料未说明：README 未说明团队如何在 Git 中处理 stack 版本锁定、冲突合并和审批权限；README 未说明 approval digest 是否包含技能内容哈希或仅包含计划摘要
不适合 我需要同时维护 Cursor、Gemini CLI 和 Claude Code 的技能集，并希望通过机器可读的 `skills_index.json` 复用发现逻辑；AAS Core 能否消除这些主机之间的全部兼容性差异？
适合读者： 需要在 Cursor、Gemini CLI 和 Claude Code 之间迁移技能，并要求每个主机使用可机器读取 manifest 的集成开发者

不适合把它当成“消除全部主机差异”的方案；它能统一发现和部分治理，但不能替代各主机的目录、配置和插件兼容性验证。

  • README 提供 skills_index.json、v1 schema 和 compatibility mirror，适合构建机器可读的直接主机发现集成。
  • 项目数据和 README 都列出 Cursor、Gemini CLI、Claude Code 等兼容目标，说明覆盖面较广。
  • 但 README 仍分别提供 Claude Code、Cursor 等主机指南，并列出 plugin compatibility、配置路径和技能目录问题，表明主机行为并未被完全抽象。
  • 该 manifest 还与 aas-stack.json 和 AAS Core catalog 分离；迁移时不能只复制一个文件就假定安装和加载行为一致。
  • README「Stable Skills Manifest v1」：skills_index.json、v1 schema、compatibility mirror
  • 项目数据 topics：cursor、gemini-cli、claude-code、mcp
  • README「Troubleshooting」：Plugin compatibility and installation；Windows context and truncation recovery
  • README「Stable Skills Manifest v1」：This direct-host discovery manifest is separate from `aas-stack.json` and the AAS Core catalog
材料未说明：README 未列出 Cursor、Gemini CLI 与 Claude Code 各自完整的配置路径和版本兼容矩阵；README 未说明同一个 SKILL.md 在三个主机上的加载优先级和上下文行为是否一致

✨ 核心亮点

  • 目录含2,724+个可安装SKILL.md剧本
  • compose_stack支持只读校验与计划预览
  • 支持Codex、Claude本地MCP与Workbench
  • Core清晰声明不排名、不推荐技能

🔧 工程化

  • 本地目录可搜索完整技能并保存精确选择
  • aas stack validate校验清单，plan生成不可变预览
  • Bundles按Web Wizard等角色分组，Workflows提供有序剧本

⚠️ 风险

  • Apply与recovery仍属实验功能，不在支持的预览路径内
  • 结构和身份有效不代表语义适配或运行安全
  • Antigravity技能过多会造成上下文过载
  • 清单技术上限为128个技能且Core不做推荐

👥 适合谁？

  • 需要Codex或Claude审查技能选择的开发团队
  • 要管理本地MCP、aas-stack.json和计划预览的用户
  • 使用Antigravity并需要选择性激活技能的用户