review-doc

Review documents and report issues in a markdown table.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/Vamdawn/ai-forge --skill review-doc-vamdawn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-doc
Source: https://github.com/Vamdawn/ai-forge/tree/main/skills/review-doc
Command: npx skills add https://github.com/Vamdawn/ai-forge --skill review-doc-vamdawn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Structured document review and quality improvement. Use when the user asks to review, proofread, check, audit, or improve a document (Markdown, text, or any prose file). Triggers include: 'review this doc', 'check this document', 'proofread', 'audit this spec', 'review and fix', or any request to find and fix issues in written documents. Supports reviewing against referenced standards (PRD, design docs, style guides).

Core Features & Use Cases

  • Thorough, line-by-line analysis of prose for grammar, clarity, and structure.
  • Reference-aware reviews that align with PRD, design docs, and style guides.
  • Use Case: Audit a spec document and produce actionable fixes with severity levels.

Quick Start

Review the target document for grammar, structure, and clarity, and provide a prioritized list of issues with suggested fixes.

Frequently Asked Questions about review-doc

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

FAQPage Schema
How do I proofread a markdown document and generate a prioritized list of issues?

To proofread a markdown document, the tool reads the entire file in one pass and returns a markdown table. This table categorizes issues by severity and line number, providing specific fixes to improve document quality.

Can I review a spec document against a referenced style guide or PRD?

Yes, you can review a spec document against a referenced style guide or PRD. The review process reads referenced documents mentioned in the target file to provide context, ensuring alignment with specified standards and design requirements.

What is the best way to audit a large document for grammar and structural clarity?

The best way to audit a large document is using a parallel review mode for files over 300 lines. This approach identifies grammar, clarity, and structural issues across the prose file and outputs a prioritized markdown table sorted by severity.

Does document review work for files under 300 lines?

Document review works for files under 300 lines using a single-agent review mode. This mode performs a thorough, line-by-line analysis of prose to detect grammar, clarity, and structure issues, returning a markdown table with suggested fixes.

How are document issues reported and sorted during an automated review?

Document issues are reported in a markdown table with columns for Severity, Line, Category, Issue, and Fix. The results are sorted by severity and line number, allowing you to quickly prioritize and apply the suggested corrections.