
Writing Beats
This turns your raw notes into a finished article by writing one beat at a time and letting you steer at each step. You feed it a pile of material, it shows you 2-3 possible opening beats, you pick one, and it writes just that section. Then it stops, reloads the file to catch any edits you made, and offers the next 2-3 directions. A beat can be a single sentence or several paragraphs, whatever the moment needs. It's for when you have the material but want to assemble it as narrative rather than argument. The journey ends when the piece feels complete, not when you've used every scrap in the pile.
- skills.sh installs
- 3.7K
- GitHub stars
- 5.7K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add vinvcn/mattpocock-skills-zh-cn --skill writing-beats --agent claude-codeInstalls into .claude/skills of the current project.
Files
用户已经传入(或将传入)一份 raw material markdown 文件。这是 exploit:探索已经完成,pile 已固定——承诺一条穿过它的路径,并挖掘 pile 来填充每个 beat。
如果用户没有说明文章保存路径,只询问一次并记住路径。
然后以自选路径(choose-your-own-adventure)风格运行 beat-by-beat journey:
- Establish the prerequisites. 在任何 beat 之前,先与用户确定受众进场时已经知道什么——那些从一开始就已 grounded 的概念。其它一切都必须先被某个 beat grounded,之后的 beat 才能使用它。见 Grounding。
- 从 raw material 中写出 2-3 个候选 starting beats。每个都是进入文章的不同入口。每个都只能依赖已 grounded 的概念;记下每个 beat 新 grounded 了哪些概念。在写入文章文件之前先把这些 beats 展示给用户。用户选一个。预览选定这个 beat 后会解锁哪些 beats——就像让用户先看到路径前方一点点。
- 用户选定 starting beat 后,只把那个 beat写入文章文件。一个 beat 可以是一句话,也可以是几段,按它自然需要的长度来。写完就停。
- 从磁盘重新读取文章文件。然后提供 2-3 个候选 next beats——也就是从文章当前所在位置,journey 可以 pivot 的不同方向。每个都必须能从当前已 grounded 的集合到达;记下每个 beat grounded 了什么。
- 循环步骤 3-5,直到文章自然结束。
Grounding
每个 concept 都必须先被 grounded,某个 beat 才能依赖它:受众要么进场时就知道它,要么在更早的 beat 中遇到过它。一个伸手去抓未 grounded 概念的 beat 会失去读者——这是 journey 唯一不能做的动作。单位是 concept,而不是它的措辞:即便眼前没有任何术语,一个 beat 也可能依赖一个读者并不具备的 idea。当一个概念有名字——一个 term——grounded 它意味着让这个 idea 和这个 term 一起落地。
一个概念通过两种方式之一被 grounded:
Sponsors
Details
- Repository
- github.com/vinvcn/mattpocock-skills-zh-cn
- Category
- Documentation
- First seen
- Jul 14, 2026
More from vinvcn/mattpocock-skills-zh-cn
All 39- Resolving Merge Conflicts3.5K
- To Prd2.2K
- Design An Interface2.1K
- To Issues2.1K
- Qa2.1K
- Edit Article2.1K
- Obsidian Vault2.1K
- Request Refactor Plan2.1K
- Ubiquitous Language2.1K
- Writing Great Skills2.1K
- Diagnose1.7K
- Caveman1.7K
- Zoom Out1.7K
- Write A Skill1.7K
- Review911
- Grill Me6.9K
- Grill With Docs6.6K
- Setup Matt Pocock Skills6.2K
- Handoff6.1K
- Tdd6.1K
- Improve Codebase Architecture6.1K
- Prototype6K
- Triage5.8K
- Git Guardrails Claude Code5.7K