writing-shape SKILL.md skillA

writing-shape from vinvcn/mattpocock-skills-zh-cn is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add vinvcn/mattpocock-skills-zh-cn/writing-shape@git:20260921.49ef591

Pins git:20260921.49ef591 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/in-progress/writing-shape/SKILL.md
Versions recorded
5
Latest version
git:20260921.49ef591, committed Sep 21, 2026
First version recorded
Jul 4, 2026
Size
6,035 bytes
Repository stars
5,110
License
MIT

Writing, exploit:把原始素材塑造成文章,一段一段地推进。.

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

<what-to-do>

用户已经传入(或将传入)一份 raw material markdown 文件。把它当作 input pile:它可以是整齐的 fragments 列表、无结构 prose 墙、transcript,任何格式都可以。先完整读完,再做其他事。

然后运行一个 shaping session,产出一份独立的 article document。这是 **exploit**:探索已经完成,pile 已固定——承诺一个结构,并挖掘 pile 来填充它。不要编辑 raw material 文件;对这个 skill 来说它是 read-only。

如果用户没有说明文章保存路径,只询问一次并记住路径。

</what-to-do>

<supporting-info>

## The loop

1. **Read the pile.** 完整读取 input file,形成对内容的整体感。
2. **Establish the prerequisites.** 与用户确定读者进场时知道什么——那些从一开始就已 **grounded** 的概念。其它一切都必须先被某个 block grounded,之后的 block 才能依赖它。见 [Grounding](#grounding)。
3. **Draft 2-3 candidate openings.** 每个 opening 都应暗示文章的不同 thesis 或 angle。全部展示出来,迫使用户选择或组合 hybrid。选定的 opening 定义整篇文章接下来必须完成什么。
4. **Grow paragraph by paragraph.** Opening 落地后,问 “given this opening, what does the reader need to hear next?” 从 pile 中抽取 material 回答。下一个 block 只能依赖已 grounded 的概念,并在落地时 grounded 新的概念。讨论下一 block 应该是 paragraph、list、table、callout、quote 还是 code block。每个格式选择都应该 deliberate 且 defensible。
5. **Append to the article file as you go.** 不要 batch。每个达成一致的 paragraph 或 block 立即写入,让用户看到文章成形。
6. **Loop step 4 until the article is done.** 用户决定何时完成。

## Grounding
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add vinvcn/mattpocock-skills-zh-cn/writing-shape@sha256:66aaede46c1473fc

The line at the top of this page pins the label git:20260921.49ef591, 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_tsagay4av4qfpvyj.svg)](https://markdownregistry.com/a/art_tsagay4av4qfpvyj)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Jul 4, 2026 and Sep 21, 2026, about one every 20 days.

versioncommittedcommitsizeaudit
git:20260921.49ef591 latest2026-09-21 49ef591 6,035 BA view · diff
git:20260723.a9147dc2026-07-23 a9147dc 6,036 BA view · diff
git:20260722.fb10cdb2026-07-22 fb10cdb 6,034 BA view · diff
git:20260722.dbe24e92026-07-22 dbe24e9 4,454 BA view · diff
git:20260704.c71ad542026-07-04 c71ad54 4,423 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6035 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

GitHub

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_tsagay4av4qfpvyj
GET https://markdownregistry.com/api/v1/resolve?ref=vinvcn/mattpocock-skills-zh-cn/writing-shape
GET https://markdownregistry.com/api/v1/blob/66aaede46c1473fc923b8b8a69d80fb8e111ec3276dafa86612e35408a62ec90

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

translate-skill SKILL.md skill
vinvcn/mattpocock-skills-zh-cn · .skills/translate-skill/SKILL.md · 将 mattpocock/skills 的内容翻译、刷新或复核到简体中文本地化仓库 vinvcn/mattpocock-skills-zh-CN 时使用这个项目级 skill。适用于 skill files、README…
git:20261008.5be0dc1 · audit A · 5,110 stars
AGENTS.md AGENTS.md file
vinvcn/mattpocock-skills-zh-cn · AGENTS.md
git:20261008.f659bb3 · audit A · 5,110 stars
CLAUDE.md CLAUDE.md file
vinvcn/mattpocock-skills-zh-cn · CLAUDE.md
git:20261008.f659bb3 · audit A · 5,110 stars
ask-matt SKILL.md skill
vinvcn/mattpocock-skills-zh-cn · skills/engineering/ask-matt/SKILL.md · 询问当前情境适合哪个技能或流程;它是本仓库所有 skills 的路由器。
git:20261008.5be0dc1 · audit A · 5,110 stars
code-review SKILL.md skill
vinvcn/mattpocock-skills-zh-cn · skills/engineering/code-review/SKILL.md · 从固定点(commit、branch、tag 或 merge-base)开始,按 Standards(代码是否符合本仓库记录的编码标准?)和 Spec(代码是否符合来源 issue/spec…
git:20261008.5be0dc1 · audit A · 5,110 stars
codebase-design SKILL.md skill
vinvcn/mattpocock-skills-zh-cn · skills/engineering/codebase-design/SKILL.md · 用于设计深模块的共享词汇。适用于用户想设计或改进模块接口、寻找深化机会、决定 seam 放在哪里、让代码更容易测试或更适合 AI 导航,或其他技能需要深模块词汇时。
git:20261008.5be0dc1 · audit A · 5,110 stars
diagnosing-bugs SKILL.md skill
vinvcn/mattpocock-skills-zh-cn · skills/engineering/diagnosing-bugs/SKILL.md · 面向棘手缺陷和性能回退的诊断循环。适用于用户说 “diagnose” / “debug this”,或报告某些东西 broken、throwing、failing、slow 时。
git:20261008.5be0dc1 · audit A · 5,110 stars
domain-modeling SKILL.md skill
vinvcn/mattpocock-skills-zh-cn · skills/engineering/domain-modeling/SKILL.md · 构建并打磨项目的领域模型。适用于讨论 codebase 术语、编写或编辑 GLOSSARY.md,或记录或编辑 ADR。
git:20261008.5be0dc1 · audit A · 5,110 stars
grill-with-docs SKILL.md skill
vinvcn/mattpocock-skills-zh-cn · skills/engineering/grill-with-docs/SKILL.md · 一个用来打磨计划或设计的持续追问式访谈,并在过程中创建文档(ADRs 和词汇表)。
git:20260921.49ef591 · audit A · 5,110 stars
implement-spec SKILL.md skill
vinvcn/mattpocock-skills-zh-cn · skills/engineering/implement-spec/SKILL.md · 在代码中实现 /to-spec 和 /to-tickets 的产出。
git:20261008.5be0dc1 · audit A · 5,110 stars
implement SKILL.md skill
vinvcn/mattpocock-skills-zh-cn · skills/engineering/implement/SKILL.md · 基于 spec 或 ticket 集合实现一段工作。
git:20260722.fb10cdb · audit A · 5,110 stars
improve-codebase-architecture SKILL.md skill
vinvcn/mattpocock-skills-zh-cn · skills/engineering/improve-codebase-architecture/SKILL.md · 扫描代码库中的深化机会,生成可视化 HTML 报告,然后围绕你选中的候选项继续追问。
git:20261008.5be0dc1 · audit A · 5,110 stars

Every file in vinvcn/mattpocock-skills-zh-cn

Other files named writing-shape

writing-shape SKILL.md skill
vodailocz/kilo-kit-mcp · skills/productivity/writing-shape/SKILL.md · Writing, exploit: shape raw material into an article, paragraph by paragraph.
git:20260821.05c0d52 · audit A · 28 stars
writing-shape SKILL.md skill
mambo-wang/codewiki-plus · .codebuddy/skills/writing-shape/SKILL.md · Writing, exploit: shape raw material into an article, paragraph by paragraph.
git:20260916.5a385b8 · audit A · 20 stars
writing-shape SKILL.md skill
mambo-wang/codewiki-plus · .trae/skills/writing-shape/SKILL.md · Writing, exploit: shape raw material into an article, paragraph by paragraph.
git:20260916.5a385b8 · audit A · 20 stars
writing-shape SKILL.md skill
shumingyang-opencode/mattpocock-skills-zh-tw · skills/in-progress/writing-shape/SKILL.md · 寫作、開採 — 將原始素材一段一段地塑造成文章。
git:20260806.5bfe60b · audit A · 3 stars

Browse by kind, by grade A, or by owner.