writing-fragments
vinvcn/mattpocock-skills-zh-cn
Explore and capture raw writing fragments without imposing structure.
What is writing-fragments?
A pure exploration tool for writers to generate and collect unstructured fragments around any topic through guided conversation. Use this during the discovery phase before organizing content into outlines or articles.
- Conducts extended interviews to surface raw writing material on any subject
- Captures fragments—sentences, observations, vignettes, quotes, half-thoughts—as they emerge
- Appends fragments to a single markdown file separated by horizontal rules
- Identifies and encourages "leading words" (compact metaphors or neologisms that can anchor an entire piece)
- Preserves user edits between turns; never overwrites, only appends or edits on request
- Maintains conversational flow without interrupting for save dialogs
How to install writing-fragments
npx skills add https://github.com/vinvcn/mattpocock-skills-zh-cn --skill writing-fragmentsHow to use writing-fragments
- 1.Specify where to save the markdown file (or let the skill ask once, then remember it)
- 2.Start talking about your topic—fragments are captured from your first message onward
- 3.Continue the conversation naturally; the skill appends fragments without asking permission
- 4.Edit, reorder, or delete fragments directly in the file between turns
- 5.Use commands like "cut the last one", "rewrite that sharper", or "merge those two" as needed
- 6.When ready to structure, export the fragments file for use with a separate organizing skill
Use cases
- Brainstorming a blog post or article by collecting raw ideas before outlining
- Building a novelist's diary of observations and scenes that may become story material
- Exploring a complex topic through unstructured conversation to discover what you actually think
- Gathering quotes, anecdotes, and half-formed thoughts for later synthesis
- Identifying a "leading word" or core metaphor that will shape the final structure
- Writers in the exploration phase before drafting
- Journalists gathering raw material for articles
- Content creators brainstorming without premature structure
- Anyone thinking through a topic by writing
writing-fragments FAQ
Anything potentially useful in the final piece: sharp sentences, claims with justification, vignettes, half-thoughts, quotes, dialogue, clusters of related observations, complaints, or especially "leading words"—compact metaphors or neologisms that can anchor an entire work.
No. Fragments must be readable to the author (you know what you meant), but they don't need to define terms or make sense to a cold reader. The standard is "good writing material?" not "coherent argument?"
Yes. You can edit, reorder, delete, or merge fragments directly in the file. The skill re-reads the file before each turn to preserve your changes.
Use this during pure exploration to discover what you want to say. Once you have raw material and want to organize it into structure, phases, or an outline, switch to a structuring skill.
A leading word is a compact metaphor or new term that names a recurring idea—like "tracer bullets" or "fog of war." Finding the right one early shapes everything that follows: structure, transitions, and titles. Push for it when conversation circles around the same idea.
Full instructions (SKILL.md)
Source of truth, from vinvcn/mattpocock-skills-zh-cn.
name: writing-fragments description: "Writing, explore:挖掘原始 fragments,暂不施加任何结构。" disable-model-invocation: true
<what-to-do>这是纯粹的 explore:在不承诺任何结构的前提下,拓宽可写内容的空间——承诺结构是 exploit,是另一个 skill 的工作。运行一个产出 fragments 的 grilling session,围绕用户想写的任何主题持续访谈。在这里强加 phases、outlines 或文章结构都不在范围内。
当对话双方产生 fragments 时,把它们追加到单一 markdown 文件。
如果用户没有传入路径,只询问一次文档保存到哪里,然后在 session 剩余部分记住它。
从用户说的第一句话开始捕获 fragments,包括 initial prompt。
第一次写入时,在顶部放一个带 working title 的单一 H1(之后可以改),除此之外什么都不要放:不要 metadata、TOC 或 date。
</what-to-do> <supporting-info>What is a fragment
Fragment 是任何可能进入最终文章的文本片段。它必须_对作者可读_,也就是作者能知道它是什么意思;但它不需要定义术语,也不需要让冷读者立即理解。标准是 “这是不是一段好写作素材?”,不是 “这是不是自洽论证?”
Fragments 刻意保持异质。可能成为 fragment 的例子:
- 一句 sharp sentence,你想在某处使用但还不知道放哪里。
- 一个 claim 和一句 justification。
- 一个 vignette:发生过的事、code snippet、scenario、analogy。
- 一个 half-thought:"something about how X feels like Y, work this out later."
- 一句 quote、一段 dialogue、一句 overheard line。
- 一组凭感觉属于同一簇的 observations。
- 一个 complaint、confession 或 punchline。
- 一个 leading word——一个紧凑的隐喻或新造词,整篇文章都可以挂在它上面(一个为这个 idea 命名的术语,就像 tracer bullets 或 fog of war 为整个模式命名那样)。
在这些当中,leading word 是最值得落地的 fragment。它是 load-bearing 的:在 explore 阶段命名对的那一个,就会塑造之后的结构、transitions 和标题——在整个 exploit 阶段持续产生回报。当对话围绕一个反复出现的 idea 打转时,推动为它造一个词。
Novelist's diary 是模型:多年无结构的 noticings,之后被挖掘成 raw material。Fragments 就是 noticings。
File format
# Working title
A first fragment lives here.
It can be multiple paragraphs. It can include lists, code, quotes — whatever
shape the fragment naturally takes.
---
A second fragment.
---
> A quoted line that the user wants to keep around.
A reaction to it.
---
- A cluster of related observations
- That hang together by feel
- And want to be near each other
Fragments 用 horizontal rule(\n---\n)分隔。正文内不要 headings。不要 tags。除了加入顺序之外,不做排序。
Writing rhythm
安静追加。不要为每个 fragment 请求许可。可以顺带说你添加了什么("adding that"),但不要用 save dialogs 打断对话。
每次写入前:从磁盘重新读取文件。用户可能在回合之间编辑、重排或删除 fragments;保留他们的变化。永远不要 overwrite 文件;只 append(或者在用户要求时,就地编辑特定 fragment)。
用户随时可以说 "cut the last one"、"rewrite that one sharper"、"merge those two"。把它们当成一等指令。
</supporting-info>Related skills
More from vinvcn/mattpocock-skills-zh-cn and the wider catalog.

writing-great-skills
Reference guide for writing predictable, maintainable skills with consistent vocabulary and principles.

writing-shape
Transform raw material into a structured article by progressively shaping it paragraph by paragraph.

zoom-out
Get a high-level map of modules and callers when you need broader context.

ask-matt
Router skill to ask which technique or flow suits your current situation across the Matt Pocock skills collection.

book-to-skill
Convert books and documents into structured agent skills with frameworks, principles, and techniques.

paper-writing
Expert guidance for writing high-quality academic and research papers from planning to final polish.