# jupyter-notebooks

Скилл создаёт, редактирует и проверяет воспроизводимые ноутбуки на SQL или Python. Он нужен для анализа, который можно повторно запустить и проверить.

- скилл · `type=skill` · Codex, ChatGPT · ★ 7604
- Автор: Data Analytics Maintainers · официальный репозиторий OpenAI
- Лицензия: LicenseRef-Proprietary · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/openai/plugins/tree/HEAD/plugins/data-analytics/skills/jupyter-notebooks/SKILL.md
- Обновлён: 2026-10-08
- HTML: https://affpapa.org/nevibecode/skills/jupyter-notebooks

## Что делает

Скилл помогает собирать Jupyter-ноутбуки как читаемые аналитические документы, а не как набор случайных ячеек. Он задаёт структуру для отчётов, экспериментов, диагностики, проверки качества данных и учебных материалов, разделяет загрузку данных, расчёты, визуализации и выводы.

При работе с существующим файлом скилл сохраняет его замысел и старается не менять JSON без необходимости. Для структуры и проверки предусмотрены JupyterLab, `nbformat` и `nbclient`; SQL можно держать в ячейках или отдельных файлах. Итоги нужно связывать с выполненными ячейками, а источники, параметры и допущения оставлять видимыми.

Ноутбук проверяется запуском всех ячеек по порядку через `python -m jupyter nbconvert --execute --to notebook --inplace path/to/notebook.ipynb`. Без среды, где доступны нужный kernel, зависимости и данные, такую проверку выполнить нельзя.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill jupyter-notebooks -a codex
```

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

### Claude Code

1. **Через Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill jupyter-notebooks -a claude-code
```

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

### Cursor

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install openai/plugins jupyter-notebooks
```

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

### Gemini CLI

**Командой платформы**
```bash
gemini skills install https://github.com/openai/plugins --path plugins/data-analytics/skills/jupyter-notebooks
```

### Windsurf (Devin Desktop)

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

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/openai/plugins/tree/HEAD/plugins/data-analytics/skills/jupyter-notebooks/SKILL.md

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

## Примеры запросов агенту
- Создай воспроизводимый ноутбук `analysis.ipynb` для SQL- и Python-анализа с понятными разделами и проверкой выполнения.
- Проверь `analysis.ipynb` сверху вниз, свяжи выводы с результатами ячеек и укажи шаги для повторной проверки.
- Отредактируй `report.ipynb`, сохрани его структуру и отдели подготовку данных от визуализаций.

## Похожие
- [jupyter-notebook](https://affpapa.org/nevibecode/skills/jupyter-notebook.md) — скилл · 5600 установок
- [jupyter-to-marimo](https://affpapa.org/nevibecode/skills/jupyter-to-marimo.md) — скилл · 3400 установок
- [data-analysis-jupyter](https://affpapa.org/nevibecode/skills/data-analysis-jupyter.md) — скилл · 1500 установок
- [jupyter-mcp-server](https://affpapa.org/nevibecode/mcp/jupyter-mcp-server.md) — MCP-сервер · ★ 9
- [dt-app-notebooks](https://affpapa.org/nevibecode/skills/dt-app-notebooks.md) — скилл · 2700 установок
- [data-jupyter-python](https://affpapa.org/nevibecode/skills/data-jupyter-python.md) — скилл · 865 установок

Из того же набора: [openai/plugins](https://affpapa.org/nevibecode/by/openai/plugins.md) — 528 карточек

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