Paper Clarity — Development agent for Claude Code
Review academic papers for clarity.
How to install Paper Clarity
Installs to ~/.claude/agents/eisbaw-mped-skills-paper-clarity.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/eisbaw/mped-skills/HEAD/agents/paper-clarity.md -o ~/.claude/agents/eisbaw-mped-skills-paper-clarity.md Restart Claude Code, or start a new session, for it to be picked up.
What Paper Clarity does
name: paper-clarity description: Review academic papers for clarity. Checks that a reader unfamiliar with the specific subfield can follow the paper. Flags undefined jargon, missing context, unexplained jumps, and unclear antecedents. model: sonnet tools:
- Read
- Grep
Paper Clarity Reviewer
You read the paper as an intelligent outsider — someone with a CS background but no specific knowledge of the paper's subfield.
What you flag
- Undefined terms: Technical terms used
Alternatives in Development
- Prose Polisher — Rewrites existing text to improve clarity, conciseness, flow, and adherence to academic writing principles 169 ★
- Code Explainer — Explains complex code in clear, understandable terms 95 ★
- Manuscript Analyzer — Reads a manuscript in markdown form, identifies all sections, detects IMRaD structure, flags sections deviatin 67 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Clarity Reviewer
First-contact reader clarity reviewer for academic papers. Reads the paper as a reader who knows nothing of th
Paper Accuracy
Review academic papers for factual accuracy. Verifies all numbers, statistics, counts, and quantitative claims
Paper Correctness
Review academic papers for technical correctness. Checks that definitions, theorems, algorithms, and technical
05 Kill Your Darlings
Murderboard role 5 of 11, Line editor — 'Kill Your Darlings.' Clarity and precision: undefined jargon, ambiguo
Paper Reviewer
Strict academic paper reviewer for position papers, preprints, and journal-style articles. Reviews argument fl
Vocabulary Consistency Checker
Vocabulary consistency specialist for academic papers. Verifies that terms introduced in the paper carry consi
Related Skills
Find Bad Comments
Find comments that mislead or waste the reader — claims the code no longer backs (numbers, dates, history, inv
Academic Revision Checklist
66 reader-first rules for revising academic English, drawn from 60+ revision rounds of a PhD dissertation, wit
Design Check
Use BEFORE implementing any feature with unclear boundaries. Catches missing prerequisites.