# proof-readability

Скилл proof-readability правит изложение уже проверенного математического доказательства: переставляет шаги, добавляет подводки, чинит ссылки. Сами утверждения остаются как были.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 240 у репозитория
- Автор: franklee16
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/franklee16/academic-research-skills/tree/HEAD/theory-skills/theorist-toolbox-master/skills/proof-readability/SKILL.md
- Обновлён: 2026-09-18
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/proof-readability

## Что делает

Скилл встаёт в конец цепочки. Доказательство уже написано и уже прошло проверку, а он делает по нему проход на изложение: переставить шаги, дописать подводку, поправить ссылки и опечатки. Математика при этом не меняется — усиливать, ослаблять или «упрощать» утверждения нельзя.

Работа идёт по шести слоям. Первые два смотрят на доказательство целиком: архитектура (теорема в основном тексте с наброском и абзацем интуиции, формальное доказательство в приложении, лемма с одной-двумя фразами о её роли, явный финал сборного доказательства) и навигация (первая строка называет метод, длинное доказательство разбито на именованные шаги, объявленное число случаев совпадает с телом). Остальные четыре слоя — локальная правка.

Настоящий пробел скилл не заделывает. Если при правке видно, что шаг не выводится из заявленных посылок, правка останавливается, а шаг возвращается к пруверу. В проекте co-math это встроено в конвейер: `project-coordinator` заводит поток `W{NNN}-readability-{slug}` после одобрения, `prover` ведёт его в режиме читаемости, `paper-reviewer` проверяет только сохранность содержания. Область — доказательства, перечисленные в `instructions.md`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill proof-readability -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/proof-readability/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/proof-readability/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill proof-readability -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/proof-readability/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill proof-readability -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/proof-readability/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install franklee16/academic-research-skills theory-skills/theorist-toolbox-master/skills/proof-readability
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/proof-readability/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill proof-readability -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/franklee16/academic-research-skills --path theory-skills/theorist-toolbox-master/skills/proof-readability
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/proof-readability/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/franklee16/academic-research-skills/tree/HEAD/theory-skills/theorist-toolbox-master/skills/proof-readability/SKILL.md

## Когда брать
- переписать доказательство леммы так, чтобы шаги не приходилось восстанавливать самому
- свести повторяющуюся выкладку в одну симметричную лемму
- дописать к длинному доказательству вступление с планом и именованные шаги
- сверить, что число случаев в анонсе совпадает с разбором в теле
- вынести формальное доказательство в приложение, оставив в тексте набросок и абзац интуиции

## Примеры запросов агенту
- Отполируй доказательство теоремы 2 — только изложение, математику не трогай.
- Сделай проход на читаемость по доказательствам из приложения C.
- Перепиши лемму 4 так, чтобы её можно было читать отдельно от окружающего текста.

## Похожие
- [proof-orchestrator](https://affpapa.org/nevibecode/skills/proof-orchestrator.md) — скилл · 260 установок
- [readability](https://affpapa.org/nevibecode/skills/readability.md) — скилл · 595 установок
- [readability-check](https://affpapa.org/nevibecode/skills/readability-check.md) — скилл · 127 установок
- [lean-formalize](https://affpapa.org/nevibecode/skills/lean-formalize.md) — скилл · 103 установки
- [Text Classifier — Topic Categories & Readability](https://affpapa.org/nevibecode/mcp/text-classifier-topic-categories-readability.md) — MCP-сервер · 4595 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
