document-review

Reviews documents for clarity, completeness, and alignment with stated goals.

Updated Feb 1, 2026

Search Tags:#planning #refinement #brainstorming #editing #clarity #document review

Ready to run

npx skills add https://github.com/isndotbiz/website --skill document-review-isndotbiz

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: document-review
Source: https://github.com/isndotbiz/website/tree/main/.claude/skills/document-review
Command: npx skills add https://github.com/isndotbiz/website --skill document-review-isndotbiz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the challenge of producing clear, concise, and effective documents by providing a structured review process to identify and rectify ambiguities, scope creep, and unstated assumptions.

Core Features & Use Cases

Structured Assessment: Analyzes documents against criteria like clarity, completeness, and specificity.
Issue Identification: Surfaces unclear points, unnecessary content, and unstated assumptions.
Prioritization: Highlights the most critical improvements needed.
Automated Minor Fixes: Corrects minor issues like vague language and formatting automatically.
Use Case: Before submitting a project plan, use this Skill to ensure all requirements are clearly stated, potential scope creep is identified, and the plan is specific enough for the next phase of development.

Quick Start

Review the brainstorm document located at 'docs/brainstorms/initial_ideas.md'.

Frequently Asked Questions about document-review

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

FAQPage Schema

How do I review a brainstorm document for clarity and scope creep?▼

Document review analyzes brainstorm and plan documents against criteria like clarity, completeness, and specificity to identify ambiguities, surface unstated assumptions, and flag potential scope expansion before workflow progression.

What is the best way to refine a project plan before development?▼

Refining a project plan requires a structured assessment to ensure all requirements are clearly stated, unnecessary content is removed via YAGNI principles, and the plan is specific enough for the next phase of development.

Can I automatically fix vague language in planning documents?▼

Yes, document review automatically corrects minor issues like vague language and formatting while prioritizing the most critical structural improvements needed to ensure user intent fidelity.

Does document review work with existing markdown brainstorm files?▼

Yes, document review processes existing brainstorm and planning documents by assessing their adherence to YAGNI principles, checking completeness, and flagging unstated assumptions to prepare them for downstream workflow progression.

When should I not use an automated document refinement process?▼

Avoid document review for unstructured content or drafts lacking defined workflow progression, as the process specifically targets structured assessments requiring clarity, specificity, and adherence to YAGNI principles.