developmental-editing

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.

495 stars

Best use case

developmental-editing is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

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.

Teams using developmental-editing should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/developmental-editing/SKILL.md --create-dirs "https://raw.githubusercontent.com/revfactory/harness-100/main/en/11-book-publishing/.claude/skills/developmental-editing/skill.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/developmental-editing/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How developmental-editing Compares

Feature / Agentdevelopmental-editingStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

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.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# 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

| Element | Check Item | Diagnostic Question |
|---------|-----------|-------------------|
| **S**tructure | Overall structure | Does the table of contents create a logical flow? Does each chapter contribute to the whole? |
| **P**acing | Pacing | Are there sagging sections? Is the climax timing appropriate? |
| **I**ntention | Intent | Is the author's core message clear? |
| **N**arrative | Narrative/Logic | (Fiction) Is the narrative arc complete? (Non-fiction) Is the argumentation solid? |
| **E**ngagement | Reader engagement | Does the reader want to keep reading? Is the first chapter compelling? |

## Genre-Specific Editing Standards

### Business/Self-Help

| Editing Criterion | Ideal State | Common Problem |
|------------------|-------------|----------------|
| **Core Message** | Summarizable in one sentence | Multiple topics scattered randomly |
| **Structure** | Problem->Cause->Solution->Action or framework-centered | Anecdote listing with no system |
| **Case Studies** | At least 1 concrete case per chapter | Theory only, no cases |
| **Actionability** | Reader can take immediate action | Only abstract advice listed |
| **First Chapter** | Directly targets reader's pain/desire | Starts with author self-introduction |

### Fiction

| Editing Criterion | Ideal State | Common Problem |
|------------------|-------------|----------------|
| **Opening** | Tension/curiosity from the first page | Starts with scenery description or setting explanation |
| **Characters** | Protagonist has deficiency + desire + change | Flat, no change |
| **Conflict** | Conflict or tension in every chapter | Events listed without conflict |
| **Dialogue** | Unique speech patterns per character | All characters speak the same way |
| **Ending** | Emotional satisfaction + narrative resolution | Abrupt conclusion |

### Essay

| Editing Criterion | Ideal State | Common Problem |
|------------------|-------------|----------------|
| **Unique Perspective** | Author's distinctive viewpoint emerges | Generic observations anyone could make |
| **Sensory Description** | Concrete scenes, sensory details | Abstract emotional statements |
| **Structure** | Flow and thematic connections between essays | Random arrangement |
| **Depth** | Reflection beyond the surface | Diary-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

| Pattern | Problem | Solution |
|---------|---------|----------|
| Constantly high (8,9,8,9,8) | Reader fatigue, emotional numbness | Insert relaxation chapters |
| Constantly low (3,4,3,2,3) | Boredom, drop-off | Add conflict/crisis, merge chapters |
| Low first chapter (2) | Reader never starts | Move a powerful mid-section scene forward |
| Low ending (3) | Anti-climax | Redesign the ending |
| Midpoint slump (7,8,3,3,3,8) | Mid-section drop-off | Insert "midpoint reversal" |

## Editing Feedback Writing

### 3-Tier Editing Notes

| Tier | Scope | Example |
|------|-------|---------|
| **Macro** | Overall structure | "Swapping chapters 3 and 5 would improve logical flow" |
| **Medium** | Chapter/section level | "The latter half of this chapter drags. Keep only 1 core case study" |
| **Micro** | Sentence/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?

Related Skills

sustainability-audit

495
from revfactory/harness-100

Full audit pipeline for ESG/sustainability where an agent team collaborates to generate environmental, social, and governance assessments along with an integrated report and improvement plan. Use this skill for requests such as 'run an ESG audit', 'write a sustainability report', 'ESG assessment', 'carbon emissions calculation', 'ESG rating diagnosis', 'governance review', 'social responsibility assessment', 'GRI report', 'TCFD disclosure', 'ESG improvement plan', and other ESG/sustainability tasks. Also supports assessment of specific pillars (E/S/G) only or improving existing reports. However, actual on-site audit execution, third-party verification certificate issuance, ESG rating agency score changes, and carbon credit trading are outside the scope of this skill.

materiality-assessment

495
from revfactory/harness-100

