writing-beats
Skill522 starsChanged 36 days agoMITView on GitHub
Writing, exploit : 将原始素材组装成一段节拍之旅,在节拍使用每个术语之前先将其夯实。
79 other projects use a version of this.
Adopted by
Most recently taken up by
- 5thlayer/skillworkstheir own version, first seen Nov 8, 2026
- dfirmin/compasstheir own version, first seen Nov 8, 2026
- op3616windows/skillstheir own version, first seen Nov 8, 2026
- miklschmidt/archboardtheir own version, first seen Nov 8, 2026
- Tresnanda/kyberntheir own version, first seen Nov 8, 2026
- ZeroTokenClaw/agents-skillstheir own version, first seen Nov 1, 2026
Used with
Projects with it also use obsidian-vault, batch-grill-me and 2 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
simo97Skillobsidian-vault
Also in 26 projects that use this
boyingliu01Skillbatch-grill-me
A relentless interview that asks every frontier question at once, round by round. Thin alias of `grilling` (#540) — upstream mattpocock/skills absorbed this protocol into grilling; XP-Gate keeps this name as the sprint-flow Phase 2 entry point so orchestration docs stay stable.
Also in 5 projects that use this
FabienDehopreSkilldecision-mapping
Turn a loose idea into a sequenced map of investigation tickets, then drive them to resolution one at a time.
Also in 4 projects that use this
GoogleSkillresolving-merge-conflicts
Use when you need to resolve an in-progress git merge/rebase conflict.
Also in 32 projects that use this
Other versions79 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 79
- mattpocock/skills★ 309ksame name
- vinvcn/mattpocock-skills-zh-CN★ 5.5ksame name
- InditexTech/weavejs★ 266same name
- loulanyue/skills★ 231same name
- tt-a1i/matt-skills-with-to-goal★ 192same name
- Tresnanda/kybern★ 83same name
- VoDaiLocz/kilo-kit-mcp★ 28same name
- WenWuZhiDao/mattpocock-skills-zh★ 27same name
- metrogg/AgentHub★ 19same name
- George-RD/design-studio★ 10same name
69 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository39 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- ask-mattSkill
- codebase-designSkill
- code-reviewSkill
- diagnosing-bugsSkill
- domain-modelingSkill
- grill-with-docsSkill
- implementSkill
- implement-specSkill
- improve-codebase-architectureSkill
- prototypeSkill
- prSkill
- researchSkill
- retroSkill
- setup-matt-pocock-skillsSkill
- tddSkill
- to-specSkill
- to-ticketsSkill
- triageSkill
- wayfinderSkill
- wizardSkill
- chief-of-staffSkill
- claude-handoffSkill
- loop-meSkill
- setup-ts-deep-modulesSkill
- software-factorySkill
- writing-fragmentsSkill
- writing-shapeSkill
- git-guardrails-claude-codeSkill
- migrate-to-shoehornSkill
- scaffold-exercisesSkill
- setup-pre-commitSkill
- grillingSkill
- grill-meSkill
- handoffSkill
- teachSkill
- to-questionnaireSkill
- wait-whatSkill
- writing-for-agentsSkill
The file
Files
<what-to-do>用户已经传入(或即将传入)一份 markdown 格式的原始素材文件。这是 exploit(利用):探索已经完成,素材堆已经固定:承诺一条路径穿行其中,然后开采素材堆来填充每个节拍。
如果用户没有说明文章保存到哪里,询问一次并记住路径。
然后进行逐拍推进的自选冒险式旅程:
- 设定先决条件。 在任何节拍之前,先与用户确定读者进入时已经知道什么:那些从一开始就被**夯实(grounded)**的概念。其他所有概念必须被某个节拍夯实后,后续节拍才能使用它。参见夯实(Grounding)。
- 从原始素材中提炼 2–3 个候选起始节拍。每个节拍是文章的一个不同入口。每个节拍只能依赖于已夯实的概念;注意每个节拍夯实了什么新概念。在写入文章文件之前先将节拍展示给用户看。用户选取一个。预览该节拍解锁了哪些后续节拍:让用户仿佛能看得到前方的一小段路。
- 用户选定起始节拍后,将仅这一拍写入文章文件。一个节拍可以是一句话,也可以是若干段:取决于该节拍自然需要多少篇幅。到此为止。
- 从磁盘重新读取文章文件。然后提供 2–3 个候选下一节拍:从文章当前所在位置可以转向的不同方向。每个候选节拍必须能从当前已夯实的集合中触及;注意每个节拍夯实了什么。
- 循环步骤 3–5,直到文章自然收尾。
</what-to-do><supporting-info>夯实(Grounding)
每个概念在被某个节拍使用之前必须被夯实:读者要么进入时就已了解它,要么在之前的节拍中遇到过它。一个触及未夯实概念的节拍会失去读者:这是旅程中唯一不能犯的错误。单位是概念,而非词语:一个节拍可以依赖读者缺乏的想法,即使完全没有行话。当某个概念有名称:一个术语(term):时,夯实意味着同时落地这个想法和它的术语。
概念通过两种方式之一被夯实:
- 先决条件(Prerequisite):在第一个节拍之前就被夯实。读者自带。在开始时固定。
- 引入(Introduced):某个节拍建立它,此后它对所有后续节拍都是已夯实的。
所以每个节拍承担两件事:它需要已经夯实的概念,同时它夯实新的概念。持续追踪当前已夯实的清单,并在每个节拍落地时更新它。
这正是塑造自选冒险的核心。一个候选节拍只有在其所需的全部概念都已夯实时才可触及;选择一个夯实了概念 X 的节拍,就会解锁所有等待 X 的节拍。当你提供下一节拍时,它们都必须能从当前已夯实的集合中触及:并且说明每个节拍夯实了什么,让用户能看到它打开了哪些路径。
最大的杠杆在于你把什么设为先决条件,与你在文章内部夯实什么之间的取舍。要求太多前置知识会把不具备的读者挡在门外;在内部夯实太多又会让早期节拍淹没在定义中。在设定先决条件时与用户商议这一点,并在某个诱人的节拍突然需要某个尚未被任何内容夯实的概念时重新审视:解决方法要么是在它之前加一个夯实节拍,要么将该概念提升为先决条件。
什么是节拍
一个节拍是旅程中的一个步伐。它只做一件事:设定一个场景、阐明一个观点、提出一个问题、插一句题外话、转变一个角度。然后就停下来,让读者处在一个下一拍可以转向的位置。
节拍的大小取决于它的需求:
- 如果这个步伐只需要一句话,就是一句话("然后三周什么都没发生。")。
- 如果这个步伐需要铺垫,就是一段短文。
- 如果这个节拍是一个自成一体的片段、论证或示例,可以是多段。
如果一个"节拍"需要五段文字和三个小标题,那它就不是一个节拍:而是两个节拍粘在一起。把它拆开。
从素材堆中提取
从原始素材堆中提取材料来填充每个节拍。可以转述、拆分、重组或引用。素材堆就是你的采石场。
结束旅程
旅程完成时文章就结束了:而不是素材堆被掏空时。大多数素材堆都会有剩余的碎片没有被用到。这没关系;这正是拥有比需要更多原始素材的意义所在。
写作节奏
- 一次只追加一个节拍。永远不要超前写作。
- 每次写入前从磁盘重新读取文章文件。绝对保留用户的编辑。
- 如果用户大幅修改了某个之前的节拍,让后续内容随之调整。
- 如果用户说"重写那个节拍"或"回去尝试一个不同的节拍 3",照做:就地编辑,其余保持不变。
</supporting-info>Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

