revision

Guide manuscript revision through a six-pass hierarchical editing workflow.

Updated Feb 28, 2026
One-click install
npx skills add https://github.com/tunnckoCore/agent-skills --skill revision-tunnckocore
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: revision
Source: https://github.com/tunnckoCore/agent-skills/tree/main/skills/creative-fiction-writing/craft/revision
Command: npx skills add https://github.com/tunnckoCore/agent-skills --skill revision-tunnckocore

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps writers navigate the often overwhelming process of manuscript revision, providing a structured approach to identify and fix problems at different scales, ensuring a polished and coherent final draft.

Core Features & Use Cases

  • Hierarchical Editing: Guides users through developmental, line, and copy editing stages in the correct order.
  • Problem Diagnosis: Helps identify common revision roadblocks like feeling overwhelmed, writer's blindness, or endless tweaking.
  • Systematic Passes: Outlines a six-pass system (Structural, Scene, Character, Dialogue, Prose, Polish) for focused editing.
  • Use Case: A novelist has finished a draft but feels lost. They use this Skill to diagnose their state (e.g., "Overwhelmed"), understand the revision hierarchy, and begin with a structural pass to ensure the story's foundation is solid before refining prose.

Quick Start

Use the revision skill to help me start the structural pass on my manuscript.

Frequently Asked Questions about revision

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I start revising my manuscript when I feel overwhelmed by the draft?

To start revising an overwhelming manuscript, you diagnose your specific roadblock and begin with a structural editing pass. This hierarchical approach ensures the story foundation is solid before moving to scene, character, and prose refinement.

What is the correct order for editing prose and story structure?

The correct editing order is hierarchical: developmental edits for story structure come first, followed by scene and line editing, and ending with fine-grained copyediting. Attempting prose polish before fixing structural issues causes inefficient revision loops.

How do I systematically edit a novel draft to avoid endless tweaking?

You avoid endless tweaking by using a systematic six-pass workflow: Structural, Scene, Character, Dialogue, Prose, and Polish. This framework provides clear completion criteria for each pass, ending revision paralysis and ensuring a coherent final draft.

Can I integrate external feedback into the manuscript revision process?

Yes, the revision process supports integration with external feedback. You can incorporate outside notes during the diagnostic phase or within specific editing passes to systematically address identified issues across the manuscript hierarchy.

How do I know when my manuscript revision is actually finished?

Your manuscript revision is finished when it meets the defined clear completion criteria for the final polish pass. This systematic framework prevents endless tweaking by establishing specific quality benchmarks for prose and copyediting.