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.

191 stars 24 forksOther

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add jwynia/agent-skills --skill revision
Manual install
git 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/revision

Personal 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
Read the full skill on GitHub

Details

Skill name
revision
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

Browse the most popular Claude skills, all other skills, or write your own with the skills generator.