writing-fragments — скилл для Claude Code: что делает и как установить
Скилл writing-fragments для Claude Code собирает из беседы фрагменты будущей статьи и сохраняет их в одном Markdown-файле.
Apache-2.0 ★ 173 обновлён 2026-10-24
npx skills add sammcj/agentic-coding --skill writing-fragments -a claude-codeЧто делает writing-fragments
writing-fragments проводит интервью о теме, которую вы хотите раскрыть, и сохраняет удачные мысли в виде отдельных фрагментов: тезисов, сцен, реплик или незаконченных идей. Он начинает собирать материал с первого сообщения, включая исходный запрос. Структуру статьи скилл не навязывает.
Фрагменты добавляются в один Markdown-файл и разделяются горизонтальной чертой. Если путь не задан, скилл один раз спросит, куда сохранить документ; при первой записи добавит заголовок первого уровня с рабочим названием. Перед каждой записью он перечитывает файл, чтобы сохранить ваши правки. Поэтому изменения в документе между сообщениями не должны затереться.
Скилл рассчитан на Claude Code. Для установки используется npx skills add sammcj/agentic-coding --skill writing-fragments -a claude-code.
Какие задачи решает
- собрать разрозненные мысли для будущей статьи
- сохранить меткие фразы и примеры из беседы
- развить тему вопросами, не составляя план
- добавить новые фрагменты в общий Markdown-файл
Примеры запросов агенту
- Помоги развить мои идеи о код-ревью: задавай вопросы и сохраняй удачные фрагменты в
draft.md. - Поговори со мной о том, как я учился программировать, и записывай мысли для будущей статьи в один файл.
- Собирай фрагменты для статьи из нашей беседы, а перед записью перечитывай файл и сохраняй мои правки.
Как установить writing-fragments
1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill writing-fragments -a claude-code2Вручную: положить файлы
~/.claude/skills/writing-fragments/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/writing-fragments/
1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill writing-fragments -a codex2Вручную: положить файлы
.agents/skills/writing-fragments/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill writing-fragments -a cursor2Вручную: положить файлы
.cursor/skills/writing-fragments/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install sammcj/agentic-coding Skills_disabled/writing-fragments/SKILL.md2Вручную: положить файлы
.github/skills/writing-fragments/SKILL.md1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill writing-fragments -a gemini-cli2Командой платформы
gemini skills install https://github.com/sammcj/agentic-coding --path Skills_disabled/writing-fragmentsВручную: положить файлы
.devin/skills/writing-fragments/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о writing-fragments
Как установить writing-fragments в Claude Code?
Выполните npx skills add sammcj/agentic-coding --skill writing-fragments -a claude-code. Файл скилла находится по пути ~/.claude/skills/writing-fragments/SKILL.md.
Что делает writing-fragments?
Он расспрашивает о теме и складывает подходящие для будущей статьи тезисы, сцены, цитаты и незаконченные мысли в один Markdown-файл. План или разделы статьи скилл не создаёт.
Как writing-fragments сохраняет правки в документе?
Перед каждой записью скилл перечитывает файл с диска и дописывает фрагменты, сохраняя внесённые вами изменения. Если путь не задан, он один раз спросит, куда сохранить документ.
Исходный текст
SKILL.md · Apache-2.0
---
name: writing-fragments
description: Grilling session that mines the user for fragments - heterogeneous nuggets of writing (claims, vignettes, sharp sentences, half-thoughts) - and appends them to a single document as raw material for a future article. Use when the user wants to develop ideas before imposing structure, or mentions "fragments", "ideate", or "raw material" for writing.
metadata:
source: Inspired by https://github.com/mattpocock/skills
---
<what-to-do>
Run a grilling session that produces fragments. Interview the user relentlessly about whatever they want to write about. Do not impose phases, outlines, or structure - that is explicitly out of scope.
As fragments emerge from either side of the conversation, append them to a single markdown file. The user will be editing this file during the session; always re-read it before writing so their edits are preserved.
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.
The novelist's diary is the model: years of unstructured noticings that later get mined for raw material. Fragments are noticings.
## File format
```markdown
# 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 dialogues.
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.
</supporting-info>
© sammcj · Apache-2.0 · sammcj/agentic-coding