技能合集 HOWILLMAKEIT/skills

skills

把日常技术工作里值得复用的流程，做成带明确边界和完成标准的 Agent Skills。

Skills | Quick Start | How It Works | Details | Contributing

个人维护的 Agent Skills 合集，适用于 Claude Code、Codex 等 46+ 编码智能体（遵循 Agent Skills 规范）。每个技能以 SKILL.md 为入口，写明何时使用、怎么做、怎样算完成。

与只给提示词的合集不同，这里的技能有三个共同点：先核对一手资料再下结论、输出区分“已验证 / 来源称 / 推断 / 未确认”、交付前有可检查的完成标准。

Overview

Highlights

🧭先核对，再下笔笔记、总结、分析都要求回到官方文档、论文、代码或字幕 🎯结论有边界每个技能写明适用范围、不适用情形和完成标准 ✍️语言可核对共享 STE 准确性规则与去 AI 味编辑，数字和情态词含义固定

🧪可运行的校验结构校验器、自动测试与人工回归场景，区分“已运行”和“未验证” 📦多智能体通用同一套目录可装进 Claude Code、Codex、DSH 🔒不越权外部操作、付费调用和发布需要用户明确授权

News

- 2026-10-14 ✍️ v0.11.0：gpt-paper-image 改名为 ai-paper-writing，新增摘要、intro、实验等段落的三步参考式写作；better-notes 新增论文笔记固定模板。详见 CHANGELOG。
- 2026-10-09 🖼️ v0.10.0：gpt-paper-image 改为人机协作：GPT 保存参考图并编写提示词，用户网页生图，GPT 再重建可编辑 PPT。
- 2026-10-08 🧩 v0.9.0：新增 gpt-paper-image；better-notes 加入 Obsidian Datacore 组件与设计准则；五个技能加入共享的语言准确性规范。详见 CHANGELOG。
- 2026-10-05 ✍️ v0.8.0：better-notes 内置 humanizer 风格编辑。
- 2026-09-16 🎯 v0.6.0：新增 better-decision。

👉 更早的版本（点击展开）

完整历史见 CHANGELOG.md。

Skills

| 技能 | 解决的问题 | 主要产出 |
| better-decision | 多件事都合理，不知道现在先做哪件；区分逃避、必要准备、阻塞与休息 | 当前优先事项、最小行动、暂缓项、复查条件 |
| better-notes | 让 llm 写出有事实依据的技术笔记，避免过时 API 和无依据内容 | 带来源与访问日期的 Markdown 笔记；论文笔记按固定四部分模板写；Obsidian 下用 Datacore 组件取代 Mermaid |
| video-summary | 给一个 Bilibili / YouTube 链接，快速看懂视频 | TL;DR、带真实时间戳的要点、章节时间线、金句 |
| undress | 论文、项目、简历的包装话术 | 作者实际复用、修改、实现、验证了什么，以及哪些结论缺证据 |
| ai-paper-writing | 论文写作：插图的人机协作绘制，以及摘要、intro、实验等段落的参考式写作 | 参考图、生图提示词、可编辑 PPT；顶会同段落参考集、写法总结、成稿 |
| project-building | 建立项目工作规范，按设计版本维护文档与交接 | AGENTS、项目交接、v0 起步的设计与进展文档；内置 better-notes 核对来源与表达 |

工作原理

flowchart LR
A["用户请求"] --> B["SKILL.md适用范围与工作流"]
B --> C["一手资料文档 / 论文 / 代码 / 字幕"]
C --> D["事实草稿标注证据强度"]
D --> E["语言准确性language-precision.md"]
E --> F["完成标准检查校验器 / 测试 / 自检"]
F --> G["最终交付"]

style B fill:#e0f2fe,stroke:#0284c7,stroke-width:2px
style E fill:#fef3c7,stroke:#f59e0b,stroke-width:2px
style F fill:#f5f3ff,stroke:#8b5cf6,stroke-width:2px

1. SKILL.md 的 description 决定何时触发；正文给出工作流，参考文档按需加载。
2. 事实类内容先读一手资料，再写正文；无法取得时说明缺什么，不用记忆补全。
3. better-decision、better-notes、undress、video-summary 共用一份 references/language-precision.md：把 ASD-STE100（简化技术英语）的写作原则和 humanizer 的结构编辑改写成中文规则，默认 80% 模式。它不含 STE 词典，也不声称符合该标准。
4. 交付前对照完成标准：结构校验通过不等于效果已验证，两者分开报告。

快速开始

方式一：npx 一键安装（推荐）

默认以软链方式装到各智能体目录：

Claude Code：全局安装全部 skill
npx -y skills@latest add HOWILLMAKEIT/skills --skill '' -g -a claude-code -y
Codex or deepseek harness：全局安装全部 skill
npx -y skills@latest add HOWILLMAKEIT/skills --skill '' -g -a codex -y
只装一个 skill、装到当前项目：--skill video-summary，并去掉 -g 升级：npx -y skills@latest update video-summary -g

