document-review

Assess brainstorm and plan documents for clarity, completeness, and specificity.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the need to improve the quality and clarity of brainstorm or plan documents before proceeding to the next stage of a workflow, ensuring that documents are clear, concise, and actionable.

Core Features & Use Cases

  • Structured Assessment: Evaluates documents against criteria like clarity, completeness, specificity, and adherence to YAGNI principles.
  • Issue Identification: Surfaces unclear points, unnecessary content, unstated assumptions, and potential scope creep.
  • Prioritization: Identifies the single most critical improvement needed for a document.
  • Automated & Manual Edits: Handles minor fixes automatically and seeks approval for substantive changes.
  • Use Case: After a team brainstorms a new feature, this Skill can review the brainstorm document to ensure the problem statement is clear and all necessary constraints are identified before a plan is drafted.

Quick Start

Review the document located at 'docs/brainstorms/new_feature_ideas.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 brainstorm document for clarity and completeness?

Document review involves assessing brainstorm and plan documents for clarity, specificity, and completeness. It identifies unclear points, unstated assumptions, and unnecessary content to ensure documents are concise and actionable before workflow progression.

What is the best way to identify scope creep in a planning document?

The best way to identify scope creep is reviewing the document against YAGNI principles. This surfaces unnecessary content and unstated assumptions, prioritizing the single most critical improvement needed to maintain a concise, actionable plan.

How does automated document editing work for brainstorm plans?

Automated document editing handles minor fixes directly, while seeking user approval for substantive changes. It prioritizes critical improvements and applies actionable next steps for iteration or completion to enhance overall document quality.

Can I use this document review process for feature planning workflows?

Yes, you can use this document review process for feature planning workflows. It evaluates brainstorm documents to ensure problem statements are clear and all necessary constraints are identified before a formal plan is drafted.

When do I need document refinement for brainstorm and plan documents?

You need document refinement when preparing brainstorm and plan documents for the next workflow stage. It ensures documents are clear, concise, and actionable by identifying critical improvements and applying edits before progression.