revision-agent

Revise prose with a 3-column method from structure to mechanics.

1|Updated Nov 22, 2025
One-click install
npx skills add https://github.com/nathan-a-king/writing-infrastructure --skill revision-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: revision-agent
Source: https://github.com/nathan-a-king/writing-infrastructure/tree/main/revision-agent
Command: npx skills add https://github.com/nathan-a-king/writing-infrastructure --skill revision-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This specialized agent performs systematic prose revision using a 3-column method, enforces house-rulebook standards, and works top-down from structure to mechanics.

Core Features & Use Cases

  • Structural Revision (Macro): improve organization, focus, flow, and openings/closings
  • Style Revision (Meso): enhance voice, verbs, clarity, and rhythm
  • Mechanical Revision (Micro): refine word choice, grammar, punctuation, and formatting
  • House Rulebook Enforcement: markdown cleanliness, one idea per file, internal links, and frontmatter completeness
  • Pipeline-Aware Depth: adjust revision depth by pipeline stage

Quick Start

Revise a file by name, e.g., "Revise blog/post.md" to apply structure → style → mechanics.

Frequently Asked Questions about revision-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I revise poorly structured prose systematically?

Prose revision applies a 3-column method working top-down: structure first (organization, flow, focus), then style (voice, verbs, clarity), then mechanics (grammar, word choice, punctuation). This layered approach catches high-impact problems before spending time on details.

Can I use markdown revision for blogs, reports, and essays?

Yes. The revision agent handles markdown files across academic, professional, and creative writing—blogs, reports, essays, chapters, and briefs. It enforces house-rulebook standards including markdown cleanliness, one idea per file, internal links, and frontmatter completeness.

What does the 3-column revision method do?

The 3-column method structures revision output as a table comparing original text, structural/style/mechanical issues, and revised text. This side-by-side view shows exactly what changed and why, making revisions transparent and actionable.

How do I enforce house-rulebook standards in markdown files?

The revision agent validates and enforces house-rulebook standards: markdown formatting cleanliness, one core idea per file, properly formatted internal links, and complete frontmatter. Non-compliant files are flagged and corrected during revision.

Can I adjust revision depth by writing stage?

Yes. The agent is pipeline-aware and adjusts revision depth based on the pipeline stage, allowing lighter revision early in drafting and deeper structural work later as content matures.

What's the difference between structural, style, and mechanical revision?

Structural revision (macro level) improves organization and flow; style revision (meso level) enhances voice and clarity; mechanical revision (micro level) refines grammar and word choice. Top-down application ensures structure problems don't mask mechanics issues.