document-review

Assess brainstorm documents for clarity, completeness, and YAGNI adherence.

5|1|Updated Aug 26, 2025
One-click install
npx skills add https://github.com/hollandkevint/thinkhaven --skill document-review-hollandkevint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: document-review
Source: https://github.com/hollandkevint/thinkhaven/tree/main/.gemini/skills/document-review
Command: npx skills add https://github.com/hollandkevint/thinkhaven --skill document-review-hollandkevint

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the challenge of unclear, incomplete, or scope-creeping documents by providing a structured review process to identify and rectify critical issues before proceeding.

Core Features & Use Cases

  • Clarity Assessment: Identifies vague language and unclear problem statements.
  • Completeness Check: Ensures all necessary sections, constraints, and open questions are addressed.
  • Scope Management: Prevents unnecessary expansion by evaluating against YAGNI principles.
  • Use Case: Before a major project kickoff, use this Skill to review the initial project brief, ensuring all stakeholders have a clear, shared understanding of the objectives and constraints.

Quick Start

Review the document located at /docs/project_brief.md for clarity and completeness.

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 project brief for clarity and scope creep before kickoff?

Document review refines project briefs by assessing clarity, completeness, and specificity. It identifies vague language and evaluates scope against YAGNI principles to prevent unnecessary expansion before workflow progression.

What is the best way to check if my brainstorm document is complete enough to proceed?

A completeness check ensures your brainstorm document addresses all necessary sections, constraints, and open questions. It identifies critical improvements and suggests auto-fixes for minor issues while seeking approval for substantive changes.

Can I automatically fix vague language in my planning documents?

Yes, document review identifies unclear problem statements and vague language, suggesting auto-fixes for minor issues. For substantive changes impacting document structure, it seeks your approval before applying any modifications.

How does YAGNI scope management work when refining a project plan?

YAGNI scope management prevents unnecessary expansion by evaluating your project plan against actual requirements. It ensures the document adheres strictly to necessary features, filtering out scope creep before workflow progression.

Do I need to manually approve all changes during a document review?

No, document review automatically fixes minor issues like vague phrasing without intervention. It only seeks your approval for substantive changes that significantly alter the document's structure or meaning.

When should I use a structured document critique before progressing my workflow?

Use structured document critique when planning documents require validation before workflow progression. It is essential for ensuring stakeholders share a clear understanding of objectives, constraints, and scope prior to major project kickoff.