Agent skill

Developmental Editing

by revfactory in revfactory/harness-100

A specialized skill for the manuscript-editor agent covering developmental editing.

Apache-2.0Auto-check passedWriting & Content

Install Developmental Editing

skills CLI
$ npx skills add revfactory/harness-100 --skill developmental-editing -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install revfactory/harness-100 developmental-editing --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/revfactory/harness-100.git skills-src && mkdir -p .claude/skills && cp -r skills-src/en/11-book-publishing/.claude/skills/developmental-editing .claude/skills/developmental-editing && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
developmental-editing
GitHub stars
1.3k
Token cost
~1.5k tokens
SKILL.md length
561 words
Files
1
Skills in repo
464
Repo updated
First seen
Licence
Apache-2.0

At a glance

A specialized skill for the manuscript-editor agent covering developmental editing.

  • Works in 12 steps: What is the reason this book must exist? → What changes for the reader after… → Does the first page grab the reader? → …
  • Manuscript editing
  • SKILL.md covers Why Developmental Editing, Manuscript Structure…, Genre-Specific Editing Standards and Pacing Analysis Tools, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Developmental Editing is an agent skill from revfactory/harness-100. A specialized skill for the manuscript-editor agent covering developmental editing. Provides manuscript structure analysis, narrative arc diagnostics, character arc design, pacing adjustment, and genre-specific editing standards. Use for 'manuscript editing,' 'structural editing,' 'narrative analysis,' 'manuscript feedback,' and similar topics.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Writing & Content. The licence is Apache-2.0.

When your agent uses it

  • Manuscript editing
  • Structural editing
  • Narrative analysis
  • Manuscript feedback

Example prompts

  • “manuscript editing,”
  • “structural editing,”
  • “narrative analysis,”
  • “/developmental-editing”

Workflow steps

12 steps, taken from the first numbered list in SKILL.md.

  1. What is the reason this book must exist?
  2. What changes for the reader after reading this book?
  3. Does the first page grab the reader?
  4. Does each chapter contribute to the whole? Are there any chapters that could be removed?
  5. Which is the weakest chapter?
  6. Where will readers drop off?
  7. Is the core message being repeatedly reinforced?
  8. Are there enough case studies/stories?
  9. Is the vocabulary appropriate for the reader level?
  10. Is the ending satisfying?
  11. (Fiction) Does the protagonist change?
  12. (Fiction) Is there conflict in every chapter?

What it can do on your machine

Read from SKILL.md and the folder at commit 8e8d35c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Developmental Editing loads about 1.5k tokens when it runs. Until then it costs about 92 tokens; SKILL.md has 561 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~92
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from revfactory/harness-100 at commit 8e8d35c, republished under its Apache-2.0 licence (© revfactory). 561 words, ~1,492 tokens.

