Writing Shape

You've got a pile of notes, fragments, or a messy transcript, and you need to turn it into a coherent article. This skill reads your raw material file once, then walks you through shaping it into something publishable. It drafts two or three candidate openings with different angles, forces you to pick one, then grows the piece paragraph by paragraph. At every step it asks whether the next beat should be prose, a list, a table, a callout, or a quote, and it pushes back if your transitions are weak or a section hasn't earned its place. The raw material stays untouched as a read-only quarry. The conversational loop is deliberate: it's not just expanding your notes, it's making you defend what the article is actually arguing and in what order the reader needs to hear it.

skills.sh installs: 3.7K
GitHub stars: 5.7K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add vinvcn/mattpocock-skills-zh-cn --skill writing-shape --agent claude-code

Installs into .claude/skills of the current project.

Files

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

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

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

The loop

Read the pile. 完整读取 input file，形成对内容的整体感。
Establish the prerequisites. 与用户确定读者进场时知道什么——那些从一开始就已 grounded 的概念。其它一切都必须先被某个 block grounded，之后的 block 才能依赖它。见 Grounding。
Draft 2-3 candidate openings. 每个 opening 都应暗示文章的不同 thesis 或 angle。全部展示出来，迫使用户选择或组合 hybrid。选定的 opening 定义整篇文章接下来必须完成什么。
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。
Append to the article file as you go. 不要 batch。每个达成一致的 paragraph 或 block 立即写入，让用户看到文章成形。
Loop step 4 until the article is done. 用户决定何时完成。