Better Notes

编写、整理或重写有事实依据的技术与知识笔记。用户要求“写笔记”“整理知识点”“做学习笔记”“写教程/概念说明”,尤其涉及 API、库、框架、论文、算法或可能随版本变化的内容时使用。笔记对象是论文时,按固定四部分模板写:研究现状和作者动机、方法简要介绍(带论文主图)、方法细节、实验。写作前必须先查阅网络上的官方文档、发布说明、论文、技术博客或文章,核对版本、弃用状态与替代方案;不能只凭模型记忆成文。输出简洁、直接,不用比喻,并把前置条件、输入、处理过程、输出、限制和来源说清楚。笔记保存在 Obsidian 库时,用 Datacore 的 JSX 交互组件取代 Mermaid 图,并在有助于理解处补充小组件。不用于仅做文字校对,或逐字整理用户提供的私人会议记录。

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add HOWILLMAKEIT/skills --skill better-notes
Manual install
git clone --depth 1 https://github.com/HOWILLMAKEIT/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/better-notes ~/.claude/skills/better-notes

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Better Notes

编写能追溯来源、版本不过时、结构简洁的知识笔记。

## 核心规则

**先查资料,再写笔记。** 不要先凭记忆生成正文,再搜索资料为既有结论补引用。

- 至少查到一份直接支持核心内容的一手资料,才开始写作。
- 涉及 API、命令、依赖或框架时,必须核对当前官方文档和版本/发布说明。
- 把资料没有支持的内容删除、改为明确推断,或标记为“尚未确认”。
- 没有网络或无法取得必要资料时,停止撰写事实性正文;说明缺少什么,并请求用户提供来源或允许稍后重试。
- 引用来源不等于复制来源。笔记应重新组织信息,只保留理解和使用所需的内容。

开始调研前读取 [references/research-and-verification.md](references/research-and-verification.md)。确定结构与措辞前读取 [references/note-style.md](references/note-style.md) 和 [references/humanizer.md](references/humanizer.md)。去 AI 味规则已内置,无需另行安装 `humanizer`。写正文和做内部编辑时另读 [references/language-precision.md](references/language-precision.md),其中的 STE 准确性规则(一句一事、一词一义、具体动词、固定情态词与证据标签)与 humanizer 配合使用,默认 80% 模式。

笔记对象是一篇论文时,另读 [references/paper-note-template.md](references/paper-note-template.md),按其中固定的四部分模板写,不使用下文的通用结构。

目标笔记在 Obsidian 库里(上级目录含 `.obsidian/`,或用户说明写给 Obsidian)时,另读 [references/obsidian-datacore.md](references/obsidian-datacore.md),其中给出环境检查、组件写法、示例和验证脚本;设计组件界面前读 [references/widget-design.md](references/widget-design.md)。

## 工作流

### 1. 明确笔记任务

从用户输入中提取:

- 主题与目标读者;
- 想解决的问题;
- 期望深度和输出语言;
- 指定技术栈、版本、时间范围或来源;
- 笔记类型:论文笔记,还是 API、框架、概念等其他笔记;
- 目标格式与保存位置,包括保存位置是否在 Obsidian 库内。

已有信息不要重复询问。只有缺失项会改变资料范围或正文结构时才提问;否则采用最窄、最实用的范围。

### 2. 先建立问题清单

写出本篇笔记必须回答的 3~7 个问题,例如:

1. 它是什么,解决什么问题?
2. 使用它需要哪些前置条件?
3. 输入是什么,经过什么处理,输出是什么?
4. 最小可运行用法是什么?
5. 当前版本有哪些限制、弃用项或迁移要求?

问题清单用于约束搜索范围,不需要默认展示给用户。

### 3. 检索并核对资料

按以下顺序选择来源:

1. 官方文档、规范、API reference、发布说明、迁移指南;
2. 原始论文、作者项目页、官方仓库与源码;
3. 维护者或研究机构的技术文章;
4. 能补充实践细节的高质量博客或文章。
Read the full skill on GitHub

Details