方式二：手动复制或软链（含 DSH）

git clone https://github.com/HOWILLMAKEIT/skills.git && cd skills

Claude Code
mkdir -p ~/.claude/skills && cp -R better-decision better-notes video-summary undress ai-paper-writing project-building ~/.claude/skills/
Codex
mkdir -p ~/.codex/skills && cp -R better-decision better-notes video-summary undress ai-paper-writing project-building ~/.codex/skills/
DSH（已查证：dsh 自动读取 ~/.agents/skills，源码 dsh-skill-filesystem 默认 roots）
mkdir -p ~/.agents/skills && cp -R better-decision better-notes video-summary undress ai-paper-writing project-building ~/.agents/skills/

不想复制多份？用软链（后续升级 = git pull 即生效） ln -s "$(pwd)/better-notes" ~/.agents/skills/better-notes

目录对照与生效方式

| 智能体 | 全局技能目录 | 项目级技能目录 | 生效方式 |
| Claude Code | ~/.claude/skills/ | <项目>/.claude/skills/ | 新开会话 |
| Codex | ~/.codex/skills/ | <项目>/.agents/skills/ | 新开会话 |
| DSH | ~/.agents/skills/ | <项目>/.agents/skills/ | 新开会话后自动触发，无需任何插件或配置 |

Codex 与 DSH 的项目级目录相同（.agents/skills），装一份两边都能用。

技能详情

better-decision：先做当前最重要的事

输入目标、候选任务、期限和可用时间，输出「当前先做什么 → 最小行动与完成标准 → 暂缓什么 → 何时复查」。例如：「我一直研究求职方法却没投简历，帮我决定今天先做什么。」

它不把忙碌直接判为逃避，也不把休息判为懒惰；方法参考拖延的情绪调节解释、if–then 行动计划与进度监测研究。见使用说明与依据及局限。

better-notes：先查资料，再写笔记

用户要求编写、整理或重写技术与知识笔记时，先检索并阅读官方文档、发布说明、论文、官方仓库或高质量文章，再开始写作。涉及 API、命令或依赖时，核对目标版本、弃用状态、替代方案和迁移方式。

- 输出：标题后列实际使用的资料，正文直接给出定义，按主题说明前置条件、输入、处理、输出、最小示例、限制与常见错误。不用比喻代替定义，取不到必要来源时不退回到纯记忆写作。
- 语言：内置风格编辑与语言准确性规范，改写自 blader/humanizer，见风格编辑与语言准确性规范。清理无意义对比、空泛铺垫、重复结尾和宣传词。保留代码、公式、链接以及版本、条件、真实不确定性和引用归属，不附编辑过程或 AI 检测评分。
- Obsidian：保存位置在 Obsidian 库内时，用 Datacore 的 JSX 组件取代 Mermaid 图。环境检查、示例和冒烟测试见 obsidian-datacore.md，界面设计准则见 widget-design.md。笔记正文不写组件依赖或测试状态说明，这些只在对话里报告。

video-summary：视频总结

参考 BibiGPT-v1 的总结管线，收到视频链接后完成「URL 解析 → 字幕/转写抓取 → 结构化总结」两步，输出：

- TL;DR：一句话概括整支视频；
- 核心要点：带真实时间戳的要点列表；
- 章节时间线：按内容节奏切分，时间戳可点击跳转（B 站 ?t=秒 / YouTube &t=秒）；
- 金句：原文引用 + 秒数。

装好后直接在对话里发链接并说“总结这个视频 / 提炼要点 / 做视频笔记”。

| 平台 | 链接形式 | 说明 |
| Bilibili | bilibili.com/video/BVxxx、b23.tv 短链、?p=N 多 P | 零依赖纯 API 抓取；字幕（CC/AI）需 B 站登录态 |
| YouTube | youtube.com/watch、youtu.be、shorts | 走 yt-dlp（无 PATH 时自动 uvx 零安装运行） |

B 站登录态配置（决定能否拿到完整字幕）

方式一：浏览器登录 bilibili.com → F12 → Application → Cookies → 复制 SESSDATA
export BILIBILI_SESSDATA="<你的SESSDATA>"
方式二：直接读浏览器登录态
export BILIBILI_COOKIES_FROM_BROWSER=chrome # 或 edge；safari 受 macOS 隐私保护可能失败

无登录态时 skill 不会悄悄降级：返回 login-required 引导你先登录；你确认无法登录后才加 --allow-desc-fallback 降级为“标题+简介”粗略总结。无字幕视频可进阶走本地 ASR（见 video-summary/references）。

undress：看穿包装

