writing-for-agents SKILL.md skillA
writing-for-agents from vinvcn/mattpocock-skills-zh-cn is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add vinvcn/mattpocock-skills-zh-cn/writing-for-agents@git:20261008.5be0dc1Pins git:20261008.5be0dc1 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- vinvcn/mattpocock-skills-zh-cn
- Path
skills/productivity/writing-for-agents/SKILL.md- Versions recorded
- 3
- Latest version
- git:20261008.5be0dc1, committed Oct 8, 2026
- First version recorded
- Aug 11, 2026
- Size
- 11,137 bytes
- Repository stars
- 5,110
- License
- MIT
为 agent 编写文档。适用于创建或编辑 skills，或修改 AGENTS.md 或 CLAUDE.md 时。.
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
为 agent 消费的任何文档提供参考：一个 skill、一个 `AGENTS.md` / `CLAUDE.md`、一个经 pointer 触达的文档。包装方式不同；写作本身并无不同：同样的杠杆让每一份都变得可预测：agent 每次运行都采取相同的 _process_，而不是产出相同的 output。 当你写的文档是 skill 时，阅读 [`SKILL-MECHANICS.md`](SKILL-MECHANICS.md) 了解 frontmatter、invocation 选择以及 router skills。 ## Context pointers **context pointer** 是 agent context 中持有的一个 reference，它命名某个 context 之外的材料，并对触达它的条件进行编码。某个 skill 的 description 就是其一；`AGENTS.md` 中命名某个文档的一行是同一个对象。决定 agent 何时以及多可靠地触达材料的，是指针的 _措辞_，而不是它的目标。一个必须是目标的、却由措辞薄弱的 pointer 承载的内容，是一个 variance bug：先打磨措辞，只有打磨失败时才内联该材料。 一个 pointer 做两件事：说明材料是什么，并列出应触发触达它的 **branches**（一个 branch 是文档处理的一个独立情形，所以不同的 runs 会沿不同的路径穿过它）。一个始终加载的 pointer 的每个词都会在每一轮付出成本，所以它比正文更该被大力修剪： - **把 leading word 放到最前面**：pointer 是它做触发工作的地方。 - **每个 branch 一个 trigger。** 如果同义词只是重命名单一 branch，那就是同一个 branch 写了两遍；合并它们，只保留真正不同的 branches。 - **删掉正文已经承载的 identity。** ## 两种 load 你添加的每个文档和 pointer 都会花掉两个预算之一： - **Context load**：始终加载的材料对 agent window 的成本：一行 `AGENTS.md`、一个 skill description、任何每轮都躺在 context 里的东西，无论是否触发都要花 tokens 和注意力。 - **Cognitive load**：对人类的成本：存在哪些文档、何时伸手去取每一份。人类就是 index。这不是要最小化的成本，它是 human agency 的代价；把它花在人的判断起作用的地方，在它不起作用的地方移除它。 …
Read the whole file at its exact version.
How to install
mdr add vinvcn/mattpocock-skills-zh-cn/writing-for-agents@sha256:a3f5f8300b0247adThe line at the top of this page pins the label git:20261008.5be0dc1, 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_x2fxhf5lh6gmo2yd)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 3 versions of this file, between Aug 11, 2026 and Oct 8, 2026, about one every 29 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261008.5be0dc1 latest | 2026-10-08 | 5be0dc1 | 11,137 B | A | view · diff |
| git:20261008.f659bb3 | 2026-10-08 | f659bb3 | 11,150 B | A | view · diff |
| git:20260811.b46e155 | 2026-08-11 | b46e155 | 11,267 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 (11137 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
vinvcn/mattpocock-skills-zh-cn · 5,110 stars · license MIT · pushed 2026-10-20 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_x2fxhf5lh6gmo2yd GET https://markdownregistry.com/api/v1/resolve?ref=vinvcn/mattpocock-skills-zh-cn/writing-for-agents GET https://markdownregistry.com/api/v1/blob/a3f5f8300b0247ada906e9104fc4c5e33db1400ae44997c5e5516204cdefcef2
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 vinvcn/mattpocock-skills-zh-cn
Every file in vinvcn/mattpocock-skills-zh-cn