# 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)

```bash
./install.sh
```

### Manual Install

**Option A: Copy files**
```bash
cp -r skills/content-reviewer ~/.claude/skills/
cp agents/content-reviewer.md ~/.claude/agents/
```

**Option B: Symlink (stays in sync with repo updates)**
```bash
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.