Better Notes
编写、整理或重写有事实依据的技术与知识笔记。用户要求“写笔记”“整理知识点”“做学习笔记”“写教程/概念说明”,尤其涉及 API、库、框架、论文、算法或可能随版本变化的内容时使用。笔记对象是论文时,按固定四部分模板写:研究现状和作者动机、方法简要介绍(带论文主图)、方法细节、实验。写作前必须先查阅网络上的官方文档、发布说明、论文、技术博客或文章,核对版本、弃用状态与替代方案;不能只凭模型记忆成文。输出简洁、直接,不用比喻,并把前置条件、输入、处理过程、输出、限制和来源说清楚。笔记保存在 Obsidian 库时,用 Datacore 的 JSX 交互组件取代 Mermaid 图,并在有助于理解处补充小组件。不用于仅做文字校对,或逐字整理用户提供的私人会议记录。
Install
npx skills add HOWILLMAKEIT/skills --skill better-notesgit clone --depth 1 https://github.com/HOWILLMAKEIT/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/better-notes ~/.claude/skills/better-notesPersonal 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. 能补充实践细节的高质量博客或文章。
Details
- Skill name
better-notes- Repository
- HOWILLMAKEIT/skills
- 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
9HOWILLMAKEIT/skills
辅助 AI 论文写作,分两类任务。一是论文主图、方法图、机制图和图形摘要:搜集顶会同类型参考图,写网页生图提示词,用户手动生图后重建为原生可编辑 PPT。二是摘要、Introduction、实验等文字段落:先搜集相关领域顶会的对应段落到文件夹(md),暂停;用户需要时再阅读并总结写法与共同逻辑,暂停;再按总结的逻辑顺序,结合用户提供的代码和论文草稿完成写作。文字写作的三步各自暂停,等用户确认后才进入下一步。实测数据图应从真实数据绘制。
Better Decision
9HOWILLMAKEIT/skills
帮助用户在多个合理任务之间确定当前优先级,把决策转为可验证的行动。用户说“每天很忙但重要的事没动”“不知道先做什么”“一直准备却没开始”“是不是在用学习或规划逃避”“帮我取舍、找主要矛盾”或要求用 better-decision 分析时使用。区分生产性逃避、必要准备、真实阻塞与合理休息,结合目标、期限、依赖、延迟代价和反馈选择下一步。不用于替用户决定人生价值,不替代医疗、法律、投资等专业判断;任务已明确且只要求执行时,不额外启动决策分析。
Project Building
9HOWILLMAKEIT/skills
建立和持续维护项目的工作方式与文档体系。用户要求创建 AGENTS.md、建立 docs、整理项目交接、沉淀开发或实验流程,或按已有项目规范推进工作时使用。编写或修改文档必须使用内置的 better-notes,核对来源、语言准确性和写作风格。适用于软件和研究项目;单纯概念问答、独立文件编辑或只读状态查询不因此自动触发项目文档写入。
Mxl Core
9TaoELi/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.
Adapty Mail
9adaptyteam/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.
Mxl Index
9TaoELi/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.
Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.