andrehuang/academic-writing-agents

README preview

# Academic Writing Agents

A [Claude Code plugin](https://docs.anthropic.com/en/docs/claude-code/plugins) that brings multi-agent review to academic writing — the same "multiple expert reviewers" model that makes peer review work, built into your writing process.

## Why

The gap between doing great research and writing about it clearly costs real impact. Findings get buried in unclear prose, reviewers stumble over notation inconsistencies, and figures fail to carry their weight. Most researchers get feedback from one or two people, often late in the process.

This plugin gives you a team of 12 specialist agents — each focused on a different dimension of writing quality — working in parallel, available at any point in the writing process.

## Design Philosophy

Informed by Michael Black's "Writing a Good Scientific Paper" and real thesis/paper writing experience:

- **Parallel expert review.** Multiple specialized agents review simultaneously, each catching what others miss — like having a writing coach, a technical reviewer, a figure specialist, and a bibliography checker all reading at once.
- **Review-then-act.** Always diagnose before fixing. The writing-reviewer identifies issues; the prose-polisher implements fixes. Never blindly edit.
- **30 codified principles.** Not ad-hoc corrections but a systematic framework organized into 6 categories: Structure & Narrative, Prose & Style, Math & Equations, Figures & Tables, Citations & Bibliography, and Process & Meta.
- **Human-in-the-loop.** Agents propose; humans decide. The plugin presents a prioritized plan and the author chooses what to act on.
- **Goal-Problem-Solution rhythm.** From Black's guide — every section should follow the GPS pattern. The plugin itself is structured this way: identify what you want to improve (goal), diagnose what's wrong (problem), deploy the right agents to fix it (solution).

View full repository on GitHub →