Skills for Real Engineers. Straight from my .agents directory.
How to install writing-shape
install writing-shape
# install the mattpocock-skills-zh-CN pack with the skills CLI
npx skills add vinvcn/mattpocock-skills-zh-CN# or add only this skill to Claude Code: copy the folder
skills/in-progress/writing-shape/
# into
~/.claude/skills/writing-shape/ (all projects)
.claude/skills/writing-shape/ (one project)
1<what-to-do>23用户已经传入(或将传入)一份 raw material markdown 文件。把它当作 input pile:它可以是整齐的 fragments 列表、无结构 prose 墙、transcript,任何格式都可以。先完整读完,再做其他事。45然后运行一个 shaping session,产出一份独立的 article document。这是 **exploit**:探索已经完成,pile 已固定——承诺一个结构,并挖掘 pile 来填充它。不要编辑 raw material 文件;对这个 skill 来说它是 read-only。67如果用户没有说明文章保存路径,只询问一次并记住路径。89</what-to-do>1011<supporting-info>1213## The loop14151. **Read the pile.** 完整读取 input file,形成对内容的整体感。162. **Establish the prerequisites.** 与用户确定读者进场时知道什么——那些从一开始就已 **grounded** 的概念。其它一切都必须先被某个 block grounded,之后的 block 才能依赖它。见 [Grounding](#grounding)。173. **Draft 2-3 candidate openings.** 每个 opening 都应暗示文章的不同 thesis 或 angle。全部展示出来,迫使用户选择或组合 hybrid。选定的 opening 定义整篇文章接下来必须完成什么。184. **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。195. **Append to the article file as you go.** 不要 batch。每个达成一致的 paragraph 或 block 立即写入,让用户看到文章成形。206. **Loop step 4 until the article is done.** 用户决定何时完成。2122## Grounding2324每个 **concept** 都必须先被 **grounded**,某个 block 才能依赖它:读者要么进场时就知道它,要么在更早的 block 中遇到过它。一个伸手去抓未 grounded 概念的 block 会失去读者。单位是 concept,而不是它的措辞——即便眼前没有任何术语,一个 block 也可能依赖一个读者并不具备的 idea。当一个概念有名字——一个 **term**——grounded 它意味着让这个 idea 和这个 term 一起落地。2526一个概念通过两种方式之一被 grounded:2728- **Prerequisite** —— 在 opening 之前就被 grounded。读者自带它。在开头就固定下来。29…
Excerpt shown under the repository's MIT license.
More skills in mattpocock-skills-zh-CN
Keep exploring
Similar skill repositories
39 skills
An agentic skills framework & software development methodology that works.
15 skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
CC1 skill
Public repository for Agent Skills
20 skills
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
CCCU6 skills
An AI skill that provides design intelligence for building professional UI/UX across multiple platforms.
CCCXCUGH6 skills
