Distribution repo skeleton

One `npx skills add ssh://gitea/agent-skills/skills` now offers all five
skills in a grouped multi-select list. Groups come from
.claude-plugin/marketplace.json: writing-clarity, windows-tools,
image-to-data.

skills/ holds real copies rather than submodules or pointers. The installer
clones without --recurse-submodules (git.ts:241), so a submodule directory
would arrive empty, and it skips remote sources declared in a marketplace
manifest (plugin-manifest.ts:89), so only in-repo paths are resolvable.

Grouping applies only to skills listed explicitly under a plugin's skills
array with a ./-prefixed path (plugin-manifest.ts:147-151); anything not
listed falls into "Other".

think-twice and teach-me share a group because teach-me's SKILL.md points at
double-check.md, self-contain.md and style.md inside the think-twice
directory. Installing teach-me alone leaves those pointers unresolved.

Syncing from the five upstream repos is manual for now.
This commit is contained in:
2026-08-14 17:06:34 +08:00
commit 6b2e167e69
24 changed files with 2589 additions and 0 deletions
+45
View File
@@ -0,0 +1,45 @@
# 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/` |
改动在源码仓做,这个仓只承载分发副本。同步目前是手工的,自动化还没做。