skills.rest
iliaal
iliaalCOMMUNITY
Explore all skills by this author →
Website𝕏@iliaaGitHub

document-review

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

Updated May 2, 2026
Search Tags:#planning#refinement#brainstorming#clarity#completeness#document review
One-click install
npx skills add https://github.com/iliaal/compound-engineering-plugin --skill document-review-iliaal
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: document-review
Source: https://github.com/iliaal/compound-engineering-plugin/tree/main/plugins/compound-engineering/skills/document-review
Command: npx skills add https://github.com/iliaal/compound-engineering-plugin --skill document-review-iliaal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the challenge of ensuring pre-implementation documents like brainstorms and plans are clear, complete, and free of unnecessary complexity before proceeding.

Core Features & Use Cases

  • Structured Assessment: Evaluates documents against criteria for clarity, completeness, specificity, and adherence to YAGNI principles.
  • Gap Identification: Surfaces unclear points, unstated assumptions, and potential scope creep.
  • Targeted Improvement: Identifies and prioritizes critical improvements for maximum impact.
  • Use Case: After a /workflows:brainstorm session, use this skill to review the generated document, ensuring the problem statement is precise and all constraints are clearly defined before moving to the planning phase.

Quick Start

Review the document located at 'docs/brainstorms/new-feature-idea.md'.

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 for clarity and completeness?▼

Document review evaluates pre-implementation plans and brainstorms by assessing structure, identifying gaps, and ensuring clarity and completeness. It surfaces unclear points and unstated assumptions to prevent scope creep before moving to the planning phase.

What is the best way to identify gaps in a pre-implementation plan?▼

Document review identifies gaps in pre-implementation plans by evaluating them against specificity and YAGNI criteria. It surfaces unstated assumptions and potential scope creep, prioritizing critical improvements for maximum impact before development begins.

Does document review work for preventing scope creep in feature planning?▼

Yes, document review prevents scope creep by applying YAGNI principles and simplification guidance during pre-implementation documentation review. It ensures the problem statement is precise and all constraints are clearly defined before planning.

How do I check if my planning document adheres to YAGNI principles?▼

Check planning documents for YAGNI adherence by applying simplification guidance during document review. This identifies unnecessary complexity and ensures the plan remains focused, surfacing scope creep and prioritizing critical improvements for maximum impact.

When do I need to review a brainstorm document before planning?▼

Review brainstorm documents before planning when transitioning from ideation to implementation. Document review ensures the problem statement is precise, constraints are clearly defined, and the document achieves maximum clarity and completeness prior to planning.

Related Skills

Explore More Product & Management Skills→
sylvandingsylvanding
9

document-review

Review brainstorm and plan documents for clarity gaps and scope risks.

Community
Intermediate
buchananwillbuchananwill
2

action-boundary

Enforce strict role boundaries for autonomous agents in multi-agent planning and review tasks.

Community
Intermediate
andrewhwallerandrewhwaller

document-review

Review brainstorm and plan documents for clarity, completeness, and YAGNI.

Community
Intermediate
rjroyrjroy
6

poke-holes

Challenge user ideas with adversarial questioning to surface hidden assumptions.

Community
Basic