Экспертная оценка качества README

documentation

readme-critique is a Claude Code skill that performs a holistic, high-judgment review of a finished README across eight axes of pedagogy, structure, and design rationale — running after readme-draft and before readme-verify. It catches failure modes that verify's gates miss: documents that are internally consistent and complete-by-name but read as API catalogs rather than teaching material. The eight axes cover opening hook size, running-domain coherence, section naming (use-named vs API-named), section opener style (WHY/WHEN vs WHAT), cluster grouping, cross-API teaching paragraphs, woven design rationale, and overall gestalt. Each axis receives a PASS / WEAK / FAIL verdict with line-level evidence. The skill accepts a readme path, a source-analysis path, and an optional exemplar README for comparison.