Novel Revision
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.
- Skill ID
- jwynia/agent-skills/novel-revision
- Publisher
- jwynia
- Repository
- agent-skills
- Installs
- 0
- Files
- 1
- License
- MIT
- Synced
- Sep 23, 2026
Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.
jwynia/agent-skills/novel-revisionInstalls these files- SKILL.md
What this skill tells the agent
Novel Revision: Multi-Level Change Management Skill
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?
Plot Structure Revisions
Triggers: Pacing off, events disconnected, climax lacks impact
Protocol:
- Create timeline of current plot beats
- Identify specific structural elements to change
- Map how timing changes affect tension
- Check causality chains still hold
Monitoring: Does tension build? Do plot points feel connected and inevitable?
Thematic Revisions
Triggers: Theme heavy-handed, unclear, or inconsistent
Protocol:
- Audit current thematic elements throughout manuscript
- Identify opportunities for subtler integration
- Check character actions support thematic development
- Ensure climax/resolution reinforce themes
Monitoring: Do themes emerge naturally? Does resolution feel thematically satisfying?
Early Warning Signs
| Warning Sign | What It Indicates |
|---|---|
| Character acts against personality without development | Consistency break |
| Events don't follow logically | Plot logic gap |
| Scenes feel rushed or drag unexpectedly | Pacing anomaly |
| Story events undermine themes | Thematic drift |
Intervention Protocols
When to Roll Back
- Multiple warning signs within 2 chapters
- Fundamental character or plot logic breaks
- Change creates more problems than it solves
- Cascade tasks become overwhelming
Rollback Procedure
- Identify rollback point: Return to last stable state
- Document lessons: What went wrong and why
- Revise approach: Alternative strategy based on learning
- Add safeguards: Monitoring to prevent recurrence
When to Push Forward
- Problems are localized and manageable
- Benefits clearly outweigh complications
- Cascade tasks are well-defined
- Core story logic remains intact
Change Record Template
# Revision: [Brief Description]
## Change Type
- [ ] Conceptual - [ ] Structural - [ ] Prose
## Rationale
[Why this change is needed]
## Predicted Consequences
- Immediate (1-2 chapters):
- Medium-term (3-5 chapters):
- Story-wide:
## Monitoring Criteria
- Warning sign 1:
- Warning sign 2:
- Success indicator 1:
- Success indicator 2:
## Implementation Status
- [ ] Initial change complete
- [ ] Cascade tasks identified
- [ ] Cascade tasks completed
- [ ] Validation complete
## Outcome Assessment
[Complete after implementation]Multi-Agent Collaboration
When working with multiple agents on revision:
Role Boundaries
- Structure Agent: Plot architecture and pacing
- Character Agent: Development and consistency
- Prose Agent: Language and voice
- Continuity Agent: Cross-level consistency
Communication Protocols
- Share intentions before implementation
- Report unexpected discoveries immediately
- Flag potential cross-level implications
- Coordinate cascade task assignments
Conflict Resolution
- Document what elements are in tension
- Escalate to human for creative resolution
- Explore alternative approaches
- Prioritize based on story goals
Best Practices
Start Small
- Incremental changes over major overhauls
- Test one element at a time
- Build confidence through small wins
Maintain Perspective
- Remember overall story goals
- Don't lose sight of what works
- Balance perfection with completion
Document Everything
- Capture insights during revision
- Record what works and doesn't
- Build knowledge for future projects
Trust the Process
- Allow time for changes to settle
- Don't rush to fix every minor issue
- Some problems resolve as story develops
Diagnostic Questions
When revision feels stuck:
- What level is this change really at?
- Have I mapped forward consequences?
- What would tell me this is working?
- What would tell me to roll back?
- Am I making minimal viable change?
- What cascade tasks does this create?
- Am I tracking completions explicitly?
Output Persistence
Output Discovery
- Check for
context/output-config.mdin the project - If found, look for this skill's entry
- If not found, ask user: "Where should I save revision tracking?"
- Suggest:
revision/orexplorations/revision/
Primary Output
- Change records - Using template for each significant change
- Cascade task lists - Secondary edits required by changes
- Monitoring log - Warning signs observed and addressed
- Rollback points - Snapshots of stable states
File Naming
Pattern: {novel-name}-revision-{date}.md
Verification (Oracle)
What This Skill Can Verify
- Impact assessment complete - Were consequences mapped? (High confidence)
- Cascade tracking - Are secondary tasks documented? (High confidence)
- Monitoring active - Are warning signs being watched? (Medium confidence)
What Requires Human Judgment
- Change necessity - Is this revision actually needed?
More from jwynia
Use this skill in a project
Open any RiverX project, search the Skills panel for jwynia/agent-skills/novel-revision, and install it in one click.
