Content Reviewer for Claude Code

A skill and sub-agent for reviewing written content (blog posts, marketing copy, documentation) to detect AI-generated patterns and improve prose for natural human voice.

What's Included

Type	File	Purpose
Skill	skills/content-reviewer/SKILL.md	Interactive review - use in conversation, approve each change
Sub-agent	agents/content-reviewer.md	Autonomous review - returns comprehensive report

Installation

Quick Install (recommended)

./install.sh

Manual Install

Option A: Copy files

cp -r skills/content-reviewer ~/.claude/skills/
cp agents/content-reviewer.md ~/.claude/agents/

Option B: Symlink (stays in sync with repo updates)

ln -s "$(pwd)/skills/content-reviewer" ~/.claude/skills/content-reviewer
ln -s "$(pwd)/agents/content-reviewer.md" ~/.claude/agents/content-reviewer.md

Usage

Skill (interactive)

Invoke in Claude Code:

/content-reviewer

Then provide or reference the content to review. Claude will go through the content with you, suggesting changes for your approval.

Best for: Iterative editing sessions where you want to approve/reject each suggestion.

Sub-agent (autonomous)

Ask Claude to use the agent:

Use the content-reviewer agent to review this blog post

Or reference a file:

Use the content-reviewer agent to review ~/Documents/draft.md

Best for: Getting a full report upfront, reviewing multiple documents, or running in background.

What It Detects

AI Patterns

• "Picture this:" openers
• Rhetorical question chains ("What if you could X? Y?")
• Contrast structures ("The real unlock isn't X. It's Y")
• "Think of it as..." filler
• Parallel structures ("What X does for Y, Z does for W")
• Buzzy terms (flywheel, hub, unlock as noun)

Style Issues

• Redundancy across sections
• Inconsistent formatting
• Salesy tone
• Vague language
• Jargon without explanation

Structure

• Section length vs value
• Example quality
• Flow and transitions
• TODOs and placeholders

Example Output

# Content Review Report

## Summary
- **AI patterns found:** 4
- **Style issues:** 2
- **Structure issues:** 1
- **Overall verdict:** Minor tweaks needed

## Pass 1: AI Patterns Detected

| Line | Current Text | Issue | Suggested Fix |
|------|--------------|-------|---------------|
| 36 | "Picture this: a user..." | AI opener | "A user..." |
| 44 | "What if you could X?" | Rhetorical question | "You could X" |
...

Contributing

To add new patterns or improve detection:

1. Edit skills/content-reviewer/SKILL.md for the interactive version
2. Edit agents/content-reviewer.md for the autonomous version
3. Keep both in sync for consistent behavior

License

MIT - use freely, modify as needed.