К основному содержанию
скилл CX Codex

writing-principles — скилл для Claude Code: принципы писательства

Скилл объясняет, чего ждут читатели художественной прозы и как обучение LLM эти ожидания ломает. Пригодится при черновике, критике или когда сцена кажется плоской.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add haowjy/creative-writing-skills --skill writing-principles -a claude-code
Открыть на GitHub

Что делает writing-principles

Скилл описывает пять каналов читательского вознаграждения: погружение в мир, удовольствие от фразы, моделирование персонажей как живых людей, поток чтения и любопытство с предсказанием. Для каждого названо, что именно его защищает и как типичные привычки модели — объяснить, досказать, снять неопределённость — этот канал разрушают.

Внутри два раздела-диагностики: «Trust the Reader» и «Economy». Первый про то, что читатель сам восстанавливает эмоции по поведению и достраивает мотивы; второй — про элементы, которые делают сразу два дела. Есть отдельная заметка про пунктуацию: длинное тире читатели всё чаще связывают с текстом от ИИ, поэтому по умолчанию советуется точка, запятая, двоеточие или реплика с действием.

Скилл загружается поверх /llm-writing, без него он не работает — это прямо сказано в начале файла. Глубокие разборы лежат в resources/failure-modes.md и resources/citations.md. Если вам нужны не диагнозы, а приёмы письма, смотрите /creative-writing-craft и /creative-writing-modes: здесь только слой понимания, что сломалось.

Какие задачи решает

  • понять, почему готовая сцена читается плоско
  • найти канал читательского интереса, который просел в отрывке
  • убрать из прозы привычку модели объяснять всё до конца
  • проверить пунктуацию на следы ИИ-текста
  • разделить знание персонажа и знание автора о сюжете

Примеры запросов агенту

  • загрузи writing-principles и разбери, почему эта сцена не держит напряжение
  • прогони главу по каналам читательского вознаграждения и скажи, какой сломан
  • проверь диалог: не объясняет ли он то, что читатель понял бы сам

Как установить writing-principles

1Через Skills CLI (Vercel)

npx skills add haowjy/creative-writing-skills --skill writing-principles -a claude-code

2Вручную: положить файлы

~/.claude/skills/writing-principles/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/writing-principles/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о writing-principles

Как установить writing-principles в Claude?

Выполните npx skills add haowjy/creative-writing-skills --skill writing-principles -a claude-code. Файл скилла окажется в ~/.claude/skills/writing-principles/SKILL.md.

Что делает writing-principles?

Называет, чего читатели художественной прозы ждут от текста, и показывает, какими способами обучение LLM эти ожидания портит. Используется как диагностический слой при письме и критике.

Что нужно, чтобы скилл заработал?

Сначала должен быть загружен /llm-writing — writing-principles добавляет к нему слой для художественной прозы. Разборы конкретных ошибок лежат в resources/failure-modes.md.

Исходный текст

SKILL.md · Apache-2.0
---
name: writing-principles
type: principle
description: >
  What fiction readers want (reader reward channels) and the specific ways LLM training damages them. Load when drafting prose, critiquing, or diagnosing why a passage feels flat.
---

# Writing Principles

Load `/llm-writing` if it isn't already loaded. This skill adds the
fiction-specific layer.

## Trust the Reader

The reader is an active collaborator. They reconstruct emotions from behavior,
infer motives from action, hold tension across scenes, fill gaps the text
leaves open, and make assumptions about what's coming next. That work is where
the reward lives: reconstruction, inference, anticipation.

Your training pulls in the opposite direction. The helpfulness instinct wants
to explain, resolve, clarify, and complete. In fiction, every one of those
impulses can damage the reading experience by doing work the reader wanted to
do themselves. The specific failure modes below are all forms of this: not
trusting the reader to interpret an emotion, hold an ambiguity, follow
subtext, or tolerate unresolved tension.

Trust doesn't mean obscurity. Readers also need coherent narrative, stable
geography, and enough access to model characters. The discipline is knowing
when to leave space and when to orient.

## Economy

Every element does more than one thing. A line of dialogue advances plot
AND reveals character. A sensory detail grounds the scene AND shows who the
POV character is. A transition compresses time AND carries an emotional
beat. Single-purpose prose makes fiction go flat: description that only
describes, dialogue that only informs, interiority that only labels.

Economy isn't minimalism. Dense, lyrical prose can be economical when every
phrase carries weight. Sparse prose can be wasteful when it takes ten short
sentences to do what one image could do. The measure is whether removing
the element would cost the reader something.

The LLM pull is toward completeness: covering every beat, naming every
emotion, resolving every ambiguity. Economy is the counter-discipline:
what can you leave out and still have the scene work? What's the reader
already doing for you?

## Reader Reward Channels

Readers enjoy fiction through overlapping reward channels. Good prose protects
the relevant channels at once; damaging one damages the reading experience.

- **Transportation**: entering the story world. Protected by coherent
  narrative progression, consistent POV, concrete sensory grounding. Consistent
  POV means writing from inside the character's knowledge state: what have
  they experienced, what do they actually know right now, what would they
  notice and miss? The full story is in your context window; the character
  only has what they've lived through. Separate those.
