adhd-md SKILL.md skillA
adhd-md from tsonglew/adhd-md is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add tsonglew/adhd-md/adhd-md@git:20261019.50e6d63Pins git:20261019.50e6d63 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- tsonglew/adhd-md
- Path
skill/SKILL.md- Versions recorded
- 5
- Latest version
- git:20261019.50e6d63, committed Oct 19, 2026
- First version recorded
- Oct 9, 2026
- Size
- 18,608 bytes
- Repository stars
- 43
- License
- MIT
把 Markdown 文档改造成 ADHD 友好、可扫读的版本，可选择只改格式、只改内容或两者兼改，并用脚本检查已定义的信息不变量。也能自动提取网页、HTML、PDF 与扫描件的正文，保留来源，逐段陪读已有文档、解释重点、暂停续读，或生成离线专注阅读页。Use when the user asks to make a document ADHD-friendly, more skimmable, or easier to read; when they say 文档太长看不下去 / 排版太密 / 全是大段文字 / 帮我把这个文档改得好读一点 / 优化一下排版; or asks to audit, lint, or restructure Markdown for readability. Triggers include ADHD friendly, ADHD 友好, 注意力友好, 可扫读, skimmable, wall of text, 文字墙, 大段文字, 改排版, 重排文档, make this readable, 陪我读, 带我读, 读不进去, 从上次继续, focus…
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
# adhd-md 把 Markdown 改造成 ADHD 友好的样子：结论前置、段落切碎、句子变短、动作明确、噪音归零。 **铁律：只重排信息，绝不删信息。** 篇幅太长就折叠或移到附录，不许删。违反这条，其他做得再好都是失败。 也可以保留原文，陪用户一次读一小段，或生成可在浏览器打开的离线阅读页。 ## 什么时候用 用户给了一个 Markdown 文件（或一段 Markdown），希望它更好读、更好扫、更适合注意力容易断的人。 用户想读懂已有文档、长文或笔记时，使用 `mode=read`。直接粘贴的文本也能陪读。 网页链接、本地 HTML 和 PDF 可通过 `read` 自动提取后阅读，或用 `extract` 另存为 Markdown；PDF 与扫描件需要本机的提取或 OCR 工具。没有 shell 时使用宿主读取能力，按来源标出缺口。 不适用的情况： - 改写模式的输入不是 Markdown（先转换，或直接拒绝） - 用户要的是**内容审查**（事实核查、逻辑校对）—— 那不是这个 skill - 用户要的是**翻译**或**扩写** —— 都不是 ## 先选模式 | mode | 做什么 | 用户会怎么说 | |---|---|---| | `edit` | 改写或审计 Markdown，走下方工作流 | 改排版 / 帮我改得好读一点 / 审计 | | `read` | 保留原文，逐段陪读或生成阅读页 | 陪我读 / 带我读 / 读不进去 / 从上次继续 | `mode=read` 先读 [references/reading.md](references/reading.md)，按其中的陪读或阅读页流程执行。单文件版对应附录 D。不要运行 `fmt --write`，不要给原文打分后自动改写。 用户只想开始阅读时，直接从第一小段开始；有阅读目标就用，没有也能开始。明确要求两个功能时，生成阅读页并开始第一段陪读。 有 shell 时用 `read --json` 取得阅读会话和分段位置；阅读页与对话共用 JSON 书签。没有 shell 时继续用纯文本书签。 携带书签时用 `read --session bookmark.json --json` 核对原文，回看保留待读位置；原文不匹配时保留旧书签，不猜测重定位。 生成阅读页时可加 `--open`，成功后尝试打开浏览器；打开失败保留文件并给出路径。书签字段、导入导出与暂停规则见陪读流程。 下方的 `scope`、`level`、改写工作流和输出契约仅用于 `mode=edit`。用户只说「优化一下」时保留原有默认值。 ## 改写的两个参数 ### scope：改什么 | 值 | 边界 | 用户会怎么说 | |---|---|---| …
Read the whole file at its exact version.
How to install
mdr add tsonglew/adhd-md/adhd-md@sha256:06a8f2d1f01478faThe line at the top of this page pins the label git:20261019.50e6d63, 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_kv2kkg3gpdac6yam)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Oct 9, 2026 and Oct 19, 2026, about one every 2 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261019.50e6d63 latest | 2026-10-19 | 50e6d63 | 18,608 B | A | view · diff |
| git:20261014.3c5386c | 2026-10-14 | 3c5386c | 18,126 B | A | view · diff |
| git:20261013.8fba851 | 2026-10-13 | 8fba851 | 15,369 B | A | view · diff |
| git:20261009.3c8b1fb | 2026-10-09 | 3c8b1fb | 11,069 B | A | view · diff |
| git:20261009.0e7eea1 | 2026-10-09 | 0e7eea1 | 10,843 B | A | view |
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 (18608 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
tsonglew/adhd-md · 43 stars · license MIT · pushed 2026-10-19 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_kv2kkg3gpdac6yam GET https://markdownregistry.com/api/v1/resolve?ref=tsonglew/adhd-md/adhd-md GET https://markdownregistry.com/api/v1/blob/06a8f2d1f01478fa82f2210f112f682e236316a7fdcb09dace4e369464199407
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.