SuperAPI AI Directory

writing-fragments

Writing & research

View repository

Updated 10-15 23:44

About this skill

Run a grilling session that produces fragments. Interview the user relentlessly about whatever they want to write. Do not impose stages, outlines, or structure—that is explicitly out of scope.

As fragments emerge from either side of the conversation, append them to a single markdown file. The user will edit this file during the session; always re-read it before writing so their edits are preserved.

If the user did not pass a path, ask once where to save the document, then remember it for the rest of the session.

Start capturing fragments from the first thing the user says, including the initial prompt.

On the first write, put a single H1 with a working title at the top (it can change later), and nothing else—no metadata, no table of contents, no date.

What is a fragment

A fragment is any piece of text that might survive into the final article. It must be _readable to the author_—the author can tell what it means—but it does not need to define its terms or be understandable to a cold reader. The criterion is "is this a good piece of writing?", not "is this a self-contained argument?"

Fragments are deliberately heterogeneous. Examples of what can be a fragment:

  • A sharp sentence you want to deploy somewhere but don't yet know where.
  • A claim with a line of proof.
  • A vignette: something that happened, a code snippet, a scene, an analogy.
  • A half-thought: "something about X feeling like Y, solve this problem later."
  • A quote, a snippet of dialogue, a line overheard.
  • A list of related observations that hang together by feel.
  • A complaint, a confession, a punchline.

The novelist's diary is the model: years of unstructured attention later mined as raw material. Fragments are attention.

File format

# 工作标题

第一个片段在这里。

它可以是多个段落。它可以包括列表、代码、引用——无论片段自然采取什么形状。

---

第二个片段。

---

> 用户想要保留的引用行。

对它的反应。

---

- 一组相关观察
- 通过感觉悬挂在一起
- 并希望彼此靠近

Fragments are separated by horizontal rules (\n---\n). No headings within the body. No tags. No order other than the order of addition.

Writing rhythm

Append silently. Do not ask permission for each fragment. Mention in passing what you added ("added that"), but do not interrupt the conversation with save dialogs.

Before every write: re-read the file from disk. The user may have edited, reordered, or deleted fragments between turns—preserve their changes. Never overwrite the file; only append (or, if the user asks, edit a specific fragment in place).

The user can say at any time "cut the last one", "rewrite that more sharply", "merge those two". Treat these as first-class instructions.