proof-readability — скилл для Claude Code: читаемость доказательств
Скилл proof-readability правит изложение уже проверенного математического доказательства: переставляет шаги, добавляет подводки, чинит ссылки. Сами утверждения остаются как были.
лицензия не указана ★ 240 обновлён 2026-09-18
npx skills add franklee16/academic-research-skills --skill proof-readability -a claude-codeЧто делает proof-readability
Скилл встаёт в конец цепочки. Доказательство уже написано и уже прошло проверку, а он делает по нему проход на изложение: переставить шаги, дописать подводку, поправить ссылки и опечатки. Математика при этом не меняется — усиливать, ослаблять или «упрощать» утверждения нельзя.
Работа идёт по шести слоям. Первые два смотрят на доказательство целиком: архитектура (теорема в основном тексте с наброском и абзацем интуиции, формальное доказательство в приложении, лемма с одной-двумя фразами о её роли, явный финал сборного доказательства) и навигация (первая строка называет метод, длинное доказательство разбито на именованные шаги, объявленное число случаев совпадает с телом). Остальные четыре слоя — локальная правка.
Настоящий пробел скилл не заделывает. Если при правке видно, что шаг не выводится из заявленных посылок, правка останавливается, а шаг возвращается к пруверу. В проекте co-math это встроено в конвейер: project-coordinator заводит поток W{NNN}-readability-{slug} после одобрения, prover ведёт его в режиме читаемости, paper-reviewer проверяет только сохранность содержания. Область — доказательства, перечисленные в instructions.md.
Какие задачи решает
- переписать доказательство леммы так, чтобы шаги не приходилось восстанавливать самому
- свести повторяющуюся выкладку в одну симметричную лемму
- дописать к длинному доказательству вступление с планом и именованные шаги
- сверить, что число случаев в анонсе совпадает с разбором в теле
- вынести формальное доказательство в приложение, оставив в тексте набросок и абзац интуиции
Примеры запросов агенту
- Отполируй доказательство теоремы 2 — только изложение, математику не трогай.
- Сделай проход на читаемость по доказательствам из приложения C.
- Перепиши лемму 4 так, чтобы её можно было читать отдельно от окружающего текста.
Как установить proof-readability
1Через Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill proof-readability -a claude-code2Вручную: положить файлы
~/.claude/skills/proof-readability/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/proof-readability/
1Через Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill proof-readability -a codex2Вручную: положить файлы
.agents/skills/proof-readability/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill proof-readability -a cursor2Вручную: положить файлы
.cursor/skills/proof-readability/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install franklee16/academic-research-skills theory-skills/theorist-toolbox-master/skills/proof-readability2Вручную: положить файлы
.github/skills/proof-readability/SKILL.md1Через Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill proof-readability -a gemini-cli2Командой платформы
gemini skills install https://github.com/franklee16/academic-research-skills --path theory-skills/theorist-toolbox-master/skills/proof-readabilityВручную: положить файлы
.devin/skills/proof-readability/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о proof-readability
Как установить proof-readability в Claude Code?
Выполните npx skills add franklee16/academic-research-skills --skill proof-readability -a claude-code. Скилл окажется по пути ~/.claude/skills/proof-readability/SKILL.md.
Что делает proof-readability?
Правит изложение проверенного доказательства: порядок шагов, подводки, ссылки, обозначения. Утверждения и аргументы остаются прежними.
Что будет, если при вычитке найдётся ошибка?
Правка этого доказательства останавливается, подозрительный шаг описывается и уходит обратно к пруверу. Тихо заделывать пробел скилл не станет, иначе проверка, которая уже прошла, теряет смысл.