Skip to content
Back to search

skill-kits

Skill-kits is a zero-dependency, single-binary AI Agent Skills management tool for any LLM and multi-agent workflows.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/scottcwy--skill-kits/badge.svg)](/listings/scottcwy--skill-kits)

HTML

<a href="/listings/scottcwy--skill-kits"><img src="/api/listings/scottcwy--skill-kits/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 261 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="media/dashboard.png" alt="Skill-kits Dashboard" width="900" />
  3. </p>
  4. <h1 align="center">Skill-kits</h1>
  5. <p align="center">
  6. <strong>把散落在各个 Agent 里的 Skills,收进一个本地优先的工作台。</strong><br/>
  7. 一个 Rust 单二进制工具,用来扫描、审计、启停和部署 Codex、Claude Code、Gemini CLI 等 AI Agent 实际读取的 Skill。
  8. </p>
  9. <p align="center">
  10. <a href="https://github.com/scottcwy/skill-kits"><img src="https://img.shields.io/badge/status-v0.1_local_first-0f0f10?style=flat-square" alt="Project Status" /></a>
  11. <a href="Cargo.toml"><img src="https://img.shields.io/badge/Rust-1.80%2B-f5f5f5?style=flat-square&logo=rust&logoColor=white&color=1b1b1d" alt="Rust 1.80+" /></a>
  12. <a href="#快速开始"><img src="https://img.shields.io/badge/platform-macOS_first-1f1f22?style=flat-square" alt="macOS first" /></a>
  13. <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-2a2a2d?style=flat-square" alt="MIT License" /></a>
  14. </p>
  15. <p align="center">
  16. <a href="#为什么需要-skill-kits">为什么</a>&nbsp;&nbsp;&bull;&nbsp;&nbsp;
  17. <a href="#核心能力">核心能力</a>&nbsp;&nbsp;&bull;&nbsp;&nbsp;
  18. <a href="#快速开始">快速开始</a>
  19. </p>
  20. <br/>
  21. ## 为什么需要 Skill-kits
  22. AI Agent 的能力正在变成一堆本地文件:`~/.codex/skills`、`~/.claude/skills`、`~/.gemini/skills`、项目里的 `.agents/skills`、`.claude/skills`、`.gemini/skills`,还有插件缓存、供应商内置 Skill 和各类临时副本。
  23. 问题不在于文件多,而在于你很难快速回答这些问题:
  24. - 哪些 Skill 正在被 Agent 读到?
  25. - 哪些只是缓存、插件或只读来源?
  26. - 哪个项目里有自己的 Skill 副本?
  27. - 启用和禁用会不会误删目录?
  28. - 项目副本和托管副本是否已经漂移?
  29. - Codex 插件到底带来了哪些 runtime capabilities?
  30. Skill-kits 的定位很直接:**它不接管你的 Agent,也不把 Skills 迁进云端。它扫描 Agent 实际读取的目录,并把状态、风险和可执行操作放到同一个本地工作台里。**
  31. <p align="center">
  32. <img src="media/skills.png" alt="Skill-kits Skills view" width="900" />
  33. </p>
  34. ## 核心能力
  35. ### 本地 Agent Space 索引
  36. Skill-kits 以 Agent 正在读取的文件系统为准,扫描全局和项目级 Skill 目录,生成可查询的本地索引。
  37. | Agent | 全局 Skill 目录 | 项目级 Skill 目录 |
  38. | --- | --- | --- |
  39. | Codex | `~/.codex/skills` | `<project>/.agents/skills` |
  40. | Claude Code | `~/.claude/skills` | `<project>/.claude/skills` |
  41. | Gemini CLI | `~/.gemini/skills` | `<project>/.gemini/skills` |
  42. | Custom Agent | 本地配置 | 本地配置 |
  43. 它会区分:
  44. - `Agent Space`:Agent 原生读取的全局 Skill。
  45. - `Project Agent Space`:项目目录内的原生 Skill。
  46. - `Plugin Cache`:Codex 插件缓存内暴露出的 Skill 或能力。
  47. - `Vendor`:供应商或只读来源。
  48. ### 安全启停
  49. 启用和禁用 Skill 只做一件可逆的事:
  50. ```text
  51. enabled -> SKILL.md
  52. disabled -> SKILL.md.disabled
  53. ```
  54. Skill-kits 不会为了禁用一个 Skill 删除整个目录。遇到同时存在 `SKILL.md` 和 `SKILL.md.disabled`,或两个文件都不存在的情况,会标记为 invalid toggle,阻止危险操作。
  55. ### 项目级 Skill 管理
  56. 项目是 Skill-kits 的一等场景。你可以把当前项目加入 Recent Projects,扫描项目内已有的 Skill,并对 Codex、Claude Code、Gemini CLI 或自定义 Agent 的项目 Skill 目录做独立管理。
  57. 已实现的项目流程包括:
  58. - 扫描项目内原生 Skill。
  59. - 将项目已有 Skill adopt 为 managed copy。
  60. - 从 managed copy 部署到指定项目和 Agent。
  61. - 启用、禁用、移除项目 Skill。
  62. - 检测 drift、outdated、missing managed source。
  63. - 对有本地改动的项目副本执行 overwrite 或 promote。
  64. ### Codex 插件与 Runtime Capabilities
  65. Skill-kits 可以扫描 Codex 插件缓存,读取插件 manifest,展示插件状态,并把插件提供的能力展开成独立条目。
  66. ```bash
  67. skill-kits plugin list
  68. skill-kits plugin status <plugin>
  69. skill-kits plugin enable <plugin>
  70. skill-kits plugin disable <plugin>
  71. skill-kits list --kind runtime-capability
  72. ```
  73. 这适合用来回答:某个 Codex 插件是否启用、来自哪个 provider、带了哪些 Skill、命令、Agent、app 或 asset。
  74. ### 轻量风险扫描
  75. Skill-kits 内置 advisory scan,用来检查 Skill 文档和 shell 文件里的高风险指令。它不会替你做最终安全判断,也不会阻止安装,但会把风险提前抬到桌面上。
  76. 当前会提示的风险包括:
  77. - `curl | sh` / `wget | sh`
  78. - `rm -rf`
  79. - `sudo`、`chmod +x`
  80. - token、secret、credential、env、API key 访问
  81. - 网络下载指令
  82. - shell fence 中的未知二进制执行
  83. ### 原生 GUI + CLI
  84. Skill-kits 是一个 Rust 单二进制应用。CLI 和 GUI 共用同一套核心逻辑。
  85. GUI 提供五个工作台视图:
  86. - **Dashboard**:Agent Space、项目、插件和健康状态总览。
  87. - **Skills**:全局与项目 Skill 实例列表,支持状态、来源和路径检查。
  88. - **Agents**:Codex、Claude Code、Gemini CLI 与 Custom Agent 的项目 Skill 目录配置。
  89. - **Projects**:Recent Projects、项目 Skill 扫描、adopt、启停和 drift 处理。
  90. - **Plugins**:Codex 插件、启停状态与 runtime capability 明细。
  91. <p align="center">
  92. <img src="media/agents.png" alt="Skill-kits Agents view" width="900" />
  93. </p>
  94. ## 快速开始
  95. ### 环境要求
  96. - Rust 1.80 或更高版本
  97. - macOS 是当前首发 GUI 目标
  98. - 至少安装或配置一个支持 Skill 目录的 Agent
  99. ### 从源码运行
  100. ```bash
  101. git clone https://github.com/scottcwy/skill-kits.git
  102. cd skill-kits
  103. cargo run -- status
  104. cargo run -- scan
  105. cargo run -- --gui
  106. ```
  107. ### 安装到本机
  108. ```bash
  109. cargo install --path .
  110. skill-kits status
  111. skill-kits scan
  112. skill-kits --gui
  113. ```
  114. ## 常用命令
  115. ### Agent Space
  116. ```bash
  117. skill-kits status
  118. skill-kits scan
  119. skill-kits list
  120. skill-kits enable <skill-or-instance-id>
  121. skill-kits disable <skill-or-instance-id>
  122. ```
  123. ### Managed Copy
  124. ```bash
  125. skill-kits install local <path-to-skill>
  126. skill-kits uninstall <skill>
  127. skill-kits scan <skill>
  128. skill-kits adopt --global-agent codex
  129. ```
  130. ### Project
  131. ```bash
  132. skill-kits project status --project /path/to/project
  133. skill-kits project adopt <skill> --agent codex --project /path/to/project
  134. skill-kits project deploy <skill> --agent codex --project /path/to/project
  135. skill-kits project enable <skill> --agent codex --project /path/to/project
  136. skill-kits project disable <skill> --agent codex --project /path/to/project
  137. skill-kits project redeploy <skill> --agent codex --project /path/to/project --overwrite
  138. skill-kits project redeploy <skill> --agent codex --project /path/to/project --promote
  139. skill-kits project remove <skill> --agent codex --project /path/to/project --force
  140. ```
  141. ### Codex Plugins
  142. ```bash
  143. skill-kits plugin list
  144. skill-kits plugin status <plugin>
  145. skill-kits plugin enable <plugin>
  146. skill-kits plugin disable <plugin>
  147. skill-kits plugin scan
  148. skill-kits list --kind runtime-capability
  149. ```
  150. 所有主要 list/status/scan 命令都支持 JSON 输出:
  151. ```bash
  152. skill-kits status --format json
  153. skill-kits list --format json
  154. skill-kits project status --format json
  155. skill-kits plugin list --format json
  156. ```
  157. ## 本地数据
  158. Skill-kits 的配置、索引、托管副本和 registry 默认存放在:
  159. ```text
  160. ~/.skill-kits/
  161. ├─ config.toml
  162. ├─ registry/
  163. ├─ skills/
  164. ├─ cache/
  165. └─ locks/
  166. ```
  167. Agent Space 索引只是扫描缓存。真正的启用状态以磁盘上的 `SKILL.md` / `SKILL.md.disabled` 为准。缓存过期时重新运行:
  168. ```bash
  169. skill-kits scan
  170. ```
  171. ## 开发
  172. ```bash
  173. cargo fmt --all --check
  174. cargo clippy --all-targets --all-features -- -D warnings
  175. cargo test
  176. ```
  177. ## Roadmap
  178. - 发布 macOS arm64 可下载包。
  179. - 更完整的 GUI 截图、演示 GIF 和 release smoke 文档。
  180. - 更丰富的 Agent 适配与自定义 Agent 配置体验。
  181. - 更细的 Skill risk policy 与可解释扫描报告。
  182. - 项目级工作流的导入、冲突处理和批量操作打磨。
  183. ## Contributing
  184. 欢迎提交 issue 和 PR。当前项目还在 v0.1 阶段,最需要的贡献包括:
  185. - 真实 Agent 目录适配测试。
  186. - macOS GUI 使用反馈。
  187. - Skill 风险扫描规则补充。
  188. ## License
  189. This project is licensed under the MIT License. See [LICENSE](LICENSE) for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.