document-review

Structure and improve brainstorm or planning documents through guided review.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/datorresb/discovery-event-platform --skill document-review-datorresb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: document-review
Source: https://github.com/datorresb/discovery-event-platform/tree/main/.github/skills/document-review
Command: npx skills add https://github.com/datorresb/discovery-event-platform --skill document-review-datorresb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Improve brainstorm or plan documents through structured review.

Core Features & Use Cases

  • Stepwise guided review process: Get the document, assess, evaluate, identify improvements, and update inline.
  • Criteria-driven evaluation: Clarity, completeness, specificity, and YAGNI checks.
  • Iterative refinement: Offers next action prompts and supports multiple iterations.
  • Use Case: Teams drafting brainstorms or plans can refine documents to reduce ambiguity and ensure alignment before proceeding.

Quick Start

Provide a refined version of the given brainstorm or plan document.

Frequently Asked Questions about document-review

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

FAQPage Schema
How do I structure a document review for brainstorm or planning drafts?

Structure a document review by applying a stepwise guided process: retrieve the document, assess it, evaluate against defined criteria, identify improvements, and provide inline updates. This structured review surfaces gaps, ambiguities, and missing assumptions in brainstorm or planning drafts.

What is the best way to refine a planning document and reduce ambiguity?

The best way to refine a planning document is through criteria-driven evaluation, checking for clarity, completeness, specificity, and YAGNI constraints. This process identifies ambiguities and provides inline change guidance to ensure team alignment before proceeding.

Can I use a structured review process to find missing assumptions in evolving drafts?

Yes, you can use a structured review process across evolving drafts, from initial brainstorms to formal plans. It specifically surfaces gaps, ambiguities, and missing assumptions by applying consistent evaluation criteria throughout the iterative refinement process.

How do I evaluate a brainstorm document for completeness and specificity?

Evaluate a brainstorm document by applying criteria-driven checks for completeness and specificity. The guided review process assesses the document against these defined standards, identifying areas that lack detail or are missing necessary components.

What are the limitations of using a guided review process for collaborative planning?

A limitation of this guided review process is that it requires a defined workflow and specific evaluation criteria upfront. Without these prerequisites, the review cannot effectively generate inline change guidance or actionable next-step prompts for the team.

Does iterative document refinement work for aligning teams before project execution?

Yes, iterative document refinement works for team alignment by offering next action prompts and supporting multiple review iterations. This reduces ambiguity and ensures all collaborators are aligned on the finalized plan before execution.