better-notes SKILL.md skillA
This file is byte-identical to the first copy the registry indexed. Same content hash, so the same checks give both the same grade.
better-notes from howillmakeit/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add howillmakeit/skills/better-notes@git:20261027.b7972f3Pins git:20261027.b7972f3 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- howillmakeit/skills
- Path
project-building/references/better-notes/SKILL.md- Versions recorded
- 1
- Latest version
- git:20261027.b7972f3, committed Oct 27, 2026
- Size
- 14,690 bytes
- Repository stars
- 9
- License
- MIT
编写、整理或重写有事实依据的技术与知识笔记。用户要求“写笔记”“整理知识点”“做学习笔记”“写教程/概念说明”，尤其涉及 API、库、框架、论文、算法或可能随版本变化的内容时使用。笔记对象是论文时，按固定四部分模板写：研究现状和作者动机、方法简要介绍（带论文主图）、方法细节、实验。写作前必须先查阅网络上的官方文档、发布说明、论文、技术博客或文章，核对版本、弃用状态与替代方案；不能只凭模型记忆成文。输出简洁、直接，不用比喻，并把前置条件、输入、处理过程、输出、限制和来源说清楚。笔记保存在 Obsidian 库时，用 Datacore 的 JSX 交互组件取代 Mermaid 图，并在有助于理解处补充小组件。不用于仅做文字校对，或逐字整理用户提供的私人会议记录。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# 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 库内。 …
Read the whole file at its exact version.
How to install
mdr add howillmakeit/skills/better-notes@sha256:f9c35b255981ee7cThe line at the top of this page pins the label git:20261027.b7972f3, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_zod6gys6owtwr52i)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Oct 27, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (14690 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
howillmakeit/skills · 9 stars · license MIT · pushed 2026-10-27 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_zod6gys6owtwr52i GET https://markdownregistry.com/api/v1/resolve?ref=howillmakeit/skills/better-notes GET https://markdownregistry.com/api/v1/blob/f9c35b255981ee7c553f1e105b350c80a19d6d152d415960ca7ec8bc94b8586f
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.
More from howillmakeit/skills
Every file in howillmakeit/skills