ESG materiality assessment matrix. Referenced by the esg-reporter and improvement-planner agents when evaluating ESG issue materiality and setting priorities. Use for 'materiality assessment', 'importance analysis', or 'Materiality Matrix' requests. Stakeholder surveys and external certification are out of scope.

ghg-protocol

495
from revfactory/harness-100

GHG Protocol detailed guide. Referenced by the environmental-analyst agent when calculating and reporting greenhouse gas emissions. Use for 'GHG Protocol', 'carbon emissions', 'Scope 1/2/3', or 'carbon footprint' requests. Carbon credit trading and CDM project execution are out of scope.

citation-standards

495
from revfactory/harness-100

Academic citation and reference standards guide. Referenced by the paper-writer and submission-preparer agents when composing citations and references. Use for 'citation format', 'APA', or 'references' requests. Original paper retrieval and professional database access are out of scope.

academic-paper

495
from revfactory/harness-100

Full research pipeline for academic paper writing where an agent team collaborates to generate research design, experiment protocols, analysis, manuscript writing, and submission preparation. Use this skill for requests such as 'write an academic paper', 'research paper writing', 'help me write a paper', 'design a study', 'run statistical analysis', 'prepare journal submission', 'manuscript writing', 'research methodology design', 'hypothesis testing', 'academic writing', and other academic research paper tasks. Also supports analysis, rewriting, and submission preparation when existing data or drafts are available. However, actual data collection execution, official IRB submission, journal system login and upload, and running actual statistical software are outside the scope of this skill.

product-copy-formulas

495
from revfactory/harness-100

Product copy formula library. Referenced by the detail-page-writer and marketing-manager agents when writing purchase-driving copy. Use for 'product copy', 'marketing copy', or 'ad copy' requests. Ad placement and design mockup creation are out of scope.

ecommerce-launcher

495
from revfactory/harness-100

Full launch pipeline for e-commerce products where an agent team collaborates to generate product planning, detail pages, pricing strategy, marketing, and CS setup all at once. Use this skill for requests such as 'launch an e-commerce product', 'prepare a product launch', 'register a product on Naver Smart Store', 'launch on Coupang', 'create a detail page', 'develop a pricing strategy', 'create a marketing plan', 'launch prep', 'product planning brief', 'e-commerce CS manual', and other e-commerce product launch tasks. Also supports supplementing pricing/marketing/CS even when existing briefs or detail pages are provided. However, actual platform API integration (automated product registration), payment system development, logistics system integration, and real-time order management are outside the scope of this skill.

conversion-optimization

495
from revfactory/harness-100

Purchase conversion optimization framework. Referenced by the detail-page-writer and pricing-strategist agents when designing detail pages and pricing with a conversion focus. Use for 'conversion rate optimization', 'CRO', or 'purchase psychology' requests. A/B testing tool setup and funnel automation are out of scope.

real-estate-analyst

495
from revfactory/harness-100

Real estate investment analysis pipeline. An agent team collaborates to produce market research, location analysis, profitability analysis, risk assessment, and investment reports. Use this skill for requests such as 'analyze this real estate', 'apartment investment analysis', 'studio apartment yield', 'real estate market research', 'location analysis', 'real estate investment report', 'buy vs lease', 'reconstruction investment analysis', 'commercial property yield analysis', and other general real estate investment analysis tasks. Actual purchase contracts, brokerage services, interior design, and property management are outside the scope of this skill.

location-scoring

495
from revfactory/harness-100

Location scoring scorecard. Referenced by the location-analyst agent for systematic real estate location evaluation. Use for requests involving 'location analysis', 'location assessment', or 'commercial area analysis'. On-site inspections and surveying are out of scope.

cap-rate-calculator

495
from revfactory/harness-100

Real estate yield calculator. Reference formulas and models used by the profitability-analyst agent for quantitative investment return analysis. Use for requests involving 'Cap Rate', 'yield analysis', 'DCF', or 'cash flow analysis'. Tax advisory and loan underwriting are out of scope.

vendor-scoring

495
from revfactory/harness-100

Vendor evaluation scorecard framework. Referenced by vendor-comparator and evaluation-designer agents when systematically comparing and evaluating vendors. Used for 'vendor evaluation', 'supplier comparison', 'bid evaluation' requests. Note: posting bid announcements and executing contracts are out of scope.