- **Aesthetic**: sentence-level pleasure. Protected by variety in rhythm,
  word choice, sentence shape, and punctuation. Style is a reward channel, not decoration.
- **Social simulation**: modeling characters as minds. Protected by access
  through behavior and interiority, distinct voices, emotion the reader
  interprets rather than being told.
- **Flow**: challenge-skill fit and smooth processing. Protected by pacing that
  matches the scene's work and sentences that support comprehension without
  making the reading trivial.
- **Curiosity / prediction reward**: wanting to know what happens, what a clue
  means, what a character will choose, or whether an expectation will be
  confirmed. Protected by information gaps, uncertainty, setup/payoff, suspense,
  and withheld implications that the reader can actively model.

The channels compose: optimizing one at the expense of others fails.
Over-explaining breaks social simulation. Under-explaining breaks
transportation. Generic style breaks aesthetic pleasure. Impenetrable style
breaks flow.

## Punctuation Tells

Readers increasingly associate em dashes with AI-generated prose. Default to
punctuation that leaves less visible AI residue: sentence breaks, commas,
colons, semicolons, parentheses, or dialogue beats. Rewrite the sentence
around the actual relationship between clauses instead of substituting a
hyphen. Use dashes only when a project style file or author instruction makes
them part of the voice. When a line needs interruption, prefer the project's
documented interruption pattern and keep it consistent.

## Applying the Principles

This skill is the diagnostic layer: it names what readers want and how
training damages it. When a passage feels off and you can't name why, check
the reward channels — which one broke? — then see `resources/failure-modes.md`
for common patterns and fix heuristics.

The craft skills carry the execution. `/creative-writing-craft` has the
how-to-write guidance: prose immersion (`resources/prose-writing.md`), scene
mechanics (`resources/scene-construction.md`), and style analysis
(`resources/style-analysis.md`). `/creative-writing-modes` has the production
modes for putting prose on the page.

## Resources

- [`resources/failure-modes.md`](resources/failure-modes.md): per-pattern
  deep dives with examples and fix heuristics.
- [`resources/citations.md`](resources/citations.md): research backing for
  the reader-reward model and documented failure modes.

© haowjy · Apache-2.0 · haowjy/creative-writing-skills

Похожие скиллы

Всё по теме «Тексты и документация» →
prose-style jwynia Разбирает проблемы на уровне предложений: монотонность, плоские фразы, лишние эпитеты, скачки голоса. Полезен, когда структура уже готова. CX Codex +1 553установок better-writing forjd Переписывает, черновики и вычитывает прозу: письма, отчёты, документацию, тексты интерфейса. Полезен, когда текст звучит шаблонно или по-чатботовски. CX Codex +1 514установок sepia-hemingway Nanako0129 Скилл для написания и правки художественной прозы с голосом Хемингуэя. Работает только вместе с плагином Sepia. CX Codex +1 754установок story-analysis jwynia Диагностика готового текста: скилл проходит по рассказу или главе романа и показывает, где провисает конфликт, персонаж или концовка. Пригодится после черновика. CX Codex +1 684установок novel-writer YangsonHung Скилл для ИИ-кодинга, который помогает писать романы: от идеи и плана глав до продолжения текста, персонажей и правок. CX Codex +1 604установок qiaomu-novel-generator joeseesun Скилл пишет китайские короткие рассказы с сильным крючком в начале: от темы, персонажа или черновика до готового текста. CX Codex +1 589установок

Из того же набора22

creative-writing-craft Справочный скилл по литературному мастерству для художественной прозы. Помогает автору и критику настраивать сцены, стиль, ритм и повествовательную дистанцию. CX Codex +1 787установок writing-staffing Справочник по составу писательской команды: какие скиллы подключить агентам, что указать в промпте при запуске и когда разводить работу по параллельным дорожкам. CX Codex +1 723установок story-review Разбирает черновики прозы на пяти уровнях редактуры: от структуры и темпа до грамматики. Пригодится, когда тексту нужен критический разбор без автоматической переписки. CX Codex +1 672установок story-planning Помогает спланировать структуру сюжета, арки персонажей и сцены перед написанием текста. Переключает агента в режим подготовки и архитектуры истории. CX Codex +1 664установок project-setup Разовый мастер настройки писательского проекта. Опрашивает автора, собирает образцы текста и создаёт AGENTS.md с правилами проекта. CX Codex +1 544установок character-sim Скилл переключает модель в режим диалога от лица персонажа с учётом его знаний, эмоций и лексики. Помогает проверять реплики в сюжете и тестировать конфликты героев. CX Codex +1 530установок creative-writing-modes Скилл добавляет к работе с прозой пять режимов: черновик, правка, связки, альтернативный вариант и шлифовка строки. Пригодится, когда структура готова и пора писать текст. CX Codex +1 534установок kb-management Организует базу знаний сюжета в каталоге kb/ и задаёт правила для канона, глоссария и персонажей. Пригодится при ведении долгой истории с несколькими агентами. CX Codex +1 527установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой