Skill Tracer
Skills › Skills For Real Engineers › writing-fragments

writing-fragments

skill · 79 lines · MIT · skills/in-progress/writing-fragments/SKILL.md

The facts

Its description

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

The description the agent reads to decide when to use it.

From its settingsline 3

When it starts

This skill is not picked by the agent from its name and description: the frontmatter sets disable-model-invocation, so it is started explicitly, either by the user invoking it directly or by a sibling writing skill handing off the explore phase. Its description only labels it as the explore half of a writing pair, with structure and committing left to another skill.

A model's summary of when it is used.

A model's reading

Who can start it

Only you

Only you can start it. The agent never picks it on its own.

From its settingsline 4

What it leads to

Other skills this one hands off to, calls, requires or offers instead, as a model read them.

A model's reading

What leads to it

Other skills that hand off to this one, call it, require it or offer it instead, as a model read them.

A model's reading

Licence

MIT, from LICENSE

The terms its author shares it under, which let it be shown here.

From the repositorylicence text
Other files in this skill (1) Close

The text

Open on GitHub

Most marks come from matching words in the file, so treat them as pointers.

1---
2name: writing-fragments
3description: "Writing, explore: mine raw fragments, no structure yet."
4disable-model-invocation: true
5---
6
7<what-to-do>
8
9This 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.
11As fragments emerge from either side of the conversation, append them to a single markdown file.
13If the user did not pass a path, ask once where to save the document, then remember it for the rest of the session.
15Capture fragments from the very first thing the user says, including the initial prompt.
17On 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.
19</what-to-do>
21<supporting-info>

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

Raw lines 1 to 22
Names a skill writing-shape :9
Names a skill grilling :9
23## What is a fragment
25A 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?"
27Fragments are deliberately heterogeneous. Examples of what could be a fragment:
29- A sharp sentence you'd want to deploy somewhere but don't yet know where.
30- A claim with a one-line justification.
31- A vignette: a thing that happened, a code snippet, a scenario, an analogy.
32- A half-thought: "something about how X feels like Y, work this out later."
33- A quote, a piece of dialogue, an overheard line.
34- A list of related observations that hang together by feel.
35- A complaint, a confession, a punchline.
36- 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).
38Of 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.
40The novelist's diary is the model: years of unstructured noticings that later get mined for raw material. Fragments are noticings.

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.

Raw lines 23 to 41
42## File format
44```markdown
45# Working title
47A first fragment lives here.
49It can be multiple paragraphs. It can include lists, code, quotes: whatever
50shape the fragment naturally takes.
52---
54A second fragment.
56---
58> A quoted line that the user wants to keep around.
60A reaction to it.
62---
64- A cluster of related observations
65- That hang together by feel
66- And want to be near each other
67```
69Fragments are separated by a horizontal rule (`\n---\n`). No headings inside the body. No tags. No order beyond the order they were added.

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.

Raw lines 42 to 70
71## Writing rhythm
73Append 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.
75Before 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).
77The user can say "cut the last one", "rewrite that one sharper", "merge those two" at any time. Treat those as first-class instructions.
79</supporting-info>

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>

Raw lines 71 to 79

From mattpocock/skills at 4ae2317, 2026-10-31. Skills read by DeepSeek V4.1 Flash on 2026-11-04. Summary and techniques by Claude Opus 5.5 on 2026-11-06.