Writing Beats
- 1.9k installs
- 2.8k repo stars
- Updated July 27, 2026
- vinvcn/mattpocock-skills-zh-cn
writing-beats is an agent skill that turns a raw-material markdown pile into a publishable article one narrative beat at a time with choose-your-own-adventure pivot options.
About
writing-beats is a skill from vinvcn/mattpocock-skills-zh-cn that shapes articles as a journey of beats in choose-your-own-adventure style. The agent presents 2-3 candidate starting beats from raw material, writes only the selected beat to the article file, re-reads from disk, then offers 2-3 next-beat pivot options until the piece ends naturally. Each beat sets a scene, lands a point, asks a question, or inserts aside—one narrative step at a time. Developers with raw fragments from writing-fragments reach for writing-beats when they want narrative assembly rather than argumentative structure. The skill asks for the article save path once if not provided, then loops write-read-offer until completion.
- Beat-by-beat loop: offer 2–3 starting beats, write only the chosen one, then offer next pivots
- Re-reads the article file from disk after every beat to avoid drift
- Treats raw markdown as a quarry—paraphrase, split, recombine, or quote
- Enforces one beat per turn (no writing ahead) until the journey ends naturally
- Optional one-time ask for article save path if the user did not provide it
Writing Beats by the numbers
- 1,877 all-time installs (skills.sh)
- +230 installs in the week ending Aug 2, 2026 (Skillselion tracking)
- Ranked #309 of 1,879 Marketing & SEO skills by installs in the Skillselion catalog
- Data as of Aug 3, 2026 (Skillselion catalog sync)
npx skills add https://github.com/vinvcn/mattpocock-skills-zh-cn --skill writing-beatsAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 1.9k |
|---|---|
| repo stars | ★ 2.8k |
| Last updated | July 27, 2026 |
| Repository | vinvcn/mattpocock-skills-zh-cn ↗ |
How do you write an article beat by beat?
Turn a raw-material markdown pile into a publishable article one narrative beat at a time, with the reader choosing pivots like choose-your-own-adventure.
Who is it for?
Developers who already have raw-material markdown and want to assemble a narrative article with interactive beat-by-beat pacing.
Skip if: Users without raw material yet, or writers who need argumentative essay structure with a fixed outline upfront.
When should I use this skill?
The user has raw material markdown and wants to assemble it as a narrative journey with beat-by-beat choices.
What you get
Publishable article markdown built incrementally with user-chosen narrative beats from raw source material.
- Publishable article markdown file
By the numbers
- Offers 2-3 candidate beats at each starting and pivot decision point
Files
<what-to-do>
用户已经传入（或将传入）一份 raw material markdown 文件。
如果用户没有说明文章保存路径，只询问一次并记住路径。
然后运行 beat-by-beat journey：
1. 从 raw material 中写出 2-3 个候选 starting beats。每个都是进入文章的不同入口。先展示给用户，用户选一个。预览写下这个 beat 后可能通向哪些 beats，就像让用户先看到路径前方一点点。 2. 用户选定 starting beat 后，只把那个 beat写入文章文件。一个 beat 可以是一句话，也可以是几段，按它自然需要的长度来。写完就停。 3. 从磁盘重新读取文章文件。然后提供 2-3 个候选 next beats，也就是文章当前可以 pivot 的不同方向。 4. 循环步骤 2-4，直到文章自然结束。
</what-to-do>
<supporting-info>
What is a beat
Beat 是 journey 中的一步。它只做一件事：设定场景、落下一个观点、提出问题、插入 aside、扭转角度。然后停下，把读者留在一个下一个 beat 可以 pivot 的位置。
Beat 的大小由它需要完成的动作决定：
- 如果动作只有一句话，那就是一句话（"And then nothing happened for three weeks."）。
- 如果需要 setup，就是一个短段落。
- 如果 beat 是自洽的 vignette、argument 或 example，可以是多段。
如果一个 “beat” 需要五段和三个 subheadings，它就不是 beat，而是两个粘在一起的 beats。拆开。
Writing one beat
一旦选定 beat，只把_那个 beat_写入文章文件。不要写下一个 beat。
从 raw pile 中抽取 material 来填充 beat。你可以 paraphrase、split、recombine 或 quote。这个 pile 是 quarry。
Ending the journey
文章在 journey 完成时结束，不是在 pile 用完时结束。大多数 piles 都会剩下没有用进去的 fragments。这没关系；raw material 多于实际需要正是重点。
Writing rhythm
- 一次追加一个 beat。永远不要提前写。
- 每次写入前都从磁盘重新读取文章文件。绝对保留用户 edits。
- 如果用户大幅编辑了之前的 beat，让它改变接下来要写什么。
- 如果用户说 "rewrite that beat" 或 "go back and try a different beat 3"，照做：就地编辑，别动其余部分。
</supporting-info>
Related skills
Seo AuditRun structured SEO audits on their SaaS site or content hub and receive a prioritized action plan.173k42.2kCopywritingGenerate, rewrite, or strengthen persuasive website and landing-page copy that converts visitors into users.164k42.2k
Viral Short FormQuickly generate high-retention hooks, scripts, and outlines for TikTok, Reels, YouTube Shorts, and carousels.132k67Viral HooksWrite and critique viral hooks for short-form video opening sequences.123k67Viral Captions And CtasOptimize social media captions and CTAs for viral short-form video reach and saves.123k67Viral Youtube ShortsWrite and diagnose YouTube Shorts for Shorts Feed and long-form funnel.123k67How it compares
Use writing-beats after raw material exists; start with writing-fragments when ideation and fragment collection have not happened yet.
FAQ
What input does writing-beats require?
writing-beats requires a raw-material markdown file the user provides or will provide. If no article save path is given, the skill asks once and remembers it for the session.
How does writing-beats differ from writing-fragments?
writing-fragments collects unstructured ideation nuggets without outlines. writing-beats takes existing raw material and assembles a publishable article beat by beat with 2-3 pivot options after each section.