Critical editorial analysis of articles. Examines structure, argument strength, relevance, and readability. Use for substantive editing - challenging what's said and how, not just polish.
This skill is for critical evaluation of $ARGUMENTS - not polish (review-steps) or generation (flesh-out).
Stop after each stage and have changes reviewed with user.
Note: Strong editing challenges the content itself. The agent identifies weaknesses; the developer decides what to change. Stages 0-4 are critique only — no edits are made to the document. Edits happen in Stage 5 after the critique is complete.
See
responsibilities.mdfor the full agent/developer ownership matrix.
Read and identify the core argument (developer confirms)
Evaluate structure (agent critiques, developer discusses)
Assess relevance and focus (agent critiques, developer discusses)
Challenge the argument (agent critiques, developer discusses)
Evaluate readability (agent critiques, developer discusses)
Strengthen weak sections (agent proposes edits, developer approves)
Final assessment (agent leads)
| Document State | Use |
|---|---|
| Raw notes, bullets, stream of consciousness | flesh-out |
| Draft with typos, incomplete sentences | review-steps |
| Complete draft needing critical evaluation | strong-edit |
| Polished draft, final check | review-steps |
| Finalized document needs agent-friendly restructuring | agent-optimize |
| Aspect | review-steps | flesh-out | strong-edit |
|---|---|---|---|
| Focus | Polish | Generate | Critique |
| Input | Draft with structure | Raw notes | Complete draft |
| Question | "Is this correct?" | "What should this say?" | "Does this work?" |
| Risk | Missing substance | Meaning distortion | Over-editing |
| Output | Cleaner version | Structured document | Critical assessment + revisions |
Good editing is subtractive. The best edits often involve removing what doesn't serve the piece rather than adding more. Every word should earn its place.
Challenge the author's assumptions. If something seems unclear, it may be unclear - or wrong. Don't fix; question.
Respect the author's voice. Strong editing improves the piece; it doesn't rewrite it into a different piece. Propose changes in the author's style, not generic "good writing."