Download SKILL.mdSave it as .claude/skills/developmental-editing/SKILL.md (or your agent's skills folder).
name
developmental-editing
description
A specialized skill for the manuscript-editor agent covering developmental editing. Provides manuscript structure analysis, narrative arc diagnostics, character arc design, pacing adjustment, and genre-specific editing standards. Use for 'manuscript editing,' 'structural editing,' 'narrative analysis,' 'manuscript feedback,' and similar topics.

Developmental Editing — Developmental Editing Methodology

Specialized editing knowledge used by the manuscript-editor agent when structurally editing manuscripts.

Why Developmental Editing

Proofreading (spelling/grammar) is only 10% of editing. Developmental editing diagnoses and improves the manuscript's structure, narrative, characters, and pacing — the core work that determines a book's quality.

Manuscript Structure Diagnostics: SPINE Check

ElementCheck ItemDiagnostic Question
StructureOverall structureDoes the table of contents create a logical flow? Does each chapter contribute to the whole?
PacingPacingAre there sagging sections? Is the climax timing appropriate?
IntentionIntentIs the author's core message clear?
NarrativeNarrative/Logic(Fiction) Is the narrative arc complete? (Non-fiction) Is the argumentation solid?
EngagementReader engagementDoes the reader want to keep reading? Is the first chapter compelling?

Genre-Specific Editing Standards

Business/Self-Help
Editing CriterionIdeal StateCommon Problem
Core MessageSummarizable in one sentenceMultiple topics scattered randomly
StructureProblem->Cause->Solution->Action or framework-centeredAnecdote listing with no system
Case StudiesAt least 1 concrete case per chapterTheory only, no cases
ActionabilityReader can take immediate actionOnly abstract advice listed
First ChapterDirectly targets reader's pain/desireStarts with author self-introduction
Fiction
Editing CriterionIdeal StateCommon Problem
OpeningTension/curiosity from the first pageStarts with scenery description or setting explanation
CharactersProtagonist has deficiency + desire + changeFlat, no change
ConflictConflict or tension in every chapterEvents listed without conflict
DialogueUnique speech patterns per characterAll characters speak the same way
EndingEmotional satisfaction + narrative resolutionAbrupt conclusion
Essay
Editing CriterionIdeal StateCommon Problem
Unique PerspectiveAuthor's distinctive viewpoint emergesGeneric observations anyone could make
Sensory DescriptionConcrete scenes, sensory detailsAbstract emotional statements
StructureFlow and thematic connections between essaysRandom arrangement
DepthReflection beyond the surfaceDiary-level recording

Pacing Analysis Tools

Chapter Energy Mapping

Rate each chapter's energy level 1-10 and map:

Energy
10|        *
 8|    *       *
 6|  *   *       *   *
 4|*       *       *   *
 2|                       *
  +------------------------- Chapter
  1  2  3  4  5  6  7  8  9  10
Pacing Problem Diagnosis
PatternProblemSolution
Constantly high (8,9,8,9,8)Reader fatigue, emotional numbnessInsert relaxation chapters
Constantly low (3,4,3,2,3)Boredom, drop-offAdd conflict/crisis, merge chapters
Low first chapter (2)Reader never startsMove a powerful mid-section scene forward
Low ending (3)Anti-climaxRedesign the ending
Midpoint slump (7,8,3,3,3,8)Mid-section drop-offInsert "midpoint reversal"
Show full SKILL.md (207 more words)Show less

Editing Feedback Writing

3-Tier Editing Notes
TierScopeExample
MacroOverall structure"Swapping chapters 3 and 5 would improve logical flow"
MediumChapter/section level"The latter half of this chapter drags. Keep only 1 core case study"
MicroSentence/paragraph"This metaphor obscures the core message"
Editing Report Format
## Editing Report

### Overall Assessment Summary
[2-3 strengths + 2-3 key improvements]

### Structural Feedback (Macro)
[Overall structure opinions, chapter reordering suggestions, etc.]

### Chapter-by-Chapter Feedback (Medium)
#### Chapter 1: [Title]
- Strengths: [Specific]
- Improvements: [Specific + suggestion]
- Energy Level: [1-10]

#### Chapter 2: ...

### Style/Tone Feedback
[Consistency, reader-level appropriateness, genre fit]

### Priority Revisions (TOP 5)
1. [Most important revision]
2. ...

### Words of Encouragement
[Positive closing for the author]

Editor's 20 Key Questions

  1. What is the reason this book must exist?
  2. What changes for the reader after reading this book?
  3. Does the first page grab the reader?
  4. Does each chapter contribute to the whole? Are there any chapters that could be removed?
  5. Which is the weakest chapter?
  6. Where will readers drop off?
  7. Is the core message being repeatedly reinforced?
  8. Are there enough case studies/stories?
  9. Is the vocabulary appropriate for the reader level?
  10. Is the ending satisfying?
  11. (Fiction) Does the protagonist change?
  12. (Fiction) Is there conflict in every chapter?
  13. (Non-fiction) Is the argumentation watertight?
  14. (Non-fiction) Have counterarguments been addressed?
  15. Does the title accurately reflect the content?
  16. Does the subtitle complement the title?
  17. Can the book's flow be grasped from the table of contents alone?
  18. Is there unnecessary repetition?
  19. Is the tone consistent?
  20. What differentiates this book from its competitors?

© revfactory, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in en/11-book-publishing/.claude/skills/developmental-editing of revfactory/harness-100.

Open the folder on GitHubat commit 8e8d35c

Compare with similar skills

Developmental Editing next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Developmental Editing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Developmental Editing this skillrevfactory/harness-1001.3k—~1.5kAutomated safety check: PassApache-2.0
HumanizerAzure-Samples/interview-coach-agent-framework17237 repos~5.8kAutomated safety check: PassMIT
Avoid AI Writingconorbronsdon/avoid-ai-writing4.9k3 repos~8.1kAutomated safety check: PassMIT
JavaScript Concept Fact Checkerleonardomso/33-js-concepts67k1 repos~5kAutomated safety check: PassMIT
User-Facing Text Cleanupguillaumemeyer/watermarks-remover23k—~3.5kAutomated safety check: PassMIT
Install Anti Sloptrycompai/crm11k1 repos~881Automated safety check: PassMIT

Similar skills

  • Humanizer

    Azure-Samples/interview-coach-agent-framework

    Official

    Remove signs of AI-generated writing from text. An agent skill from Azure-Samples/interview-coach-agent-framework.

    172 GitHub starsUsed in 37 repos~5.8k tokens
    Writing & ContentAuto-check passed
  • Avoid AI Writing

    conorbronsdon/avoid-ai-writing

    Audit and rewrite content to remove AI writing patterns ("AI-isms").

    4.9k GitHub starsUsed in 3 repos~8.1k tokens
    Writing & ContentAuto-check passed
  • JavaScript Concept Fact Checker

    leonardomso/33-js-concepts

    Verifies the technical accuracy of JavaScript concept pages by checking code examples, MDN and ECMAScript claims and external links through a five-phase method.

    67k GitHub starsUsed in 1 repo~5k tokens
    Writing & ContentAuto-check passed
  • User-Facing Text Cleanup

    guillaumemeyer/watermarks-remover

    Audits prose for invisible Unicode characters and rewrites it while keeping facts, citations, code and required disclosures unchanged and the writer's voice intact.

    23k GitHub stars~3.5k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Install Anti Slop

    trycompai/crm

    Install and configure the anti-slop Oxlint plugin in a local TypeScript or JavaScript repository.

    11k GitHub starsUsed in 1 repo~881 tokens
    Writing & ContentAuto-check passed
  • Social Content

    freekmurze/dotfiles

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms.

    1k GitHub starsUsed in 22 repos~2.1k tokens
    Writing & ContentAuto-check passed

More from revfactory/harness-100

All 464 skills in this repo
  • Anti Bot Analyzer

    revfactory/harness-100

    A skill for analyzing website anti-bot defense mechanisms and developing legitimate evasion strategies.

    1.3k GitHub stars~1.1k tokensUpdated 6 mo ago
    Auto-check passed
  • API Error Design Patterns

    revfactory/harness-100

    Reference for designing how an API reports failures: structured error codes, response shapes, client-friendly messages, an error catalog and retry or fallback advice.

    1.3k GitHub stars~1.6k tokensUpdated 6 mo ago
    Auto-check passed
  • API Security Checklist

    revfactory/harness-100

    Walks a backend-dev agent through OWASP API Top 10 checks, authentication and authorization patterns, and defense code during API design.

    1.3k GitHub stars~1.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Arg Parser Generator

    revfactory/harness-100

    Methodology for systematically designing and generating CLI tool argument parser structures.

    1.3k GitHub stars~1.2k tokensUpdated 6 mo ago
    Auto-check passed
  • Audience Segmentation

    revfactory/harness-100

    Audience segmentation skill used by the analyst and curator agents.

    1.3k GitHub stars~1.3k tokensUpdated 6 mo ago
    Auto-check passed
  • Audio Storytelling

    revfactory/harness-100

    Audio storytelling skill used by the podcast scriptwriter and show note editor.

    1.3k GitHub stars~1.6k tokensUpdated 6 mo ago
    Auto-check passed

Questions about Developmental Editing

What does Developmental Editing do?

A specialized skill for the manuscript-editor agent covering developmental editing. Developmental Editing is an agent skill from revfactory/harness-100. A specialized skill for the manuscript-editor agent covering developmental editing.

When should I use Developmental Editing?

Developmental Editing fits situations like: manuscript editing; structural editing; narrative analysis; manuscript feedback.

How do I install Developmental Editing in Claude Code?

Run `npx skills add revfactory/harness-100 --skill developmental-editing -a claude-code`. Or copy the skill folder (en/11-book-publishing/.claude/skills/developmental-editing in revfactory/harness-100) into .claude/skills/developmental-editing in your project. Claude Code loads it when a task matches its description.

How do I install Developmental Editing in Codex?

Run `npx skills add revfactory/harness-100 --skill developmental-editing -a codex`. Or copy the skill folder (en/11-book-publishing/.claude/skills/developmental-editing in revfactory/harness-100) into .agents/skills/developmental-editing in your project. Codex loads it when a task matches its description.

Can I use Developmental Editing in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add revfactory/harness-100 --skill developmental-editing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/developmental-editing, .gemini/skills/developmental-editing, .github/skills/developmental-editing and .opencode/skills/developmental-editing in your project.

What does Developmental Editing need to run?

SKILL.md names no scripts, command-line tools or credentials: Developmental Editing is instructions for the agent only.

Does Developmental Editing access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Developmental Editing safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Developmental Editing use?

Developmental Editing is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Developmental Editing use?

About 1.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Developmental Editing?

Skills that share tags, products or a category with Developmental Editing: Humanizer (Azure-Samples/interview-coach-agent-framework, 172 stars), Avoid AI Writing (conorbronsdon/avoid-ai-writing, 4.9k stars), JavaScript Concept Fact Checker (leonardomso/33-js-concepts, 67k stars) and User-Facing Text Cleanup (guillaumemeyer/watermarks-remover, 23k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Developmental Editing?

revfactory (a GitHub user) maintains it in revfactory/harness-100, which has 1,290 GitHub stars. The repository holds 464 skills in this directory. The repository was last updated on March 22, 2026.

Source: revfactory/harness-100 on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.