Revision
Guide the edit pass after drafting. Use when revision feels overwhelming, when changes cascade unpredictably, when you can't see problems anymore, or when editing never ends.
Install
npx skills add jwynia/agent-skills --skill revisiongit clone --depth 1 https://github.com/jwynia/agent-skills.git /tmp/agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/agent-skills/skills/creative/fiction/craft/revision ~/.claude/skills/revisionPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Revision: Diagnostic Skill You diagnose revision-level problems and guide systematic manuscript improvement. Your role is to help writers work through revision efficiently and know when they're done. ## Core Principle **Revision is not one activity but many, each operating at a different scale.** Work from largest scale to smallest: 1. **Developmental** (structure, story) 2. **Line** (sentences, paragraphs) 3. **Copy** (mechanics, consistency) **Crucial insight:** Polishing prose in a scene you'll later cut is wasted effort. Fix structure first. --- ## The Revision Hierarchy ### Level 1: Developmental Editing Addresses the story itself—structure, character arcs, pacing, theme. **Questions:** - Does the story work? - Is the structure sound? - Do character arcs complete? - Is the pacing effective? - Does the ending satisfy? **What to look for:** - Plot holes and logic failures - Missing or weak character motivation - Scenes that don't advance plot or character - Pacing problems (too slow, too rushed) - Unclear or absent theme - Weak opening or ending - Inconsistent characterization **When done:** Story works at the structural level. Major changes complete. ### Level 2: Line Editing Addresses the writing itself—sentences, paragraphs, flow. **Questions:** - Does each sentence earn its place? - Is the prose clear and effective? - Does dialogue sound distinct? - Is description balanced with action? **What to look for:** - Awkward sentences - Passive voice overuse
Details
- Skill name
revision- Repository
- jwynia/agent-skills
- Path
skills/creative/fiction/craft/revision/SKILL.md- Repo updated
- 24 February 2026
FAQ
What does the Revision skill do?
Guide the edit pass after drafting. Use when revision feels overwhelming, when changes cascade unpredictably, when you can't see problems anymore, or when editing never ends.
How do I install the Revision skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add jwynia/agent-skills --skill revision. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Revision popular?
It lives in jwynia/agent-skills, which has 191 GitHub stars and 24 forks.
Related skills
Abstract Strategy
191jwynia/agent-skills
Design abstract strategy games with perfect information, no randomness, and strategic depth. Use when designing a board game, exploring abstract strategy games, brainstorming game mechanics, or evaluating game balance. Keywords: board game, game design, strategy, mechanics, balance.
Adaptation Synthesis
191jwynia/agent-skills
Synthesize new works from extracted functional DNA documents. Use when adapting a source work to a new context, when combining multiple source extractions, or when generating variations that preserve function while changing form.
Agent Bootstrap
191jwynia/agent-skills
Bootstrap agentic development environment from agent.toml manifest
Systemic Worldbuilding
191jwynia/agent-skills
Build worlds through cascading consequences from speculative changes. Use when introducing new technologies, species, or alternate histories and need to trace realistic societal transformations across multiple domains.
Response Coordinator
150guia-matthieu/clawfu-skills
Coordinate crisis response through structured playbooks, communication templates, and team orchestration
Table Tone
191jwynia/agent-skills
Diagnose and calibrate tonal delivery for tabletop RPG sessions. Use when narration feels flat, tone shifts jarringly, descriptions overwhelm play, or energy stays monotonous throughout sessions.
Browse the most popular Claude skills, all other skills, or write your own with the skills generator.