ai-prose-review
A Claude Code skill that reviews markdown prose against a checklist of 21 writing rules — 12 from style authorities (Strunk & White, Orwell, Pinker, Gopen & Swan) and 9 from observed AI-tell patterns.
This is my simpler personal version of yzhao062/agent-style by Yue Zhao, distilled into a single self-contained SKILL.md. The original repo is the canonical source — go there for the research, the full ruleset, and the dual-mode (generation-time and post-draft) implementation. This repo is just the post-draft review skill, kept lean enough that I can run it on demand from any project.
Install
Three install paths, recommended order:
1. Claude Code plugin
/plugin marketplace add petems/ai-prose-review-skill
/plugin install petems-prose@ai-prose-review
Invoke as /petems-prose:ai-prose-review.
2. vercel-labs/skills CLI
npx skills add petems/ai-prose-review-skill
Invoke as /ai-prose-review.
3. Manual symlink
For hacking on the skill locally:
ln -s "$(pwd)/skills/ai-prose-review" ~/.claude/skills/ai-prose-review
Invoke as /ai-prose-review.
Usage
The slash command depends on how you installed the skill:
- Plugin install →
/petems-prose:ai-prose-review
npx skills or manual symlink → /ai-prose-review
Examples below use the bare form; if you installed as a plugin, prefix each command with petems-prose:.
/ai-prose-review # review all *.md / *.mdx in cwd
/ai-prose-review path/to/file.md # review one file
/ai-prose-review 'docs/**/*.md' # review a glob
The skill reports violations grouped by file and severity, then asks before editing anything.
Credit
petems
