how-to-write SKILL.md skillA
how-to-write from webkubor/writing-standard-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add webkubor/writing-standard-skills/how-to-write@git:20261025.fb9d7b8Pins git:20261025.fb9d7b8 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- webkubor/writing-standard-skills
- Path
skills/how-to-write/SKILL.md- Versions recorded
- 3
- Latest version
- git:20261025.fb9d7b8, committed Oct 25, 2026
- First version recorded
- Sep 10, 2026
- Size
- 10,983 bytes
- Repository stars
- 6
- License
- MIT
「怎么写文字」的总纲——先按金字塔原理搭骨架（结论先行 / SCQA / MECE），再按读者定语气（人还是 agent、上级还是同侧），最后必须以新读者身份通读自检。管一切要给别人看的文字：文档、单据、报告、评审意见、讲稿、群消息、PR 描述。触发："写文档 / 写报告 / 提单 / 写评审意见 / 文案不合理 / 逻辑不清 / 这样礼貌吗 / 结论说不清 / 讲稿检查"。.
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
# 怎么写文字 一切要给别人看的文字，按同一个顺序做四件事。**顺序不能换**——结构错了改字没用，语气对了但结论找不到也没用。 ``` ① 搭骨架 金字塔原理：结论先行 · SCQA · MECE ② 定读者 给人 or 给 agent；上级 or 同侧 ③ 调语气 归因情境 · 自曝先行 · 认对方贡献 · 允许被推翻 ④ 当读者 以第一次看的人的身份通读全文，带清单查错 ``` 跳过任何一步的代价，在文末「三个真实案例」里有实测数字。 --- ## ① 搭骨架：金字塔原理 ### 结论先行 读者的第一个问题永远是「结论是什么、要不要我动」。答案放第一屏，证据放后面供下钻。 **检验**：只读前五行，读者知不知道结论和自己要做什么。 ### SCQA：开篇四句带上下文 | | 写什么 | 关键 | |---|---|---| | **S** 情境 | 对方**已知**的事实 | 必须是共识，写成「我做了 X」就变自述 | | **C** 冲突 | 发生了什么变化让现状不成立 | 这是读者继续读下去的动力 | | **Q** 疑问 | 因此自然产生的问题 | 通常不用写出来，但心里要有 | | **A** 答案 | 你的结论，一句话 | 这句话就是全文的塔尖 | ### MECE：分组不重不漏 - **相互独立**：任何一条内容只出现在一个分组里。同一件事写两处，读者不知哪份准，改一处另一处立刻过期。 - **完全穷尽**：分组加起来覆盖全部。**每次分组后做一次加法**——说「7 条」却只列 6 条是最常见的翻车。 ### 以上统下 + 逻辑递进 标题必须是它下面所有内容的概括；同层条目按一个明确顺序排（严重度 / 时间 / 责任方），选一个并贯彻。 --- ## ② 定读者 ### 给人读 vs 给 agent 读——两套写法，不要混 | 维度 | 给人 | 给 agent | |---|---|---| | 首要目标 | 知道发生了什么、要不要他动 | 能照做且不跑偏 | | 开头 | 结论 + 是否需要他处理 | 触发条件 + 禁止项 | | 语气 | 留余地、给台阶 | 命令式**正确**，越硬越少歧义 | | 详略 | 只给影响判断的信息 | 穷举边界与反例，宁长不漏 | | 数据 | 结论化（「93 个模型被漏掉」） | 可复现（完整命令、参数、期望值） | | 礼貌 | 必要 | 无意义，浪费 token | **检验**：删掉所有代码块和参数，人读段还成立吗？删掉所有解释句，agent 段还能照做吗？ ### 对上 vs 对同侧 - **对上（你的老板 / owner）**：极简，结论先行，不铺过程，客套是噪声。 …
Read the whole file at its exact version.
How to install
mdr add webkubor/writing-standard-skills/how-to-write@sha256:737eab2f447e95b2The line at the top of this page pins the label git:20261025.fb9d7b8, 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_wg5yi4ctjp3gpqs4)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 3 versions of this file, between Sep 10, 2026 and Oct 25, 2026, about one every 23 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261025.fb9d7b8 latest | 2026-10-25 | fb9d7b8 | 10,983 B | A | view · diff |
| git:20260926.5283a19 | 2026-09-26 | 5283a19 | 10,517 B | A | view · diff |
| git:20260910.b68d609 | 2026-09-10 | b68d609 | 10,081 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 (10983 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
webkubor/writing-standard-skills · 6 stars · license MIT · pushed 2026-11-06 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_wg5yi4ctjp3gpqs4 GET https://markdownregistry.com/api/v1/resolve?ref=webkubor/writing-standard-skills/how-to-write GET https://markdownregistry.com/api/v1/blob/737eab2f447e95b2e7922fb6e09e3af887579341ecbed365dce2d3a4752f0ca3
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.