Revision
This diagnostic helps you stop thrashing during revision by enforcing the hierarchy that matters: fix structure before polishing sentences. It identifies six revision states like "can't see problems anymore" or "editing never ends" and gives you concrete interventions for each. The six-pass system keeps you from wasting time on prose in scenes you'll cut later. Most useful when you're paralyzed by competing feedback or knee-deep in line edits before confirming your story actually works. The "darlings folder" advice for delete-phobic writers is solid. Basically stops you from optimizing the wrong level at the wrong time.
- skills.sh installs
- 479
- GitHub stars
- 182
- last updated
- Aug 21, 2026
Install
$ npx -y skills add jwynia/agent-skills --skill revision --agent claude-codeInstalls into .claude/skills of the current project.
Files
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:
- Developmental (structure, story)
- Line (sentences, paragraphs)
- 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.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/jwynia/agent-skills
- Categories
- Documentation, AI & Agent Building
- First seen
- Jun 3, 2026
More from jwynia/agent-skills
All 118- Cliche Transcendence477
- Oblique Worldbuilding477
- Outline Collaborator477
- Settlement Design466
- Shared World466
- Context Retrospective462
- Endings461
- Governance Systems461
- Shadcn Layouts460
- Drafting454
- Story Zoom452
- Belief Systems451
- Voice Analysis451
- Reverse Outliner448
- Pwa Development447
- Chapter Drafter443
- Language Evolution439
- Book Marketing438
- Product Analysis438
- Context Network436
- Speech Adaptation436
- Competency Builder434
- World Fates432
- Sensitivity Check423
Recommended
More Documentation
agent-package-managerwebmaxru/enonic-agent-skillsInstalls, configures, audits, and operates Agent Package Manager (APM) in repositories. Use when initializing apm.yml, installing or updating packages, validati479skills.sh installs
tiptapjezweb/claude-skillsBuild rich text editors with Tiptap - headless editor framework with React and Tailwind v4. Covers SSR-safe setup, image uploads, prose styling, and collaborati478skills.sh installs
content-idea-generatorbrianrwagner/ai-marketing-claude-code-skillsGenerate content ideas rooted in positioning. Use when someone needs "content ideas," "what should I post," "blog topics," "LinkedIn ideas," or is stuck on what477skills.sh installs
agentica-infrastructureparcadei/continuous-claude-v3Reference guide for Agentica multi-agent infrastructure APIs477skills.sh installs
permission-auditoruseai-pro/openclaw-skills-securityAnalyze OpenClaw skill permissions and explain exactly what each permission allows. Identifies over-privileged skills and suggests minimal permission sets.477skills.sh installs
kubernetes-orchestrationmanutej/luxor-claude-marketplaceComprehensive guide to Kubernetes container orchestration, covering workloads, networking, storage, security, and production operations474skills.sh installs