doc-reviewer

Classify Markdown docs under docs/ and generate structured critiques with improvement recommendations.

1|Updated Jan 18, 2026
One-click install
npx skills add https://github.com/kasiopeiya/oidc-learning-sandbox --skill doc-reviewer-kasiopeiya
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-reviewer
Source: https://github.com/kasiopeiya/oidc-learning-sandbox/tree/main/.claude/skills/doc-reviewer
Command: npx skills add https://github.com/kasiopeiya/oidc-learning-sandbox --skill doc-reviewer-kasiopeiya

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill reviews documentation files to improve quality, clarity, and completeness, and provides actionable feedback to elevate documentation standards.

Core Features & Use Cases

  • Auto-detect and review Markdown files under docs/ to assess quality.
  • Classify documents into categories such as PRD, DESIGN, ARCHITECTURE, PLAN, ISSUE_SPEC, PROPOSAL, GUIDELINE, and GENERAL, and tailor reviews accordingly.
  • Generate a comprehensive, structured critique with concrete improvement recommendations and maintainability guidance.

Quick Start

Run the /doc-reviewer command to start the doc-reviewer-agent and generate a detailed review report.

Frequently Asked Questions about doc-reviewer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically review documentation quality in Markdown files?

To review documentation quality automatically, run the /doc-reviewer command to detect Markdown files under docs/ and generate a structured critique on completeness, clarity, consistency, and maintainability.

What is the best way to evaluate architecture and PRD documents for completeness?

To evaluate architecture and PRD documents for completeness, use automated documentation review to classify files into categories like ARCHITECTURE and PRD, applying targeted review criteria to generate actionable improvement recommendations.

Can I use a documentation review tool to check consistency across design proposals?

Yes, you can check consistency across design proposals by classifying Markdown files into categories like DESIGN and PROPOSAL, which generates tailored review criteria to assess document clarity and maintainability.

How does automated document classification work for technical guidelines and plans?

Automated document classification for technical guidelines and plans works by scanning Markdown files and categorizing them as GUIDELINE, PLAN, or other types, then generating targeted review criteria for each specific document type.

Does the documentation review process require specific external dependencies?

No, the documentation review process does not require specific external dependencies, allowing you to directly assess Markdown files and generate structured critiques without prior environment setup.

Why should I use automated criteria instead of manual review for issue specs?

Automated criteria for issue specs ensure objective assessment of clarity and structure, generating consistent improvement recommendations across all ISSUE_SPEC documents without the variability of manual review.