Generated banner for Writing Fragments
Generated logo for Writing Fragments

Writing Fragments

Matt PocockCommunityCreated by Matt Pocock

  • Skill
  • Content generator
  • Documents and content
  • MIT
  • No issues found

From the author

Writing, explore: mine raw fragments, no structure yet.
— the description by Matt Pocock

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The writing-fragments skill acts as a creative partner that helps users mine and record raw ideas without the pressure of structure or organization. By focusing on exploration rather than exploitation, it allows writers to capture vignettes, half-thoughts, metaphors, and observations in a fluid, conversational manner. The agent maintains a persistent markdown file, appending new fragments as they emerge from the dialogue, ensuring that valuable insights are preserved for later development.

What it does

  • Conducts a grilling session to extract raw writing material from the user.
  • Captures diverse content types including metaphors, vignettes, quotes, and half-thoughts.
  • Maintains a persistent markdown file with horizontal rule separators between fragments.
  • Supports iterative refinement through commands like cutting, merging, or rewriting specific fragments.
  • Prioritizes the discovery of leading words or core metaphors to anchor future writing.
  • Reads existing file content before every update to respect user edits and reordering.

When to use it

  • When you have a vague topic but lack a clear outline or structure.
  • When you want to brainstorm and capture 'noticings' without worrying about flow.
  • When you need to develop a core metaphor or 'leading word' for a larger project.
  • When you are in the early, messy phase of a writing project and need to dump ideas quickly.

Advantages

  • Removes the cognitive load of structuring ideas prematurely.
  • Preserves the raw, authentic feel of initial thoughts.
  • Encourages the discovery of high-value, load-bearing concepts.
  • Provides a flexible, non-linear workspace for creative development.

Usage examples

“I want to write about the feeling of burnout in remote teams. Let's start.”
The agent initiates a conversation, asking probing questions about your experiences, and begins appending your responses as distinct fragments in your markdown file.
“Merge the last two fragments about the 'digital commute' and rewrite them to be more punchy.”
The agent reads the file, combines the specified fragments, applies a sharper tone, and updates the file while preserving the rest of your content.

Install

  1. Download the skill as a ZIP:

    https://autogineer.com/agent-skills/mattpocock/writing-fragments/download
  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip writing-fragments.zip -d .agents/skills

Documentation by Matt Pocock

<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>

Files

SKILL.md

<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>

Requirements and compatibility

Written for: Claude Code

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Needs: Claude Code frontmatter

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Created by
Matt Pocock
Publisher
Matt Pocock (Community)
Source
mattpocock/skills · skills/in-progress/writing-fragments · commit 4ae2317
Licence
MIT License (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Matt Pocock or Matt Pocock.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download writing-fragments.zip