document-review

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

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

Core Features & Use Cases

  • Structured Assessment: Evaluates documents against criteria like clarity, completeness, specificity, and YAGNI.
  • Issue Identification: Surfaces unclear points, unnecessary content, avoided decisions, unstated assumptions, and scope creep risks.
  • Targeted Improvement: Focuses on critical improvements and offers guidance on simplification.
  • Use Case: After a brainstorm session, use this Skill to review the generated document, ensuring it's clear and actionable before moving to the planning phase.

Quick Start

Use the document-review skill to assess the brainstorm document located at 'docs/brainstorms/new_feature_ideas.md'.

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 evaluates brainstorm or plan documents against clarity, completeness, specificity, and YAGNI principles to identify critical improvements and guide simplification before moving to the planning phase.

What is the best way to simplify an overly complex plan document?

To simplify a plan document, apply YAGNI principles to identify unnecessary content and over-engineering risks. Document review targets these areas to guide simplification while avoiding the addition of new requirements.

When do I need a structured document review before planning?

You need a structured document review after a brainstorm session and before moving to the planning phase. It ensures the generated document is clear, actionable, and free of avoided decisions before workflow progression.

How can I identify scope creep and unstated assumptions in my documents?

Identify scope creep and unstated assumptions by evaluating your document for issue identification. Document review surfaces these specific pitfalls along with unclear points and unnecessary content to ensure completeness and specificity.

Does document review work with markdown brainstorm files?

Yes, document review works with markdown brainstorm files. You can use it to assess documents like 'docs/brainstorms/new_feature_ideas.md' to ensure they are clear and actionable before proceeding to the next workflow phase.