document-review

Refine brainstorm or plan documents for clarity and completeness.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/mattjefferson/open-compound-engineering --skill document-review-mattjefferson
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: document-review
Source: https://github.com/mattjefferson/open-compound-engineering/tree/main/skills/document-review
Command: npx skills add https://github.com/mattjefferson/open-compound-engineering --skill document-review-mattjefferson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill should be used to refine brainstorm or plan documents before proceeding to the next workflow step. It applies when a brainstorm or plan document exists and the user wants to improve it.

Core Features & Use Cases

  • Structured review: Assess clarity, completeness, specificity, and YAGNI to surface gaps.
  • Issue highlighting: Identify a must-address improvement and surface critical risks early.
  • Inline updates & iteration: Auto-fix minor issues or request approval for substantial changes; supports iterative refinement with controlled passes.
  • Usage scenarios: Applies during brainstorms and planning sessions to prepare docs for the next workflow stage.

Quick Start

Provide the document path or select the latest brainstorm/plan to begin the review.

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 document before moving to the next workflow step?

To refine a brainstorm document, you need a structured review that checks for clarity, completeness, and specificity while flagging YAGNI concerns, proposing inline improvements to maintain original intent and ensure readiness for the next workflow step.

What is the best way to review a plan document for completeness and specificity?

The best way to review a plan document for completeness and specificity is to apply a structured evaluation that surfaces gaps, highlights a must-address improvement, and identifies critical risks early while maintaining the original planning intent.

Can I auto-fix minor issues in my brainstorm document during the review?

Yes, you can auto-fix minor issues in your brainstorm document during the review process, while substantial changes are flagged to request approval, supporting iterative refinement with controlled passes to improve overall document readiness.

How does YAGNI evaluation work when reviewing planning documents?

YAGNI evaluation during planning document review flags concerns about unnecessary features or steps, ensuring the refined plan remains focused on essential actions and specific requirements without over-engineering the proposed workflow.

When do I need a structured document review for my brainstorming sessions?

You need a structured document review for brainstorming sessions when you have an existing plan or brainstorm document that requires improved clarity and readiness before proceeding to the next stage of your workflow.

Does document review work with existing plan documents or only new brainstorms?

Document review works with both existing plan documents and new brainstorms, applying whenever a document exists and the user wants to improve its clarity, completeness, and specificity to prepare it for the next workflow stage.