jupyter-notebook-writing — скилл для Claude Code
Скилл jupyter-notebook-writing для Claude Code редактирует Jupyter-ноутбуки через Markdown вместо JSON. Файл .md конвертируется в .ipynb через jupyter-switch.
лицензия не указана 3 900 установок обновлён 2026-08-28
npx skills add zc277584121/marketing-skills --skill jupyter-notebook-writing -a claude-codeЧто делает jupyter-notebook-writing
При работе с Jupyter-ноутбуками через AI возникает проблема: .ipynb — это сложный JSON с метаданными и историей выполнения, который неудобно редактировать. Скилл предлагает обратный подход: писать пример в чистом Markdown, где Python-блоки становятся ячейками кода, а остальное — ячейками разметки. После редактирования .md ты запускаешь uvx jupyter-switch example.md, и оригинальный Markdown остаётся источником истины.
Скилл включает шаг за шагом инструкции по запуску ноутбука: сначала обнаружить доступные среды Python (conda, mamba, venv, Jupyter kernels), потом предложить выбор пользователю, затем зарегистрировать среду как kernel если её там нет, и наконец запустить jupyter execute с правильным kernel_name. Перед запуском нужно закомментировать ячейки с pip install и ключами API — они должны быть установлены и заданы снаружи ноутбука, иначе тест сломается.
Шаблон структуры включает Prerequisites, Setup, подготовку данных, создание коллекции, запросы и очистку. Скилл нацелен на примеры приложений Milvus: RAG, семантический поиск, гибридный поиск.
Какие задачи решает
- редактировать ноутбук через JSON и метаданные
- синхронизировать Markdown-документацию с
.ipynb - выбрать правильное окружение Python для запуска ноутбука
- запустить ноутбук в CI без конфликтов с setup-ячейками
- быстро создать пример приложения Milvus
Примеры запросов агенту
- Создай Markdown-файл с примером RAG через Milvus и преобразуй его в ноутбук
- Отредактируй существующий
example.ipynb, преобразовав в Markdown, поправив текст, и обратно в ноутбук - Запусти ноутбук в нужном окружении, выбрав Jupyter kernel из списка
Как установить jupyter-notebook-writing
1Через Skills CLI (Vercel)
npx skills add zc277584121/marketing-skills --skill jupyter-notebook-writing -a claude-code2Вручную: положить файлы
~/.claude/skills/jupyter-notebook-writing/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/jupyter-notebook-writing/
1Через Skills CLI (Vercel)
npx skills add zc277584121/marketing-skills --skill jupyter-notebook-writing -a codex2Вручную: положить файлы
.agents/skills/jupyter-notebook-writing/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add zc277584121/marketing-skills --skill jupyter-notebook-writing -a cursor2Вручную: положить файлы
.cursor/skills/jupyter-notebook-writing/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install zc277584121/marketing-skills skills/jupyter-notebook-writing2Вручную: положить файлы
.github/skills/jupyter-notebook-writing/SKILL.md1Через Skills CLI (Vercel)
npx skills add zc277584121/marketing-skills --skill jupyter-notebook-writing -a gemini-cli2Командой платформы
gemini skills install https://github.com/zc277584121/marketing-skills --path skills/jupyter-notebook-writingВручную: положить файлы
.devin/skills/jupyter-notebook-writing/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add zc277584121/marketing-skills --skill jupyter-notebook-writing -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о jupyter-notebook-writing
Как установить jupyter-notebook-writing?
Выбери свою платформу. Для Claude Code: npx skills add zc277584121/marketing-skills --skill jupyter-notebook-writing -a claude-code, затем открой ~/.claude/skills/jupyter-notebook-writing/SKILL.md. Для GitHub Copilot: gh skill install zc277584121/marketing-skills jupyter-notebook-writing. Для других платформ используй npx skills add с флагом -a codex, -a cursor, -a gemini-cli или -a opencode.
Зачем нужен Markdown вместо редактирования .ipynb напрямую?
.ipynb файлы содержат JSON с метаданными, счётчиками выполнения и выводом ячеек — это неудобно для AI-редактирования. Markdown чистый и понятный: Python-блоки автоматически становятся ячейками кода, остальное — ячейками разметки. Исходный .md остаётся источником истины для будущих редактирований.
Какие требования нужны для работы скилла?
Python >= 3.10 и команда uvx (часть инструмента uv). Скилл использует jupyter-switch для конвертации между .md и .ipynb, а jupyter execute для запуска. Перед запуском ноутбука необходимо установить зависимости (pymilvus и другие пакеты) в выбранное окружение Python отдельно от самого ноутбука.