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.
Scanned 5/29/2026
Install via CLI
openskills install sideprojectmate/sideProjectMate---
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
| 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?
No comments yet. Be the first to comment!