# agent-skills

一次装齐 im0o 的 agent skill。

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

会出现一个多选列表,按用途分成三组,勾选需要的即可。仓库是私有的,`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` 放同一组不是为了好看。`teach-me` 的 SKILL.md 直接引用
`think-twice` 目录下的 `double-check.md`、`self-contain.md`、`style.md`,只装
`teach-me` 会让这三个指针掉空。它每个指针都带了内联兜底说明,但拿到的是简写版。

`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` | 仓根 |
| `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/` |

改动在源码仓做,这个仓只承载分发副本。同步目前是手工的,自动化还没做。