# paper-to-runnable

Скилл paper-to-runnable для Claude Code превращает исследовательскую статью в минимальную рабочую реализацию её основной идеи. Запускается по просьбе реализовать или воспроизвести статью, в том числе по ссылке arXiv или локальному PDF.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 541 у репозитория
- Автор: dotslashsimran
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/dotslashsimran/simcraft/tree/HEAD/skills/learning/paper-to-runnable/SKILL.md
- Обновлён: 2026-11-09
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/paper-to-runnable

## Что делает

Скилл выделяет основное утверждение статьи и механизм, который его поддерживает, затем собирает минимальную реализацию в одном файле. В папке результата появляются `notes.md`, код, проверки, игрушечное воспроизведение результата и визуализации с пояснением в `explainer.md`.

Проверки идут по ступеням: формы тензоров, градиенты при их ручной реализации, переобучение на небольшом батче и оценка необученной модели. Затем сравниваются основной запуск и абляция с отключённым механизмом. Для статей с arXiv используются скрипт загрузки и файлы с уравнениями; другие ссылки скрипт не загружает без разрешения пользователя.

Для окружения предусмотрен `setup.sh` с `numpy`, `matplotlib` и `pypdf`; по умолчанию реализация использует NumPy. PyTorch нужен только для случаев, где ручной backpropagation оказался бы длиннее самой идеи. Анимация требует `ffmpeg` из `$FFMPEG` или `PATH`. Пример Grokking в `examples/grokking/` нужно прочитать перед первой сборкой.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dotslashsimran/simcraft --skill paper-to-runnable -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dotslashsimran/simcraft --skill paper-to-runnable -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dotslashsimran/simcraft --skill paper-to-runnable -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dotslashsimran/simcraft skills/learning/paper-to-runnable
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dotslashsimran/simcraft --skill paper-to-runnable -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/dotslashsimran/simcraft --path skills/learning/paper-to-runnable
```

### Windsurf (Devin Desktop)

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

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/dotslashsimran/simcraft/tree/HEAD/skills/learning/paper-to-runnable/SKILL.md

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

## Примеры запросов агенту
- Реализуй основную идею статьи по ссылке arXiv и проверь её на игрушечном примере.
- Воспроизведи результат из этого локального PDF и сравни запуск с абляцией.
- Объясни, как работает статья: собери минимальную реализацию и визуализируй механизм.

## Похожие
- [paper-context-resolver](https://affpapa.org/nevibecode/skills/paper-context-resolver.md) — скилл · 503300 установок
- [nature-paper-to-patent](https://affpapa.org/nevibecode/skills/nature-paper-to-patent.md) — скилл · 14000 установок
- [nature-paper-card](https://affpapa.org/nevibecode/skills/nature-paper-card.md) — скилл · 12000 установок
- [academic-paper](https://affpapa.org/nevibecode/skills/academic-paper.md) — скилл · 11600 установок
- [academic-paper-reviewer](https://affpapa.org/nevibecode/skills/academic-paper-reviewer.md) — скилл · 10600 установок
- [latex-paper-en](https://affpapa.org/nevibecode/skills/latex-paper-en.md) — скилл · 6200 установок

Из того же набора: [dotslashsimran/simcraft](https://affpapa.org/nevibecode/by/dotslashsimran/simcraft.md) — 24 карточки

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

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