All skills
mattpocock avatar

/writing-fragments

@5c89081 official
by Matt Pocockmattpocock/skills274k stars
22,987

Writing, explore: mine raw fragments, no structure yet.

Use this Skill: https://skilld.dev/gh/mattpocock/skills/writing-fragments

This session only. Nothing lands on disk.

SKILL.md

≈19 tokens always: the name and description. ≈856 when used: this file. ≈35 more on demand in 1 file.

<what-to-do>

This is pure explore: widen the space of what could be written without committing to structure. Committing is exploit, a separate skill's job. Run a grilling session that produces fragments, interviewing the user relentlessly about whatever they want to write about. Imposing phases, outlines, or article structure is out of scope here.

As fragments emerge from either side of the conversation, append them to a single markdown file.

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

Capture fragments from the very first thing the user says, including the initial prompt.

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

</what-to-do><supporting-info>

What is a fragment

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

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

  • A sharp sentence you'd want to deploy somewhere but don't yet know where.
  • A claim with a one-line justification.
  • A vignette: a thing that happened, a code snippet, a scenario, an analogy.
  • A half-thought: "something about how X feels like Y, work this out later."
  • A quote, a piece of dialogue, an overheard line.
  • A list of related observations that hang together by feel.
  • A complaint, a confession, a punchline.
  • A leading word: a compact metaphor or coinage the whole piece can hang on (one term that names the idea, the way tracer bullets or fog of war names a whole pattern).

Of these, the leading word is the most valuable fragment to land. It is load-bearing: name the right one in explore and it shapes the structure, the transitions, and the title later, paying dividends through the entire exploit phase. When the conversation circles a recurring idea, push to coin a word for it.

The novelist's diary is the model: years of unstructured noticings that later get mined for raw material. Fragments are 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 are separated by a horizontal rule (\n---\n). No headings inside the body. No tags. No order beyond the order they were added.

Writing rhythm

Append silently. Don't ask permission for each fragment. Mention what you added in passing ("adding that"), but don't 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, so preserve their changes. Never overwrite the file; only append (or, if the user asks, edit a specific fragment in place).

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

</supporting-info>

Source: SKILL.md on GitHub

No alerts16d3 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    This skill is a pure text-generation and writing assistant designed to interview the user and collect raw unstructured notes or fragments into a local markdown file. It does not introduce any security or executable code concerns.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

Signed by skilld at 5c89081. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 days ago.

Activeupdated last month
disable-model-invocation
true
  • writing
  • ideation
  • fragments
  • raw-material
  • interview
  • markdown
  • note-taking
  • brainstorming

README badge

README badge for mattpocock/skills/writing-fragments

Conducts an unstructured interview to capture heterogeneous writing fragments — claims, vignettes, half-thoughts, sharp sentences — and appends them to a markdown document as raw material for future articles. Use when the user wants to explore ideas before imposing outline or structure.

Generated from the current SKILL.md.

Does this skill create outlines or impose structure on my writing?
No. The skill explicitly avoids outlines, phases, or structure — it mines fragments as raw material and lets you impose organization later.
What counts as a fragment?
Anything readable to you as the author: sharp sentences, claims with brief justifications, vignettes, half-thoughts, quotes, lists of related observations, complaints, or confessions. It does not need to be self-contained or comprehensible to a cold reader.
Can I edit fragments after they're added?
Yes. You can edit, reorder, delete, or merge fragments at any time during the session. The skill re-reads the file before each write to preserve your changes.
What file format does this create?
A markdown file with an H1 title at the top and fragments separated by horizontal rules. No metadata, no tags, no table of contents.
Does this skill help me finish an article?
No. This skill is for ideation only — it captures fragments as raw material for you to structure and refine into a finished piece later.

Generated from the current SKILL.md. These answers refresh after source changes.