jupyter — скилл для Claude Code: что делает и как установить
Скилл помогает читать, менять, выполнять и конвертировать блокноты .ipynb через стандартный модуль json и утилиту jupyter nbconvert.
MIT 140 установок ★ 185 обновлён 2026-10-25
npx skills add OpenHands/extensions --skill jupyter -a claude-codeЧто делает jupyter
Ноутбуки Jupyter хранятся как обычные файлы JSON. Скилл учит агента напрямую читать и переписывать структуру ячеек через Python без запуска графического интерфейса. Так можно быстро поправить исходный код в nb['cells'], убрать тяжёлые метаданные или сбросить поля outputs и execution_count перед коммитом в репозиторий.
Для запуска расчётов и смены формата скилл использует CLI-команду jupyter nbconvert. С её помощью агент выполняет тетрадку на месте флагом --inplace либо сохраняет результат в HTML, Markdown или скрипт .py. Для поиска фрагментов кода в больших блокнотах даны паттерны под grep и PowerShell Select-String.
Для запуска и экспорта тетрадок в системе должен быть установлен пакет jupyter nbconvert. Без него агент сможет лишь редактировать JSON-структуру файла встроенными средствами Python.
Какие задачи решает
- очистить выводы ячеек
outputsперед сохранением в Git - выполнить блокнот
.ipynbиз консоли с сохранением результата - экспортировать тетрадку Jupyter в Markdown, HTML или скрипт Python
- найти нужную строку кода в
.ipynbбез открытия браузера
Примеры запросов агенту
- Очисти outputs во всех ячейках notebook.ipynb перед коммитом
- Запусти notebook.ipynb на месте через jupyter nbconvert и сохрани изменения
- Конвертируй analysis.ipynb в обычный Python-скрипт
Как установить jupyter
1Через Skills CLI (Vercel)
npx skills add OpenHands/extensions --skill jupyter -a claude-code2Вручную: положить файлы
~/.claude/skills/jupyter/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/jupyter/
1Через Skills CLI (Vercel)
npx skills add OpenHands/extensions --skill jupyter -a codex2Вручную: положить файлы
.agents/skills/jupyter/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add OpenHands/extensions --skill jupyter -a cursor2Вручную: положить файлы
.cursor/skills/jupyter/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install OpenHands/extensions skills/jupyter2Вручную: положить файлы
.github/skills/jupyter/SKILL.md1Через Skills CLI (Vercel)
npx skills add OpenHands/extensions --skill jupyter -a gemini-cli2Командой платформы
gemini skills install https://github.com/OpenHands/extensions --path skills/jupyterВручную: положить файлы
.devin/skills/jupyter/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add OpenHands/extensions --skill jupyter -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о jupyter
Как установить jupyter в Claude Code?
Выполните команду npx skills add OpenHands/extensions --skill jupyter -a claude-code. Файл инструкции запишется в ~/.claude/skills/jupyter/SKILL.md.
Что делает скилл jupyter?
Он даёт агенту инструкции по программной работе с файлами .ipynb. Агент правит ячейки напрямую через Python json и вызывает jupyter nbconvert для запуска и экспорта.
Какие инструменты нужны для работы скилла?
Для редактирования и очистки ячеек достаточно стандартной библиотеки json в Python. Для запуска расчётов или конвертации блокнота в HTML, Markdown и .py потребуется утилита jupyter nbconvert.
Исходный текст
SKILL.md · MIT
---
name: jupyter
description: Read, modify, execute, and convert Jupyter notebooks programmatically. Use when working with .ipynb files for data science workflows, including editing cells, clearing outputs, or converting to other formats.
triggers:
- ipynb
- jupyter
---
# Jupyter Notebook Guide
Notebooks are JSON files. Cells are in `nb['cells']`, each has `source` (list of strings) and `cell_type` ('code', 'markdown', or 'raw').
## Modifying Notebooks
```python
import json
with open('notebook.ipynb') as f:
nb = json.load(f)
# Modify nb['cells'][i]['source'], then:
with open('notebook.ipynb', 'w') as f:
json.dump(nb, f, indent=1)
```
## Executing & Converting
```bash
jupyter nbconvert --to notebook --execute --inplace notebook.ipynb # Execute in place
jupyter nbconvert --to html notebook.ipynb # Convert to HTML
jupyter nbconvert --to script notebook.ipynb # Convert to Python
jupyter nbconvert --to markdown notebook.ipynb # Convert to Markdown
```
## Finding Code
```bash
grep -n "search_term" notebook.ipynb
```
PowerShell equivalent:
```powershell
Select-String -Path notebook.ipynb -Pattern "search_term"
```
## Cell Structure
```python
# Code cell
{"cell_type": "code", "execution_count": None, "metadata": {}, "outputs": [], "source": ["code\n"]}
# Markdown cell
{"cell_type": "markdown", "metadata": {}, "source": ["# Title\n"]}
```
## Clear Outputs
```python
for cell in nb['cells']:
if cell['cell_type'] == 'code':
cell['outputs'] = []
cell['execution_count'] = None
```
© OpenHands · MIT · OpenHands/extensions