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

prose-style — скилл для Claude Code: диагностика стиля прозы

Разбирает проблемы на уровне предложений: монотонность, плоские фразы, лишние эпитеты, скачки голоса. Полезен, когда структура уже готова.

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

Что делает prose-style

Скилл работает как диагностик, а не как редактор. Он разбирает шесть состояний текста: плоская проза, неясность, перегруженность (purple prose), монотонность, злоупотребление пассивом и непостоянный голос. Для каждого состояния есть список вопросов и чек-лист, по которым агент проверяет ваш текст.

Внутри — таблица уровней дикции (высокий, средний, разговорный), признаки перегруженной прозы вроде нагромождения прилагательных и наречий, а также разбор случаев, когда пассив уместен. Отдельный блок опирается на принципы Strunk & White. Автор советует читать текст вслух, чтобы услышать ритм, и помечать длину предложений.

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

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

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

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

  • проверь эту главу на монотонность предложений
  • найди в отрывке purple prose и покажи, что сократить
  • голос рассказчика скачет между сценами — разбери почему

Как установить prose-style

1Через Skills CLI (Vercel)

npx skills add jwynia/agent-skills --skill prose-style -a claude-code

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

~/.claude/skills/prose-style/SKILL.md

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

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

Вопросы о prose-style

Как установить prose-style в Claude?

Выполните npx skills add jwynia/agent-skills --skill prose-style -a claude-code. Скилл появится в ~/.claude/skills/prose-style/SKILL.md.

Что делает prose-style?

Диагностирует проблемы стиля на уровне предложений: ритм, выбор слов, длину фраз, пассив и постоянство голоса. Работает после того, как структура текста уже сложилась.

Для каких текстов он подходит?

В метаданных скилла указан домен fiction, то есть художественная проза. Критерии вроде близкой точки зрения и голоса рассказчика рассчитаны именно на неё.

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

SKILL.md · MIT
---
name: prose-style
description: Diagnose sentence-level issues after structure is solid. Use when prose feels flat, sentences are monotonous, word choices are generic, or voice is inconsistent.
license: MIT
metadata:
  author: jwynia
  version: "1.0"
  type: diagnostic
  mode: diagnostic+assistive
  domain: fiction
---

# Prose Style: Diagnostic Skill

You diagnose sentence-level craft problems in fiction. Your role is to identify why prose fails to serve the story and guide writers toward vigorous, intentional writing.

## Core Principle

**Style is not decoration; style is content.**

The way something is written shapes what it means. As Truman Capote observed:

> "I believe a story can be wrecked by a faulty rhythm in a sentence—especially if it occurs toward the end—or a mistake in paragraphing, even punctuation."

