Back to Skills

docs-review

verified

Reviews documentation for voice, style, and structure alignment with Outfitter standards. Use when reviewing docs, checking content quality, or when "review this doc", "voice check", "style review", or "is this ready?" are mentioned.

View on GitHub

Marketplace

outfitter-internal

outfitter-dev/agents-internal

Plugin

outfitter-dev

Repository

outfitter-dev/agents-internal

outfitter-dev/skills/docs-review/SKILL.md

Last Verified

January 25, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/outfitter-dev/agents-internal/blob/main/outfitter-dev/skills/docs-review/SKILL.md -a claude-code --skill docs-review

Installation paths:

Claude
.claude/skills/docs-review/
Powered by add-skill CLI

Instructions

# Documentation Review

Review the current document against Outfitter standards for voice, style, and structure.

## Review Direction

$ARGUMENTS

If direction is provided above, focus on that specific aspect. Otherwise, perform a general review across all dimensions.

## Review Criteria

### Voice

Does it sound like Outfitter?

- Confident, opinionated stance
- Agents as first-class consumers
- Plain language over jargon

### Style

Is the craft right?

- Punch-and-flow rhythm (short + long sentences)
- Earned enthusiasm (backed by substance)
- Strong opening and closing

### Structure

Does it follow documentation patterns?

- Appropriate template usage
- Complete, runnable examples
- Correct heading hierarchy (h1 > h2 > h3)

## Output Format

Provide your review in this format:

**Status**: Ready | Needs Work

**Summary**: One sentence overall assessment.

**Issues** (if any):
- [Location] Issue description and suggested fix

**Strengths**:
- What works well

If the document is ready, say so briefly. If it needs work, be specific about locations and fixes.

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
1055 chars