scottcwy/skill-kits

技能包

把散落在各个 Agent 里的 Skills，收进一个本地优先的工作台。 一个 Rust 单二进制工具，用来扫描、审计、启停和部署 Codex、Claude Code、Gemini CLI 等 AI Agent 实际读取的 Skill。

为什么   •   核心能力   •   快速开始

为什么需要 技能包

AI Agent 的能力正在变成一堆本地文件：~/.codex/skills、~/.claude/skills、~/.gemini/skills、项目里的 .agents/skills、.claude/skills、.gemini/skills，还有插件缓存、供应商内置 Skill 和各类临时副本。

问题不在于文件多，而在于你很难快速回答这些问题：

• 哪些 Skill 正在被 Agent 读到？
• 哪些只是缓存、插件或只读来源？
• 哪个项目里有自己的 Skill 副本？
• 启用和禁用会不会误删目录？
• 项目副本和托管副本是否已经漂移？
• Codex 插件到底带来了哪些运行时功能？

Skill-kits 的定位很直接：它不接管你的 Agent，也不把 Skills 迁进云端。它扫描 Agent 实际读取的目录，并把状态、风险和可执行操作放到同一个本地工作台里。

核心能力

本地 Agent Space 索引

Skill-kits 以 Agent 正在读取的文件系统为准，扫描全局和项目级 Skill 目录，生成可查询的本地索引。

它会区分：

• Agent Space：Agent 原生读取的全局 Skill。
• Project Agent Space：项目目录内的原生 Skill。
• Plugin Cache：Codex 插件缓存内暴露出的 Skill 或能力。
• Vendor：供应商或只读来源。

Skill-kits

把散落在各个 Agent 里的 Skills，收进一个本地优先的工作台。 一个 Rust 单二进制工具，用来扫描、审计、启停和部署 Codex、Claude Code、Gemini CLI 等 AI Agent 实际读取的 Skill。

为什么  •   核心能力  •   快速开始

为什么需要 Skill-kits

AI Agent 的能力正在变成一堆本地文件：~/.codex/skills、~/.claude/skills、~/.gemini/skills、项目里的 .agents/skills、.claude/skills、.gemini/skills，还有插件缓存、供应商内置 Skill 和各类临时副本。

问题不在于文件多，而在于你很难快速回答这些问题：

• 哪些 Skill 正在被 Agent 读到？
• 哪些只是缓存、插件或只读来源？
• 哪个项目里有自己的 Skill 副本？
• 启用和禁用会不会误删目录？
• 项目副本和托管副本是否已经漂移？
• Codex 插件到底带来了哪些 runtime capabilities？

Skill-kits 的定位很直接：它不接管你的 Agent，也不把 Skills 迁进云端。它扫描 Agent 实际读取的目录，并把状态、风险和可执行操作放到同一个本地工作台里。

核心能力

本地 Agent Space 索引

Skill-kits 以 Agent 正在读取的文件系统为准，扫描全局和项目级 Skill 目录，生成可查询的本地索引。

它会区分：

• Agent Space：Agent 原生读取的全局 Skill。
• Project Agent Space：项目目录内的原生 Skill。
• Plugin Cache：Codex 插件缓存内暴露出的 Skill 或能力。
• Vendor：供应商或只读来源。

安全启停

启用和禁用 Skill 只做一件可逆的事：

enabled   -> SKILL.md
disabled  -> SKILL.md.disabled

Skill-kits 不会为了禁用一个 Skill 删除整个目录。遇到同时存在 SKILL.md 和 SKILL.md.disabled，或两个文件都不存在的情况，会标记为 invalid toggle，阻止危险操作。

项目级 Skill 管理

项目是 Skill-kits 的一等场景。你可以把当前项目加入 Recent Projects，扫描项目内已有的 Skill，并对 Codex、Claude Code、Gemini CLI 或自定义 Agent 的项目 Skill 目录做独立管理。

已实现的项目流程包括：

• 扫描项目内原生 Skill。
• 将项目已有 Skill adopt 为 managed copy。
• 从 managed copy 部署到指定项目和 Agent。
• 启用、禁用、移除项目 Skill。
• 检测 drift、outdated、missing managed source。
• 对有本地改动的项目副本执行 overwrite 或 promote。

Codex 插件与 Runtime Capabilities

Skill-kits 可以扫描 Codex 插件缓存，读取插件 manifest，展示插件状态，并把插件提供的能力展开成独立条目。

skill-kits plugin list
skill-kits plugin status 
skill-kits plugin enable 
skill-kits plugin disable