输入论文、仓库、博客或简历项目，输出作者实际复用了什么、修改了什么、实现了什么、验证了什么。区分概念复杂度、实现难度、实验严谨度和证据强度；无法验证的结论写“没有足够证据”，不替作者补全故事，也不反向贬低工作。

ai-paper-writing：论文插图与文字段落

分两类任务。

画图：“用 $ai-paper-writing 为这篇论文搜集参考图并写提示词，我在网页端手动生图后，你再转成可编辑 PPT。”GPT 先保存近期领域顶会同类型参考图，结合论文或代码及公开绘图方法准备提示词与上传清单；用户手动生图并提供原图后，GPT 再进行原生 PPT 重建、实际导出复核与留档。已有满意原图时可直接转换。

写段落（摘要、intro、实验等）：“用 $ai-paper-writing 搜集同领域顶会的 intro。”分三步，每步完成后暂停，等你确认才继续：

1. 搜集：把相关顶会论文的对应段落存成 md，放进 论文写作/参考<段落>/，文件名为 年份 级别 论文名（如 2026 AAAI EoH-S.md），并写清单；不做分析。
2. 总结：你要求后，通读全部文件，写出逐篇段落功能图，归纳共同的逻辑顺序、常见变体和长度分布，结论带 n/N。
3. 写作：你要求后，读你的代码和草稿，按总结出的逻辑骨架写作，缺失的数据标“待确认”，并用脚本检查成稿与参考文件没有连续相同的片段。

任务素材保存在对应项目中；技能包仅包含通用流程、公开来源链接和合成测试代码。详见 SKILL.md。

project-building：按版本维护项目与交接

先读取实际代码、配置、文档和必要的运行证据，明确本次目标与完成标准，再按任务推进设计、实现和验证，维护受影响的项目记录。适用于软件开发和研究项目。

- 项目入口：AGENTS.md 记录环境、命令与长期约束；PROJECT_HANDOFF.md 记录当前工作版本、状态、问题和下一步；docs/README.md 提供版本导航。
- 版本文档：从 docs/v0/ 开始，每版以 README.md、DESIGN.md、PROGRESS.md 为核心，需要展开的探索、审查和专题分析放入 guides/。用户确认下一轮设计迭代后建立 v1、v2，保留旧版记录；日常修复和补充验证留在当前版本。
- 写作与证据：必须执行内置 better-notes，核对来源、语言准确性和写作风格，无需另行安装。实验原始结果、日志和权重保存在实际产物目录，文档链接证据。

调用示例：

使用 $project-building 读取当前项目，建立 AGENTS.md、项目交接和 docs/v0/ 文档，核实实际代码、环境与命令，沿用已有等价结构。

只读查询只汇报，不自动写文档；发布、推送和停止作业仍按本次任务授权执行。安装和更多示例见使用说明，完整规则见 SKILL.md。

Project Structure

.
├── README.md
├── CHANGELOG.md
├── LICENSE
├── scripts/
│ └── validate-skills.mjs # 合集结构校验（可本地运行） └── <skill>/ ├── SKILL.md # 技能入口（含 name + description frontmatter） ├── references/ # 按需加载的参考文档 │ └── language-precision.md # 共享的语言准确性规范（部分 skill） ├── scripts/ # skill 自带脚本 └── assets/ evals/ # 模板与评估（可选）

致谢

- blader/humanizer（作者 Siqi Chen，MIT 协议）：better-notes 的 humanizer 风格编辑和各 skill 共享的语言准确性规范中的去 AI 味部分，由它的结构编辑方法改写为中文，并针对技术内容收紧事实保护边界。它的模式来源于 Wikipedia 的 Signs of AI writing。本仓库不包含其原文。
- ASD-STE100（简化技术英语，ASD 维护）：语言准确性规范借鉴其写作原则。本仓库不含其词典，也不声称符合该标准。
- BibiGPT-v1：video-summary 的总结管线与模板参考。
- Anthropic 的 frontend-design：better-notes 组件设计准则借鉴其原则。

贡献

新增 skill

顶层新建同名目录，写入带 name + description frontmatter 的 SKILL.md，并在上方 Skills 表格加一行；node scripts/validate-skills.mjs 可本地校验合集结构。

发布

打 tag 并创建 GitHub Release（GitHub 会自动附上该 tag 的 Source code 压缩包，Release 说明写清本次修改内容即可）：

git tag vX.Y.Z && git push origin main vX.Y.Z
gh release create vX.Y.Z --title "vX.Y.Z" --notes "- 本次修改内容…"

问题与建议：GitHub Issues。

引用

@software{howillmakeit_skills,
author = {HOWILLMAKEIT},
title = {{skills: a personal collection of Agent Skills}},
url = {https://github.com/HOWILLMAKEIT/skills},
year = {2026}
}

许可

MIT