AgentSkillsCN

docs-review

审核文档的语气、风格与结构，确保其与 Outfitter 标准保持一致。当您需要审阅文档、检查内容质量，或在收到“请审阅这份文档”、“检查语气”、“校对风格”或“这份文档准备好了吗？”等需求时，可使用此技能。

SKILL.md
--- frontmatter
name: docs-review
description: 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.
context: fork
agent: editor
metadata:
  version: "1.0.0"
  author: outfitter

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.