One-click install
npx skills add https://github.com/sylvanding/omelette --skill document-review-sylvanding
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: document-review
Source: https://github.com/sylvanding/omelette/tree/main/.claude/skills/document-review
Command: npx skills add https://github.com/sylvanding/omelette --skill document-review-sylvanding

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Vague, incomplete, or misaligned brainstorm and plan documents cause workflow delays, team misalignment, and costly rework later in the project lifecycle. This skill eliminates those risks by providing a structured, repeatable review process to catch gaps and weaknesses before moving to the next workflow step.

Core Features & Use Cases

  • Structured Gap Identification: Surfaces unclear sections, unstated assumptions, unaddressed decisions, and accidental scope expansion risks in your documents.
  • Scored Quality Evaluation: Rates documents against clarity, completeness, specificity, and YAGNI principles to quantify improvement areas.
  • Workflow Alignment Validation: Confirms documents match prior discussion intent when used after brainstorm or plan workflow steps.
  • Use Case: For example, after drafting a feature implementation plan, use this skill to catch missing technical constraints and vague acceptance criteria before the development team begins work.

Quick Start

Use the document-review skill to review the most recent plan document stored in the docs/plans/ folder.

Frequently Asked Questions about document-review

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

FAQPage Schema
How do I validate a plan document for missing technical constraints and vague acceptance criteria?

Plan document validation catches missing technical constraints and vague acceptance criteria through structured gap identification, assessing clarity, completeness, and specificity to quantify improvement areas before workflow execution.

What is the best way to review brainstorm documents for unstated assumptions and scope risks?

Reviewing brainstorm documents for unstated assumptions and scope risks requires surfacing unclear sections and accidental scope expansion, scoring quality against YAGNI principles to provide targeted improvement recommendations.

Does document review require a full overhaul to resolve workflow alignment issues?

Document review does not require a full overhaul to resolve workflow alignment issues, applying targeted improvement recommendations and structured gap identification to validate readiness for subsequent implementation steps.

Can I use this to check if a feature implementation plan matches prior discussion intent?

You can use this to check if a feature implementation plan matches prior discussion intent through workflow alignment validation, confirming draft ideation documents align with previous decisions before development begins.

How do I score brainstorm and plan docs against clarity, completeness, and YAGNI principles?

Scoring brainstorm and plan docs against clarity, completeness, and YAGNI principles involves a structured evaluation that rates documents to quantify improvement areas and identify scope risks without requiring full rewrites.