# agent-skills

从一个入口按用途选择并安装 im0o 的 agent skill。

```bash
npx skills add ssh://gitea/agent-skills/skills.git
```

会出现一个按用途分组的多选列表。可以选择整组，也可以只勾选其中几个 skill。仓库是
私有的，`skills add` 使用系统 Git 克隆；本机的 SSH key 能访问该仓库即可，不需要另外
配置安装凭据。

## 目录里有什么

| 组 | skill | 做什么 | 平台 |
|---|---|---|---|
| Writing Clarity | `think-twice` | 重写一段输出,让它脱离上下文也能读懂,每条声明都经过验证,不留只在写作过程中有意义的内容 | 任意 |
| Writing Clarity | `teach-me` | 对接上下文:长任务跑完、隔久回到旧项目、面对陌生代码时,先自己探索,再一轮讲一层 | 任意 |
| Windows Tools | `disk-master` | 只读扫描磁盘占用,解释盘为什么满了,生成可交互 HTML 报告 | Windows |
| Windows Tools | `everything-file-search` | 借 Everything 的 IPC 按文件名和路径极快定位文件 | Windows,需要 Everything 在跑 |
| Image To Data | `baimiao-table-ocr` | 表格截图转 CSV / JSON / Markdown / XLSX | 任意,需要网络 |

`think-twice` 和 `teach-me` 各自完整,单独装任何一个都能用,不存在跨 skill 的文件
依赖。放同一组是因为它们互相交接:`think-twice` 重写一次仍然没打中的时候转给
`teach-me`,`teach-me` 遇到会活得比对话久的内容时交给 `think-twice` 过一遍。两个都
装上,这两条路才通。

`baimiao-table-ocr` 会把图片上传到第三方服务。隐私敏感的图不要用它。

## 这个仓和源码仓的关系

`skills/` 下的五个目录是真副本,不是子模块也不是软链接。原因在
`vercel-labs/skills` 的两处代码:`git.ts:241` 的克隆没有 `--recurse-submodules`,
子模块目录克隆出来是空的;`plugin-manifest.ts:89` 会跳过 marketplace.json 里的
远端来源,只认仓内的本地路径。

各自的源码仓在同一个 org 下:

| skill | 源码仓 | 仓内路径 |
|---|---|---|
| `think-twice` | `agent-skills/think-twice` | `skill/` |
| `teach-me` | `agent-skills/teach-me` | 仓根 |
| `disk-master` | `agent-skills/disk-master-skill` | `skill/` |
| `everything-file-search` | `agent-skills/everything-skill` | `everything-file-search/` |
| `baimiao-table-ocr` | `agent-skills/img2excel-skill` | `skills/baimiao-table-ocr/` |

改动在源码仓完成，分发仓只承载可安装副本。源码仓发布正式 `v*` tag 并生成 Release
ZIP 后，分发仓按 `.dist-sync/sources.json` 白名单同步 latest Release。当前只自动同步
`think-twice`；其余四个 skill 具备标准 Release 后再逐项加入。白名单来源尚无 latest
Release 时会跳过并保留现有副本。