document-review

Review brainstorm or plan documents for clarity, completeness, specificity, and YAGNI adherence.

Updated Feb 16, 2026
One-click install
npx skills add https://github.com/praburajasekaran/ruthva-clinic-os --skill document-review-praburajasekaran
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: document-review
Source: https://github.com/praburajasekaran/ruthva-clinic-os/tree/main/.gemini/skills/document-review
Command: npx skills add https://github.com/praburajasekaran/ruthva-clinic-os --skill document-review-praburajasekaran

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps users refine brainstorm or plan documents, ensuring clarity, completeness, and specificity before proceeding to the next workflow step.

Core Features & Use Cases

  • Document Review: Structured review process to identify unclear points, unnecessary content, avoided decisions, unstated assumptions, and potential scope expansion.
  • Criteria Scoring: Scores the document against criteria like clarity, completeness, specificity, and adherence to YAGNI principles.
  • Critical Improvement Identification: Highlights the most critical issue for improvement.
  • Simplification Guidance: Offers guidance on simplifying content without losing necessary details.
  • Iteration Guidance: Provides iteration guidance for refining the document through multiple review passes.

Quick Start

Run the document-review skill on your brainstorm or plan document to start the review process.

Frequently Asked Questions about document-review

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

FAQPage Schema
How do I refine a brainstorm or plan document for clarity and completeness?

You can refine a brainstorm document by running a review process that identifies unclear points, unstated assumptions, and avoided decisions. This ensures your plan has the necessary specificity before moving to the next workflow step.

What is the YAGNI principle in document review and how does it prevent scope expansion?

The YAGNI principle in document review prevents scope expansion by identifying unnecessary content. Reviewing your plan against this criteria helps strip away non-essential features, offering guidance on simplifying content without losing necessary details.

Can I score my planning document against specific quality criteria?

Yes, you can score your planning document against criteria like clarity, completeness, specificity, and adherence to YAGNI principles. This criteria scoring highlights the most critical issue for improvement within your brainstorming notes.

How do I identify unstated assumptions and avoided decisions in a brainstorm document?

To identify unstated assumptions and avoided decisions in a brainstorm document, apply a structured document review. This process actively uncovers hidden gaps and highlights critical areas requiring immediate improvement.

Does this document refinement process provide iteration guidance for multiple review passes?

Yes, the document refinement process provides iteration guidance for refining your plan through multiple review passes. This ensures continuous improvement of clarity and completeness until the document meets your workflow requirements.