document-refinement

Installation
SKILL.md

Document Refinement

Structured review to answer: "Is this document clear and ready for the next phase?"

Audience: Engineers reviewing brainstorm outputs, plans, or PRDs before handoff. Goal: Catch vagueness and gaps early. Auto-fix minor issues, flag substantive ones.

Assessment Criteria

Score each 1-5:

Criterion 1 (Fail) 3 (Acceptable) 5 (Excellent)
Clarity Vague language, undefined terms Mostly clear, few ambiguities Every statement is actionable and specific
Completeness Missing required sections Has all sections, some thin All sections substantive with no gaps
Specificity "Handle errors appropriately" Some concrete details Exact behaviors, values, and boundaries defined
YAGNI Speculative features, gold-plating Minor scope creep Every item traces to a stated requirement
User Intent Fidelity Drifted from original request Mostly aligned Precisely captures what user asked for
Related skills
Installs
32
GitHub Stars
39
First Seen
Feb 20, 2026