1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | create-tldr-page-github-awesome-copilot(自述名称:Create TLDR Page) |
| 作者/维护者 | 外部贡献者提交,收录于 GitHub 官方 awesome-copilot 合集 |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/create-tldr-page |
| 许可证 | MIT(合集仓库,GitHub API) |
| 合集 Stars / Forks | 39,887 / 5,092(GitHub API;属整个合集,不代表本技能自身热度) |
| 技能目录最近提交 | 2026-02-19(GitHub API) |
| 安装方式 | 复制 skills/create-tldr-page/ 目录进 agent 的 skills 目录;Copilot CLI 另有插件形式 |
2. 功能介绍与亮点
纯提示词技能(仅一份 SKILL.md),把冗长的命令行文档改写成 tldr-pages 风格的速查页:
- 双必填输入:必须同时给出命令名和权威上游文档 URL,缺一项会给出补全指引(附可接受的 URL 形态示例)。
- 严格套模板:标题、一句话描述、“More information”链接、5–8 条按使用频率排序的示例,格式固定。
- 占位符规范:带参数的选项、无参数开关、单短选项、用户值(
{{path/to/file}})各有明确写法,并附正反例。 - 补充输入:可附帮助输出(
--help)、man 文本、本地文件,作为文档来源的补充。 - 参照样例:提供 git、distrobox-create、nmcli 三份示例页地址,供对照风格。
3. 适用场景
所属分类:内容创作与知识管理。适合要给 tldr-pages 项目投稿的开源贡献者、想给团队内部工具写一页式速查卡的运维与开发者、以及需要把厚手册压缩成“常用例子”的技术文档作者。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 需适配 | 标准 SKILL.md 可直接放入 ~/.claude/skills/;正文用 #fetch、#tool:fetch 是 Copilot 的抓取语法,Claude Code 里改用自带的网页抓取工具即可 |
| Codex | 需适配 | 需手动引用技能文件,不自动发现;抓取语法同上 |
| OpenClaw | 未验证 | 未做实测 |
| Hermes Agent | 需适配 | 按目录扫描 SKILL.md;抓取语法同上,未实测 |
5. 推荐理由
tldr 页的难点不在内容而在格式:占位符包法、选项排序、描述口径都有硬规矩,手写容易反复被评审打回。本技能把这些规矩连同正反例一次性交给 agent,输入只需“命令 + 文档链接”,产出可直接提交。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | skills.sh 上该技能独立安装量约 8.8k;无具名第三方评价 |
| 可用性 | 7 | 复制即用,含错误处理示例与格式正反例;提示词用 Copilot 抓取语法,其他 agent 需自行替换,技能目录最近提交为 2026-02 |
| 安全性 | 9 | 纯提示词,无脚本、无凭据;MIT 许可;官方合集收录 |
综合 7.67。安全检查清单:① 不执行命令,仅生成 Markdown 文本 ✅;② 仅抓取用户提供的文档 URL(以及三份固定的示例页),无其他外联 ✅;③ 无需凭据 ✅;④ 未发现可疑指令 ✅;⑤ 由 GitHub 官方合集收录 ✅;⑥ MIT ✅;⑦ 目录最近提交 2026-02-19,内容稳定 ⚠️。
7. 跟同类 Skills 相比的优势
| 对比项 | create-tldr-page | 通用文档改写类提示(“把这段文档总结成要点”) | man/cheat.sh 等速查工具 |
|---|---|---|---|
| 定位 | 产出 tldr-pages 规范的投稿页 | 泛泛压缩文本 | 现成查询,不生成新页面 |
| 格式约束 | 模板、占位符、排序均有硬规则与正反例 | 无 | 不适用 |
| 来源要求 | 强制权威上游 URL | 无 | 不适用 |
| 适合人群 | tldr 贡献者、写内部速查卡的人 | 任意 | 只想查命令的人 |
核心差异:解决的是“按 tldr 规范写对”的问题,而不是泛化的摘要。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 其他补充
同时以插件形式分发(copilot plugin install,Copilot CLI 专用)。示例页引用的 tldr-pages 主项目约 6.4 万 Stars,仍在活跃维护。
10. 安装使用方式
# Claude Code
git clone --depth 1 https://github.com/github/awesome-copilot /tmp/ac
cp -r /tmp/ac/skills/create-tldr-page ~/.claude/skills/
安装后对 agent 说“用 create-tldr-page 为 <命令> 生成 tldr 页,文档是 <URL>“即可。
11. 注意事项
- 必须同时提供命令名与文档 URL,否则只会得到补全提示。
- 提示词里的
#fetch语法为 Copilot 专有,其他 agent 需让它用自带的网页抓取能力。 - 产出质量取决于上游文档质量;投稿前仍需对照 tldr-pages 的贡献指南人工核对。