Prose style operates at multiple levels simultaneously:
- **Word choice** (diction)
- **Sentence structure** (syntax)
- **Paragraph flow** (rhythm)
- **Voice** (the writer's distinctive presence)

**The fundamental principle:** Vigorous writing is concise. Every word earns its place.

---

## The Prose States

### State P1: Flat Prose

**Symptoms:** Prose is functional but unmemorable. Sentences deliver information but have no rhythm or distinction. Writing doesn't enhance the story—it merely delivers it.

**Key Questions:**
- Is there sentence variety (length, structure)?
- Are word choices precise or generic?
- Is there any rhythm or is it monotonous?
- Does the prose have any distinctive quality?

**Diagnostic Checklist:**
- [ ] Sentences vary in length (short, medium, long)
- [ ] Sentences vary in structure (simple, compound, complex)
- [ ] Word choices are specific, not generic
- [ ] Prose has identifiable rhythm

**Interventions:**
- Read aloud to hear the rhythm (or lack thereof)
- Mark sentence lengths—look for variation
- Replace vague words with specific ones
- Vary sentence openings (don't always start with subject-verb)

---

### State P2: Unclear Writing

**Symptoms:** Reader has to reread sentences. Meaning is obscured by abstraction or missing context. Pronouns lack clear antecedents. The curse of knowledge operates.

**Key Questions:**
- Are there too many abstractions?
- Is assumed knowledge preventing clarity?
- Are pronoun antecedents clear?
- Is logic visible or compressed?

**Diagnostic Checklist:**
- [ ] Concrete language outweighs abstract
- [ ] Context provided for specialized terms
- [ ] Every pronoun has obvious referent
- [ ] Logical steps are visible, not compressed

**Interventions:**
- Substitute concrete for abstract
- Add context where curse of knowledge operates
- Check every pronoun has an obvious referent
- Expand compressed thinking—show the steps

---

### State P3: Overwrought Prose (Purple Prose)

**Symptoms:** Style overwhelms substance. Excessive adjectives and adverbs. Metaphors obscure rather than illuminate. Writing calls attention to itself rather than the story.

**Key Questions:**
- Are there adjective/adverb stacks?
- Do metaphors illuminate or obscure?
- Is style calling attention to itself?
- Does richness serve the work or overwhelm it?

**Diagnostic Checklist:**
- [ ] No more than 1-2 adjectives per noun
- [ ] Adverbs used sparingly, intentionally
- [ ] Metaphors clarify rather than confuse
- [ ] Prose serves story, not writer's ego

**Signs of Purple Prose:**
- Adjective stacking: "beautiful, gorgeous, stunning sunset"
- Adverb abuse: "ran quickly, desperately, frantically"
- Overwrought metaphor: comparisons that obscure
- Mismatched register: elevated language for mundane content

**Interventions:**
- Cut modifiers ruthlessly
- Choose one right adjective, not three approximations
- Replace overwrought metaphors with simpler images
- Let nouns and verbs do the work

---

### State P4: Monotonous Prose

**Symptoms:** Every sentence sounds the same. Every paragraph looks the same. Sentences start the same way. Reading feels like a drone.

**Key Questions:**
- Are sentences all similar lengths?
- Are paragraphs all similar lengths?
- Do sentences start the same way?
- Is there any variation in rhythm?

**Diagnostic Checklist:**
- [ ] Sentence lengths vary significantly
- [ ] Paragraph lengths vary (including singles for punch)
- [ ] Sentence openings vary (not all subject-verb)
- [ ] Rhythm shifts between sections

**Interventions:**
- Consciously vary sentence length
- Use short sentences for punch, long for flow
- Vary paragraph length for rhythm
- Change sentence structure (simple, compound, complex)
- Vary sentence openings (modifiers, dependent clauses)

---

### State P5: Passive Voice Overuse

**Symptoms:** Prose feels indirect, weak. Agents are routinely hidden when they matter. Energy drains from sentences. Action feels distant.

**Key Questions:**
- Are agents hidden when they matter?
- Does prose feel indirect?
- Is passive used intentionally or by default?
- Would active voice add energy?

**When Passive IS Appropriate:**
- Agent is unimportant ("The building was constructed in 1890")
- Agent is unknown ("Mistakes were made")
- Deliberately hiding the actor
- Emphasis at sentence end ("The patient was murdered by his own doctor!")
- Focus is on receiver ("Kennedy was assassinated")

**Diagnostic Checklist:**
- [ ] Passive voice used intentionally, not by default
- [ ] Important agents named, not hidden
- [ ] Active voice predominates in action sequences
- [ ] Passive serves emphasis where used

**Interventions:**
- Default to active voice
- Check each passive: is it intentional?
- If passive, does it serve emphasis, mystery, or receiver-focus?
- Convert default passives to active

---

### State P6: Inconsistent Voice

**Symptoms:** Diction level shifts randomly. Sentence structure varies wildly without purpose. Different sections feel like different writers. Narrator doesn't sound like one person.

**Key Questions:**
- Does diction level shift without purpose?
- Does sentence structure vary wildly?
- Do different sections feel consistent?
- Is there a baseline voice to return to?

**Levels of Diction:**

| Level | Description | Example |
|-------|-------------|---------|
| High/Formal | Elevated, literary | "The conflagration consumed the edifice" |
| Middle/Standard | Educated but accessible | "The fire destroyed the building" |
| Low/Informal | Conversational | "The place burned down" |

**Diagnostic Checklist:**
- [ ] Diction level consistent for narrator
- [ ] Shifts in voice are intentional, not accidental
- [ ] Tone consistent across manuscript
- [ ] Relationship to reader (distance/intimacy) maintained

**Interventions:**
- Establish baseline voice (diction level, rhythm patterns)
- Vary from baseline intentionally for effect
- Ensure shifts are character/scene-driven, not author inconsistency
- Audit for intrusive author voice in close POV

---

## The Strunk & White Principles

From *The Elements of Style*, foundational guidance:

1. **Use the active voice** (generally)
2. **Put statements in positive form**
3. **Use definite, specific, concrete language**
4. **Omit needless words**
5. **Avoid a succession of loose sentences**
6. **Express coordinate ideas in similar form** (parallelism)
7. **Keep related words together**
8. **Place the emphatic words at the end**

**Caveat:** These are principles, not laws. The goal is intentional choice, not mechanical obedience.

---

## Word Choice Reference

### Concrete vs. Abstract

**Abstract:** happiness, freedom, love, time
**Concrete:** laughter, unlocked door, kiss, clock

The issue isn't abstraction itself—it's vague abstraction that avoids precision.
- Weak: "happiness"
- Strong: "the particular happiness of a child with a new dog"

### Common Word Choice Traps

| Trap | Description | Fix |
|------|-------------|-----|
| **Thesaurus abuse** | Obscure synonyms for common words | Use the right word, even if repeated |
| **Elegant variation** | Different words for same thing | Repetition is fine; clarity matters |
| **Jargon creep** | Technical language where plain works | Use simplest word that fits |

---

## Sentence Structure Reference

### The Punch Position

The end of a sentence carries the most weight.

- Weak: "It was a dark night, I remember"
- Strong: "I remember: it was a dark night"

### Parallelism

Parallel structure creates rhythm and emphasis:
- "Veni, vidi, vici"
- "It was the best of times, it was the worst of times"

**Faulty parallelism:**
- Wrong: "She likes reading, to swim, and runs"
- Right: "She likes reading, swimming, and running"

### Sentence Variety Guide

| Length | Effect | Use For |
|--------|--------|---------|
| Short | Punch, urgency | Emphasis, action, revelation |
| Medium | Clarity, flow | Default narrative |
| Long | Development, immersion | Building complexity, flowing prose |

---

## The Read-Aloud Test

The most reliable prose diagnostic: **read it aloud**.

What the ear catches that the eye misses:
- Awkward rhythm
- Repeated words
- Sentences that don't breathe
- Missing transitions
- Overwrought passages

> "From the point of view of ear, Virginia Woolf never wrote a bad sentence."
> — Truman Capote

**Rule:** If you stumble reading it, revise it.

---

## Anti-Patterns

### The Thesaurus Abuser
**Pattern:** Replacing common words with obscure synonyms for variety.
**Problem:** Sacrifices clarity for artificial variety.
**Fix:** Use the right word, even if you used it recently.

### The Adjective Hoarder
**Pattern:** Stacking modifiers hoping something sticks.
**Problem:** Weakens rather than strengthens description.
**Fix:** Choose one right adjective. Or none—let the noun work.

### The Passive Defaulter
**Pattern:** Writing in passive voice without intention.
**Problem:** Prose loses energy and directness.
**Fix:** Default to active. Use passive deliberately.

### The Monotone
**Pattern:** Every sentence same length and structure.
**Problem:** Creates droning effect; reader disengages.
**Fix:** Vary intentionally. Short sentences punch. Long sentences flow.

### The Purple Writer
**Pattern:** Style overwhelming substance.
**Problem:** Reader sees the writing, not the story.
**Fix:** Serve the story. Kill your darlings if they distract.

### The Rule Slave
**Pattern:** Following every prescription mechanically.
**Problem:** Loses the art in favor of rules.
**Fix:** Understand principles, not just rules. Break rules intentionally.

---

## Diagnostic Process

When a writer presents prose problems:

### 1. Identify the Problem Type

- Does it feel flat/boring? → P1 (Flat Prose)
- Is it hard to follow? → P2 (Unclear Writing)
- Does it feel overwritten? → P3 (Overwrought)
- Does everything sound the same? → P4 (Monotonous)
- Does it feel weak/indirect? → P5 (Passive Overuse)
- Does the voice shift randomly? → P6 (Inconsistent Voice)

### 2. Apply the Read-Aloud Test

Have writer read problematic passages aloud. What do they stumble on?

### 3. Check Multiple Levels

- Word level: precision, redundancy
- Sentence level: variety, clarity, parallelism
- Paragraph level: length, flow, transitions
- Voice level: consistency, diction, tone

### 4. Recommend Interventions

Based on identified state, provide specific fixes.

---

## Integration with story-sense

| story-sense State | Maps to Prose Style State |
|-------------------|--------------------------|
| State 5.9: Prose is Flat | P1-P6 (diagnose which specifically) |

### When to Hand Off

- **To revision:** When prose issues require systematic pass through manuscript
- **To dialogue:** When prose problems appear specifically in dialogue
- **To scene-sequencing:** When rhythm problems are at scene level, not sentence level

### Prerequisites

**Do NOT use prose-style when:**
- Structure is still broken (fix structure first)
- Scenes need cutting (don't polish what will be cut)
- Character arcs incomplete (fix story before prose)

Prose style is last-mile work. Complete developmental revision first.

---

## Available Tools

### prose-check.ts

Analyzes prose patterns for common issues.

```bash
deno run --allow-read scripts/prose-check.ts chapter.txt
deno run --allow-read scripts/prose-check.ts --text "The passive sentence was written..."
```

**Detects:**
- Passive voice percentage
- Weak verb frequency
- Adverb density
- Filter word usage
- Adjective stacking

### rhythm.ts

Analyzes rhythm and variety patterns.

```bash
deno run --allow-read scripts/rhythm.ts chapter.txt
deno run --allow-read scripts/rhythm.ts --text "Short. Then longer. Then short again."
```

**Reports:**
- Sentence length distribution
- Paragraph length variation
- Opening word variety
- Rhythm score (variety metric)

---

## Example Interactions

### Example 1: Flat Prose

**Writer:** "My beta readers say my prose is functional but forgettable."

**Your approach:**
1. Identify state: P1 (Flat Prose)
2. Run rhythm.ts to check variety
3. Ask: "Read a paragraph aloud. What do you notice?"
4. Check: sentence lengths, word precision, rhythm
5. Recommend: vary sentence length, replace generic words with specific

### Example 2: Purple Prose

**Writer:** "People say my writing is overwrought but I like rich prose."

**Your approach:**
1. Identify state: P3 (Overwrought)
2. Distinguish: Rich prose serves the story; purple overwhelms it
3. Ask: "Does the style serve the story or call attention to itself?"
4. Check for: adjective stacking, adverb abuse, mixed metaphors
5. Recommend: cut modifiers, simplify metaphors, let strong nouns/verbs work

### Example 3: Inconsistent Voice

**Writer:** "Different chapters feel like different writers."

**Your approach:**
1. Identify state: P6 (Inconsistent Voice)
2. Ask: "What's your narrator's baseline voice?"
3. Check: diction level shifts, rhythm pattern changes
4. Recommend: establish baseline, vary intentionally from it

---

## Output Persistence

This skill writes primary output to files so work persists across sessions.

### Output Discovery

**Before doing any other work:**

1. Check for `context/output-config.md` in the project
2. If found, look for this skill's entry
3. If not found or no entry for this skill, **ask the user first**:
   - "Where should I save output from this prose-style session?"
   - Suggest: `explorations/prose/` or a sensible location for this project
4. Store the user's preference:
   - In `context/output-config.md` if context network exists
   - In `.prose-style-output.md` at project root otherwise

### Primary Output

For this skill, persist:
- **Prose state diagnosis** - which style issues apply
- **Sentence-level patterns** - identified strengths and weaknesses
- **Voice baseline notes** - established voice characteristics
- **Intervention recommendations** - specific techniques to try

### Conversation vs. File

| Goes to File | Stays in Conversation |
|--------------|----------------------|
| Prose state diagnosis | Clarifying questions |
| Pattern identification | Discussion of specific passages |
| Voice baseline definition | Writer's experimentation |
| Recommended techniques | Real-time feedback |

### File Naming

Pattern: `{story}-prose-{date}.md`
Example: `novel-chapter5-prose-2025-01-15.md`

## What You Do NOT Do

- You do not rewrite prose for writers
- You do not diagnose before structure is solid (hand off to story-sense)
- You do not make mechanical rules absolute
- You do not dismiss rich prose as automatically "purple"

Your role is diagnostic: identify the problem, explain why it's a problem, and guide toward the fix. The writer does the writing.

---

## Key Insight

Prose is invisible when it works. The reader should experience the story, not notice the writing. When prose calls attention to itself—whether through flatness, confusion, or excess—it interrupts the dream.

The goal is not "good writing" in the abstract. The goal is writing that serves this specific story, these specific characters, this specific moment. Sometimes that means sparse. Sometimes rich. Always intentional.

© jwynia · MIT · jwynia/agent-skills

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

Всё по теме «Тексты и документация» →
writing-style-and-tone social-media-skills Правит черновики так, чтобы они не звучали как ChatGPT: ритм, конкретика, тон под момент. Пригодится, когда пост вычитан, но читать его тяжело. CX Codex +1 641установок jev-prose pchalasani Скилл гоняет черновик через CLI jev-prose, получает отчёт о шаблонных AI-оборотах и правит текст по нему. Пригодится, когда пишешь абзацы и хочешь убрать штампы. CX Codex +1 ★ 2 020звёзд репо sepia Nanako0129 Скилл убирает признаки машинного текста в художественной прозе и рабочих документах. Он помогает переписать чейнджлоги, тикеты и статьи живым языком. CX Codex +1 1 400установок clarity addyosmani Помогает редактировать и рецензировать статьи или документацию без выдуманных фактов и шаблонных нейросетевых фраз. CX Codex +1 1 200установок better-writing forjd Переписывает, черновики и вычитывает прозу: письма, отчёты, документацию, тексты интерфейса. Полезен, когда текст звучит шаблонно или по-чатботовски. CX Codex +1 514установок writing-principles haowjy Скилл объясняет, чего ждут читатели художественной прозы и как обучение LLM эти ожидания ломает. Пригодится при черновике, критике или когда сцена кажется плоской. CX Codex +1 1 000установок

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

system-design Разбирает проблемы проектирования и помогает соло-разработчику перейти от требований к архитектуре, компонентам и интерфейсам. CX Codex +1 647установок story-sense Скилл разбирает, в каком состоянии находится ваша история и что ей мешает двигаться дальше. Для писателей, которые застряли и не понимают почему. CX Codex +1 646установок character-arc Помогает продумать внутренний путь героя и найти, почему перемена в финале не убеждает. CX Codex +1 614установок interactive-fiction Разбирает проблемы ветвящегося нарратива: выборы без последствий, неразрешимое ветвление, конфликт свободы игрока и авторской истории. CX Codex +1 558установок pptx-generator Собирает презентации PowerPoint из шаблона с подстановкой текста или с нуля по JSON-описанию. Пригодится, когда отчёт или питч-дек нужно собрать кодом, а не руками в PowerPoint. CX Codex +1 541установок musical-dna Разбирает музыку артиста на приёмы и звуковые качества, чтобы описать её без упоминания имени. Пригодится для промптов к генераторам музыки. CX Codex +1 540установок research-workflow Ведёт агента через планирование, серию поисковых запросов, разбор источников и сборку вывода. Пригодится, когда нужен отчёт, а не одна быстрая справка. CX Codex +1 519установок good-thinking Скилл для аудита того, как агент рассуждает: где операции работают впустую и какая ориентация ими управляет. CX Codex +1 513установок

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

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