writing-fragments

作成者: mattpocock

ユーザーから断片(主張、小品、鋭い一文、半端な思考といった異質な執筆の塊)を掘り起こす対話セッションを行い、それらを将来の記事のための生の素材として1つのドキュメントに追加します。ユーザーが構造を決める前にアイデアを練りたい場合や、「断片」「発想」「生の素材」といった執筆に関する言葉を口にした際に使用します。

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 — 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のその他のスキル

improve-codebase-architecture
mattpocock
コードベース内の深化の機会を見つけます。CONTEXT.mdのドメイン言語とdocs/adr/の決定事項に基づきます。ユーザーがアーキテクチャを改善したい、リファクタリングの機会を見つけたい、密結合モジュールを統合したい、またはコードベースをよりテスト可能でAIがナビゲートしやすくしたい場合に使用します。
developmentcode-reviewapi
tdd
mattpocock
テスト駆動開発のレッド・グリーン・リファクタリングループ。ユーザーがTDDを使って機能を構築したりバグを修正したい場合、「レッド・グリーン・リファクタリング」に言及した場合、統合テストを希望する場合、またはテストファースト開発を依頼した場合に使用します。
developmenttesting
handoff
mattpocock
現在の会話を、別のエージェントが引き継ぐためのハンドオフ文書に圧縮します。
communicationproject-managementdocument
prototype
mattpocock
本番実装に入る前に、設計を具体化するための使い捨てプロトタイプを構築します。2つのブランチに分岐します。状態やビジネスロジックの検証用の実行可能なターミナルアプリ、または1つのルートから切り替え可能な複数の根本的に異なるUIバリエーションです。ユーザーがプロトタイプ作成、データモデルやステートマシンの健全性チェック、UIのモックアップ、デザインオプションの探索を希望する場合、または「これをプロトタイプ化して」「試しに触らせて」「いくつかのデザインを試して」と指示した場合に使用します。
developmentdesigncreative
triage
mattpocock
トリアージロールによって駆動されるステートマシンを通じて課題をトリアージします。ユーザーが課題を作成したい、課題をトリアージしたい、新着のバグや機能リクエストをレビューしたい、AFKエージェント向けに課題を準備したい、または課題ワークフローを管理したい場合に使用します。
developmentproject-managementcommunication
obsidian-vault
mattpocock
Obsidianボルト内のノートを検索、作成、管理し、ウィキリンクやインデックスノートを扱います。ユーザーがObsidianでノートを検索、作成、整理したい場合に使用します。
productivitydocument
edit-article
mattpocock
記事のセクションを再構成し、明確さを向上させ、文章を引き締めることで編集・改善します。ユーザーが記事の草稿を編集、修正、または改善したい場合に使用します。
documentcreative
writing-great-skills
mattpocock
スキルを適切に記述・編集するためのリファレンス — スキルを予測可能にする語彙と原則。
documentdevelopment