Manage multi-level novel revisions while preventing cascade problems. Use when editing novels, when changes at one level break things at others, when you need systematic change management for long-form fiction, or when revisions keep creating new problems.
4k tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
128
stars on the repo
on the repository, not the skill itself
Install
one command, takes just this skill from the repository
You help writers manage revisions across multiple levels of abstraction while preventing unintended consequences from cascading through the narrative. Your role is to implement systematic change management that maintains story coherence.
Core Principle: Cascade Awareness
Any change at one level potentially affects all other levels. Changes propagate both upward (prose discoveries revealing structural problems) and downward (structural changes requiring prose rewrites).
The Three Levels
Every novel operates simultaneously across these levels:
Thematic/Conceptual Level
Core themes and meaning
Character growth arcs
Symbolic elements and motifs
Overall message and emotional journey
Structural Level
Plot beats and story architecture
Scene sequences and chapter organization
Pacing and rhythm
Tension patterns and resolution cycles
Manuscript Level
Actual prose and dialogue
Descriptive passages
Voice and style consistency
Line-level craft elements
Pre-Change Analysis Protocol
Before implementing any revision:
1. Identify the Change Level
Conceptual: Changing themes, character motivations, meaning
Structural: Altering plot beats, scene order, pacing
Prose: Improving language, dialogue, descriptions
2. Map Forward Consequences
For each proposed change, document:
Immediate (1-2 chapters): What must change next?
Medium-term (3-5 chapters): What implications ripple forward?
Story-wide: How might this affect ending or major plot points?
3. Create Monitoring Criteria
Define warning signs that indicate problems:
Character behavior inconsistencies
Plot logic gaps
Pacing anomalies
Thematic contradictions
Change Implementation Workflow
Phase 1: Impact Assessment
Document current state: Snapshot relevant story elements
Project consequences: Write expected chain of implications
Set checkpoints: Identify where you'll evaluate
Define rollback triggers: Clear criteria for aborting
Phase 2: Controlled Implementation
Make minimal viable change: Smallest version that tests hypothesis
Monitor immediately: Check for local coherence problems
Document observations: Note unexpected effects
Evaluate against projections: Compare actual to predicted
Phase 3: Ripple Management
Identify required updates: What else must change?
Prioritize cascade tasks: Order by importance and dependency
Track completion: Explicit lists of updated vs. pending
Validate consistency: Check updates work together
Revision Types and Protocols
Character Development Revisions
Triggers: Character feels flat, motivations unclear, arc incomplete
Protocol:
Map current character state across all chapters
Identify scenes where growth should be visible
Project how changes affect dialogue/actions later
Check consistency with other characters' responses
Monitoring: Does behavior remain believable? Do others respond appropriately?
Prioritize: Current revision protocol, active change record
Defer: Full protocol list, multi-agent coordination
Drop: Best practices, diagnostic questions
Anti-Patterns
1. Unassessed Changes
Pattern: Making revisions without first analyzing what else might be affected—jumping straight to implementation.
Why it fails: Changes cascade. A character motivation change affects every scene where that character makes choices. Unassessed changes create problems you discover pages later, often after you've built on broken foundation.
Fix: Before every significant change, explicitly document: what must change as a result? What might break? Set monitoring criteria before implementation, not after.
2. Warning Sign Blindness
Pattern: Noticing that something feels off after a change but pushing forward anyway, trusting it will resolve itself.
Why it fails: Early warnings are cheap signals about expensive problems. Characters acting against established personality, plot logic gaps, pacing anomalies—these compound. The deeper you go, the more expensive the fix.
Fix: Treat early warnings as actionable information. Stop, evaluate, decide to either fix now or explicitly accept the risk. Don't let "I'll fix it later" accumulate.
3. Cascade Debt
Pattern: Making changes without tracking the secondary edits they require—accumulating a backlog of unaddressed implications.
Why it fails: Untracked cascade tasks become invisible technical debt. You think you made one change; you actually made one change and created ten unfixed inconsistencies.
Fix: Maintain explicit cascade task lists. When a change requires follow-up edits, write them down immediately. Track completion. Don't move on until cascade is resolved.
4. Sunk Cost Persistence
Pattern: Continuing with a problematic change because you've already invested significant effort, even when warning signs multiply.
Why it fails: The effort is gone either way. Continuing down a broken path just adds more lost effort. Multiple warning signs within two chapters usually indicate fundamental problems.
Fix: Define rollback triggers before implementation. When triggers fire, roll back. Document what you learned. The insight is valuable even if the change wasn't.
5. Activity Confusion
Pattern: Measuring progress by pages revised rather than by improvement achieved—conflating work with results.
Why it fails: You can revise extensively without making the story better. In fact, you can revise extensively and make it worse. Activity that doesn't serve story goals is waste.
Fix: Define what "better" means for each revision pass. Measure against that goal, not against pages touched. Sometimes the best revision is no revision.
Integration
Inbound (feeds into this skill)
| Skill | What it provides |
|-------|------------------|
| story-sense | Diagnosis of what needs revision |
| character-arc | Character consistency requirements |
| scene-sequencing | Pacing and structure requirements |
Outbound (this skill enables)
| Skill | What this provides |
|-------|-------------|
| prose-style | Manuscript-level changes with cascade awareness |
| revision | Scene-level work with multi-level coordination |
| (completed novel) | Final product with maintained coherence |
Complementary
| Skill | Relationship |
|-------|--------------|
| story-sense | Story-sense diagnoses problems; novel-revision manages the fix without creating new problems |
| revision | Revision handles sentence and scene level; novel-revision coordinates across the whole manuscript |
How to use it
Copy the folder
Take jwynia/novel-revision from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
Check the name does not clash
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.