Skill name
better-notes
Path
better-notes/SKILL.md
License
MIT
Repo updated
27 October 2026

FAQ

What does the Better Notes skill do?

编写、整理或重写有事实依据的技术与知识笔记。用户要求“写笔记”“整理知识点”“做学习笔记”“写教程/概念说明”,尤其涉及 API、库、框架、论文、算法或可能随版本变化的内容时使用。笔记对象是论文时,按固定四部分模板写:研究现状和作者动机、方法简要介绍(带论文主图)、方法细节、实验。写作前必须先查阅网络上的官方文档、发布说明、论文、技术博客或文章,核对版本、弃用状态与替代方案;不能只凭模型记忆成文。输出简洁、直接,不用比喻,并把前置条件、输入、处理过程、输出、限制和来源说清楚。笔记保存在 Obsidian 库时,用 Datacore 的 JSX 交互组件取代 Mermaid 图,并在有助于理解处补充小组件。不用于仅做文字校对,或逐字整理用户提供的私人会议记录。

How do I install the Better Notes skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add HOWILLMAKEIT/skills --skill better-notes. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Better Notes popular?

It lives in HOWILLMAKEIT/skills, which has 9 GitHub stars and 0 forks.

Related skills

AI Paper Writing

9

HOWILLMAKEIT/skills

辅助 AI 论文写作,分两类任务。一是论文主图、方法图、机制图和图形摘要:搜集顶会同类型参考图,写网页生图提示词,用户手动生图后重建为原生可编辑 PPT。二是摘要、Introduction、实验等文字段落:先搜集相关领域顶会的对应段落到文件夹(md),暂停;用户需要时再阅读并总结写法与共同逻辑,暂停;再按总结的逻辑顺序,结合用户提供的代码和论文草稿完成写作。文字写作的三步各自暂停,等用户确认后才进入下一步。实测数据图应从真实数据绘制。

AI, LLMs & Agents

Better Decision

9

HOWILLMAKEIT/skills

帮助用户在多个合理任务之间确定当前优先级,把决策转为可验证的行动。用户说“每天很忙但重要的事没动”“不知道先做什么”“一直准备却没开始”“是不是在用学习或规划逃避”“帮我取舍、找主要矛盾”或要求用 better-decision 分析时使用。区分生产性逃避、必要准备、真实阻塞与合理休息,结合目标、期限、依赖、延迟代价和反馈选择下一步。不用于替用户决定人生价值,不替代医疗、法律、投资等专业判断;任务已明确且只要求执行时,不额外启动决策分析。

Other

Project Building

9

HOWILLMAKEIT/skills

建立和持续维护项目的工作方式与文档体系。用户要求创建 AGENTS.md、建立 docs、整理项目交接、沉淀开发或实验流程,或按已有项目规范推进工作时使用。编写或修改文档必须使用内置的 better-notes,核对来源、语言准确性和写作风格。适用于软件和研究项目;单纯概念问答、独立文件编辑或只读状态查询不因此自动触发项目文档写入。

Writing & Content

Mxl Core

9

TaoELi/MaxwellLink

This skill should be used when users need the canonical MaxwellLink workflow, including socket vs embedded coupling, units/time handling, and MPI/HPC invariants.

Productivity & Notes

Adapty Mail

9

adaptyteam/adapty-skills

Use when someone wants to work in Adapty Mail — email campaigns or sequences, email flows on triggers like never purchased, expired, refunded, billing issue or renewal cancelled, trial-conversion or win-back emails, translating emails, a sending domain and its DNS records, deliverability, bounces, unsubscribes or suppression, double opt-in, email A/B tests, open, click, conversion or email revenue numbers, or why someone did not get an email. Also use when someone wants to connect the Adapty Mail MCP server to their agent, or a Mail tool call fails with an authentication error.

Productivity & Notes

Mxl Index

9

TaoELi/MaxwellLink

This skill should be used when users ask how to set up, choose, or run a MaxwellLink simulation and the correct solver/driver/HPC/post-processing workflow must be selected.

Productivity & Notes

Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.