visual-notes — скилл для Claude Code: монтаж портретных видео
Скилл для Claude Code меняет крупность изображения над вырезанным спикером в портретном видео. По команде /visual-notes он собирает монтаж с переходом от полного кадра к детали.
MIT ★ 94 обновлён 2026-10-30
/plugin marketplace add artemnovitckii/claude-editing-skills
/plugin install editing-skills@claude-editing-skillsЧто делает visual-notes
Скилл собирает портретный ролик, в котором изображение над вырезанным спикером сначала показано целиком, а затем приближается к выбранной детали. В комплекте есть шаблон на 4.2 секунды с разрешением 1080x1920 и частотой 30fps. Тему задаёт пользователь, она не зависит от слов спикера.
Сборка запускается через build.py с путём к файлу спецификации. Без спецификации скрипт создаёт немой пример в .work/, а флаг --prepare-only готовит редактируемую композицию без рендера. Нужны Python 3.9+, ffmpeg, ffprobe, Node.js 22+ и npm. При первой сборке загружается GSAP 3.15.0; рендер выполняет HyperFrames 0.8.214. Ключ API и расшифровка не требуются.
Для замены ведущего нужен вырезанный альфа-слой того же размера с совпадающими кадрами; kit/cutout.py может его создать. Автоматическую сегментацию сборщик не выполняет. Для ролика длиннее шаблона нужно расширить временную шкалу HTML и окна исходников; одной смены длительности недостаточно.
Какие задачи решает
- собрать портретный ролик с переходом от общего плана к детали
- заменить фотографию и перенастроить точку кадрирования
- подготовить редактируемую композицию без рендера
- проверить MP4 после сборки и декодирования
Примеры запросов агенту
- Примени
/visual-notesк портретному видео о новом продукте. - Собери ролик по спецификации
spec.jsonс фотографией целиком и приближением к детали. - Подготовь редактируемую композицию без рендера с флагом
--prepare-only.
Как установить visual-notes
1Через маркетплейс плагинов
/plugin marketplace add artemnovitckii/claude-editing-skills/plugin install editing-skills@claude-editing-skillsКоманда ставит плагин editing-skills целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add artemnovitckii/claude-editing-skills --skill visual-notes -a claude-code3Вручную: положить файлы
~/.claude/skills/visual-notes/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/visual-notes/
1Через Skills CLI (Vercel)
npx skills add artemnovitckii/claude-editing-skills --skill visual-notes -a codex2Вручную: положить файлы
.agents/skills/visual-notes/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add artemnovitckii/claude-editing-skills --skill visual-notes -a cursor2Вручную: положить файлы
.cursor/skills/visual-notes/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install artemnovitckii/claude-editing-skills skills/visual-notes2Вручную: положить файлы
.github/skills/visual-notes/SKILL.md1Через Skills CLI (Vercel)
npx skills add artemnovitckii/claude-editing-skills --skill visual-notes -a gemini-cli2Командой платформы
gemini skills install https://github.com/artemnovitckii/claude-editing-skills --path skills/visual-notesВручную: положить файлы
.devin/skills/visual-notes/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о visual-notes
Как установить visual-notes в Claude Code?
Добавь маркетплейс командой /plugin marketplace add artemnovitckii/claude-editing-skills, затем установи плагин командой /plugin install editing-skills@claude-editing-skills.
Что делает visual-notes?
Скилл собирает портретное видео, где изображение над вырезанным спикером переходит от полного вида к приближению на выбранную деталь.
Что нужно для работы visual-notes?
Нужны Python 3.9+, ffmpeg, ffprobe, Node.js 22+ и npm. Первая сборка загружает GSAP 3.15.0, а для рендера используется HyperFrames 0.8.214; ключ API и расшифровка не нужны.
Исходный текст
SKILL.md · MIT
--- name: visual-notes description: An image above the isolated speaker changes from a complete view to a deliberate close-up detail. Use for /visual-notes or to apply this specific portrait-video treatment. --- # /visual-notes Apply this treatment to a portrait clip using the included 4.2-second, 1080x1920, 30fps starter. The style and images are independent of the sample speaker’s words; follow the user’s chosen topic. [See the reviewed example](../../docs/style-showcase/visual-notes.mp4). ## Use Resolve this skill folder from the base directory shown when the skill loads. Its `build.py` resolves the shared kit through that real path, including when installed as a symlink. Run: ```bash python3 /path/to/skills/visual-notes/build.py /path/to/spec.json ``` With no spec, the command reproduces the included silent sample into the repository’s `.work/` directory. `--prepare-only` builds an editable composition without rendering. Python 3.9+, ffmpeg/ffprobe and Node.js 22+/npm are required. The first build downloads pinned GSAP 3.15.0 into the ignored vendor cache; rendering uses HyperFrames 0.8.214. No transcript or API key is needed for these short templates. [Spec and custom-footage instructions](../../docs/style-showcase/README.md). ## Adapt the treatment Show the whole photograph first, then expose a specific detail at 1.5s. Re-anchor the crop inside `#iris` when changing the photograph; the example focuses on the pixelated burger detail. Update `#tag`, `#callout` and both initial and GSAP-updated text. The magnification should reveal something real in the image. Asset keys: `explainer_cut.webm`, `pixel-burger.jpg`. Full-resolution example images and source credits are in [assets/style-showcase](../../assets/style-showcase/README.md). Supply a same-size, frame-matched alpha cutout when changing the presenter. The existing `kit/cutout.py` can create it; see the shared guide. Inspect hair and hands over both bright and dark imagery. The build helper does not perform segmentation automatically. Keep the presenter visible from the first result frame. Use sharp photographs and clean type. Essential text and the face should clear platform overlays; let decorative imagery bleed rather than shrinking the entire composition. The sample’s captions and image anchors are starting points, not automatic tracking. ## Review and deliver The helper validates media dimensions/duration, prepares the composition, runs the renderer check, renders and fully decodes the MP4. Inspect the first frame, the main change and the ending. Check crop anchors, text readability and matching source/cutout timing. The default is silent; preserve or add speech, SFX or music only when the user requests them. Longer edits require extending the HTML timeline and source windows; changing only the duration is insufficient. These are local Claude Code/Codex editing workflows. The ChatGPT conversation in the showcase is an authored visual, not a built-in ChatGPT slash-command integration. Third-party image rights are documented separately from the code license in the asset directory.
© Artem Novitckii · MIT · artemnovitckii/claude-editing-skills