writing-fragments

작성자: mattpocock

사용자에게서 조각들(주장, 일화, 날카로운 문장, 반쯤 떠오른 생각 등 이질적인 글쓰기 덩어리)을 캐내는 그릴링 세션으로, 이를 단일 문서에 추가하여 향후 글을 위한 원자재로 삼습니다. 사용자가 구조를 갖추기 전에 아이디어를 발전시키려 하거나, 글쓰기를 위해 "조각", "구상", "원자재"를 언급할 때 사용하세요.

npx skills add https://github.com/mattpocock/skills --skill writing-fragments

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

mattpocock의 다른 스킬

writing-for-agents
mattpocock
에이전트를 위한 문서 작성. 스킬을 생성하거나 편집할 때, 또는 AGENTS.md나 CLAUDE.md를 수정할 때 사용합니다.
wait-what
mattpocock
멈춰. 그 마지막 메시지는 전달되지 않았어 — 다시 제안해.
communication
to-questionnaire
mattpocock
완전히 답할 수 없는 결정을 다른 사람이 작성할 설문지로 바꿉니다.
grill-me
mattpocock
사용자의 계획이나 디자인에 대해 철저히 질문하여 공통된 이해에 도달할 때까지 결정 트리의 각 분기를 해결합니다. 사용자가 계획을 검증받고 싶어하거나, 디자인에 대해 집중 질문을 받고 싶어하거나, "grill me"라고 언급할 때 사용하세요.
researchcommunicationproject-management
tdd
mattpocock
레드-그린-리팩터 루프를 사용한 테스트 주도 개발. 사용자가 TDD로 기능을 구축하거나 버그를 수정하려 할 때, "레드-그린-리팩터"를 언급할 때, 통합 테스트를 원할 때, 또는 테스트 우선 개발을 요청할 때 사용합니다.
developmenttesting
handoff
mattpocock
현재 대화를 다른 에이전트가 이어받을 수 있도록 핸드오프 문서로 압축합니다.
communicationproject-managementdocument
prototype
mattpocock
디자인을 확정하기 전에 일회용 프로토타입을 만들어 검토합니다. 상태나 비즈니스 로직을 확인할 수 있는 실행 가능한 터미널 앱과, 하나의 경로에서 전환 가능한 여러 개의 완전히 다른 UI 변형이라는 두 가지 분기로 나뉩니다. 사용자가 프로토타입을 만들고, 데이터 모델이나 상태 머신을 검증하며, UI를 목업하고, 디자인 옵션을 탐색하려 하거나, "이걸 프로토타입으로 만들어 봐", "한번 가지고 놀게 해줘", "몇 가지 디자인을 시도해 봐"라고 말할 때 사용합니다.
developmentdesigncreative
triage
mattpocock
트라이지 역할에 의해 구동되는 상태 머신을 통해 이슈를 분류합니다. 사용자가 이슈를 생성하거나, 이슈를 분류하고, 들어오는 버그나 기능 요청을 검토하고, AFK 에이전트를 위해 이슈를 준비하거나, 이슈 워크플로를 관리하려는 경우 사용합니다.
developmentproject-managementcommunication