jupyter-notebooks — скилл для Codex: что делает и как установить
Скилл создаёт, редактирует и проверяет воспроизводимые ноутбуки на SQL или Python. Он нужен для анализа, который можно повторно запустить и проверить.
npx skills add openai/plugins --skill jupyter-notebooks -a codexЧто делает jupyter-notebooks
Скилл помогает собирать Jupyter-ноутбуки как читаемые аналитические документы, а не как набор случайных ячеек. Он задаёт структуру для отчётов, экспериментов, диагностики, проверки качества данных и учебных материалов, разделяет загрузку данных, расчёты, визуализации и выводы.
При работе с существующим файлом скилл сохраняет его замысел и старается не менять JSON без необходимости. Для структуры и проверки предусмотрены JupyterLab, nbformat и nbclient; SQL можно держать в ячейках или отдельных файлах. Итоги нужно связывать с выполненными ячейками, а источники, параметры и допущения оставлять видимыми.
Ноутбук проверяется запуском всех ячеек по порядку через python -m jupyter nbconvert --execute --to notebook --inplace path/to/notebook.ipynb. Без среды, где доступны нужный kernel, зависимости и данные, такую проверку выполнить нельзя.
Какие задачи решает
- создать воспроизводимый Jupyter-ноутбук для анализа
- разделить SQL, Python, загрузку данных и визуализации
- проверить выполнение ячеек по порядку
- сохранить источники, параметры и допущения рядом с расчётами
- отредактировать существующий ноутбук без лишних изменений
Примеры запросов агенту
- Создай воспроизводимый ноутбук
analysis.ipynbдля SQL- и Python-анализа с понятными разделами и проверкой выполнения. - Проверь
analysis.ipynbсверху вниз, свяжи выводы с результатами ячеек и укажи шаги для повторной проверки. - Отредактируй
report.ipynb, сохрани его структуру и отдели подготовку данных от визуализаций.
Как установить jupyter-notebooks
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill jupyter-notebooks -a codex2Вручную: положить файлы
.agents/skills/jupyter-notebooks/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill jupyter-notebooks -a claude-code2Вручную: положить файлы
~/.claude/skills/jupyter-notebooks/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/jupyter-notebooks/
Вручную: положить файлы
.cursor/skills/jupyter-notebooks/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install openai/plugins jupyter-notebooks2Вручную: положить файлы
.github/skills/jupyter-notebooks/SKILL.mdКомандой платформы
gemini skills install https://github.com/openai/plugins --path plugins/data-analytics/skills/jupyter-notebooksВручную: положить файлы
.devin/skills/jupyter-notebooks/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Скиллы Codex: как установить, где лежат и как вызвать
Вопросы о jupyter-notebooks
Как установить jupyter-notebooks в Codex?
Выполните npx skills add openai/plugins --skill jupyter-notebooks -a codex, затем проверьте файл .agents/skills/jupyter-notebooks/SKILL.md.
Что делает скилл jupyter-notebooks?
Он создаёт, редактирует и валидирует Jupyter-ноутбуки на SQL или Python. Скилл помогает оформить анализ так, чтобы его можно было прочитать, повторно запустить и сопоставить с результатами ячеек.
Что нужно для проверки ноутбука?
Нужна среда с доступными данными, зависимостями и kernel. Проверка выполняется командой python -m jupyter nbconvert --execute --to notebook --inplace path/to/notebook.ipynb.
