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

documentation

readme-critique — это скилл для Claude Code, который выполняет целостную экспертную оценку готового README по восьми осям педагогики, структуры и дизайна — между этапами черновика и финальной проверки. Скилл выявляет проблемы, которые пропускают gate-проверки readme-verify: документ выглядит полным и самосогласованным, но читается как каталог API, а не как обучающий материал. Восемь осей охватывают размер вступительного хука, использование сквозного домена, именование разделов (use-named vs API-named), стиль открывающих предложений, кластеризацию API, наличие сравнительных параграфов «когда что использовать», вплетённое обоснование дизайна и финальный синтез. Для каждой оси скилл выдаёт вердикт PASS / WEAK / FAIL с указанием строк-доказательств. Принимает путь к README, к выводу анализатора и опционально — эталонный README для сравнения.