К основному содержанию
скилл CX Codex

feature-clip — скилл для Claude Code: клипы и установка

Скилл feature-clip ведёт сборку коротких зацикленных роликов SpecKit Companion от захвата в Storybook до файлов для сайта и документации.

MIT ★ 110 обновлён 2026-11-03

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add alfredoperez/speckit-companion --skill feature-clip -a claude-code
Открыть на GitHub

Что делает feature-clip

Скилл описывает рабочий процесс для роликов SpecKit Companion: захват кадров из Storybook, настройку композиции и раскадровки, рендер и подготовку файлов для сайта и документации. Команды проекта создают заготовку клипа, снимают исходные PNG, формируют MP4, WebM, постер и GIF, синхронизируют медиа и проверяют расхождения в раскадровке. Перед полным кодированием npm run clips:render -- --list показывает, какой файл выбран для рендера.

При изменении таймингов нужно согласовать значения t в композиции и STORYBOARD.md; метки в обоих местах сверяет проверка. Размеры областей для маркеров берутся из координат захвата, поэтому их нельзя надёжно выставить на глаз. Без ffmpeg и доступа к npx для HyperFrames нужная часть процесса не запустится. Скилл также описывает правила для стартовой паузы, титров и выбора исходного рендера.

Какие задачи решает

  • собрать новый ролик из шаблона клипа
  • переснять кадры клипа из Storybook
  • изменить тайминг битов и синхронизировать раскадровку
  • подготовить видео, постер и GIF для сайта и документации
  • найти расхождение между раскадровкой и композицией

Примеры запросов агенту

  • Создай заготовку клипа <id> с названием «Human name» и подготовь её к рендеру.
  • Пересними исходные PNG для клипа <id>, затем покажи, какой рендер выберет команда кодирования.
  • Измени тайминг битов клипа <id> и синхронизируй метки с STORYBOARD.md.

Как установить feature-clip

1Через Skills CLI (Vercel)

npx skills add alfredoperez/speckit-companion --skill feature-clip -a claude-code

2Вручную: положить файлы

~/.claude/skills/feature-clip/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/feature-clip/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о feature-clip

Как установить feature-clip в Claude Code?

Выполни npx skills add alfredoperez/speckit-companion --skill feature-clip -a claude-code. Файл скилла находится по пути ~/.claude/skills/feature-clip/SKILL.md.

Что делает feature-clip?

Помогает пройти процесс сборки короткого ролика SpecKit Companion: от кадров из Storybook до рендера и синхронизации медиа для сайта и документации.

Что нужно для работы feature-clip?

Нужны ffmpeg и доступ к npx для HyperFrames. Для координат областей в клипе используются размеры исходного захвата, а не измерения на глаз.

Исходный текст

SKILL.md · MIT
---
name: feature-clip
description: Build, retime, restyle or re-render a SpecKit Companion feature clip —
  the short looping videos on the landing page and in the docs. Covers the whole
  chain from Storybook capture to the file the site serves.
compatibility: Requires ffmpeg, and npx access for hyperframes
metadata:
  author: alfredo
  source: repo
---

# Feature clip

The landing page and the docs are carried by short looping clips: a product screenshot,
a camera that moves across it, a ring around the region being named, and a caption band.
This skill owns **how this repo makes them**. The composition contract itself — GSAP
timelines, the HyperFrames runtime, keyframes, the CLI — belongs to the upstream
`hyperframes-*` skills. Defer to those for anything about the engine, and use this for
anything about the pipeline.

Two references sit beside this file. Read `references/visual-assets.md` before regenerating documentation images, changing the capture palette, a capture story or a fixture, or touching site stills, favicons or mascot poses: it says what each change makes stale and which script rebuilds it. Read `references/media-manifest.md` before adding a feature or an output, wiring a clip or still into a README or the site, or acting on a `clips:check` failure: it is the `content/media/manifest.json` contract. Screenshots and recordings of the real product are the `shots` skill.

## The chain

```
capture → compose → storyboard → render → web encode → sync → check
```

Every stage has a command. None of them takes an argument you have to remember.

```bash
npm run clips:new -- <id> "Human name"     # scaffold from _template
npm run clips:capture -- --clips <id>      # shoot the source PNGs from Storybook
(cd content/media/feature-clips/<id> && npm run render)   # composition -> canonical MP4
npm run clips:render -- <id>               # -> content/media/web: webm, mp4, poster, 16:9 card
npm run clips:stills                       # hero and accordion crops -> content/media/web
npm run clips:gifs -- <id>                 # -> docs/screenshots/generated/<id>.gif
npm run clips:sync                         # -> apps/website/public/media
npm run clips:check                        # storyboard drift + manifest
npm run clips:outline -- <id>              # pacing: t, hold and label per beat
npm run clips:scenes -- <id>               # scene and step list, for review
```

`clips:capture` with no `--clips` shoots the documentation images instead: the
`STORIES` list, which feeds `docs/screenshots/generated/`. Both lists live in
`tooling/scripts/capture-docs-images.mjs`.

`npm run clips:render -- --list` prints which render file each id resolves to. **Run it
before any full encode.** It is how you catch a stale source before it ships.

## Starting a new clip

`npm run clips:new` copies `content/media/feature-clips/_template`, substitutes the id, adds a
`CLIP_CAPTURES` stub, and registers the feature in `content/media/manifest.json`. Do not copy a
neighbouring composition by hand: the template is where the current caption, scrim and
pacing rules live, and a hand copy inherits whichever clip happened to be nearest.

The template renders as-is against a placeholder capture, so `npm run render` works
before you have shot anything. Get it rendering first, then make it real.

## The rules a clip has to hold

- **Open still.** The first beat starts no earlier than `t = 3.0`. Before that the
  camera rests and nothing is marked. The site will not even start playback until the
  frame is fully on screen, so this hold is the first thing anyone sees.
- **Never hold under 3.0s.** A beat's hold is the gap to the next beat's `t`; there is
  no hold constant. Retiming means rewriting the `t` column, in the composition and in
  `STORYBOARD.md`.
- **`maxS` above about 2.2 stops reading as a product** and starts reading as a crop.
- **Captions are a band**, not a pill on the marker. `.lbl` lives in `#anno`, which is a
  sibling of `#stage`, so it is in frame coordinates and never scales with the camera.
  It pins to whichever edge its region sits furthest from.

## Traps

Each of these has already cost someone a session.

- **Rects are measured, not authored.** Every `r: [x, y, w, h]` in `BEATS` is a real
  `getBoundingClientRect` box in **the capture's own CSS pixels**. Captures are DPR 2,
  so a 2448×1552 file is 1224×776 in rect space. Eyeballing a rect produces a clip that
  points at nothing.
- **The encoder picks the newest render, not `<id>.mp4`.** `sourceFor()` sorts
  `renders/*.mp4` by mtime. A stale canonical once shipped three-renders-old labels to
  the site. `--list` shows the choice and warns when a newer take is being preferred.
- **Every tween is `fromTo` with `immediateRender: false`.** The renderer seeks by frame
  in arbitrary order, so a tween without an explicit start pose makes frame zero show
  the last move's "from". Initial state comes only from the `gsap.set` calls.
- **`CUTS` are not retimed with `BEATS`.** Move a beat and the state change that belongs
  to it stays where it was. Retime both, together.
- **A cut before the first beat runs during the opening hold**, which is almost always
  wrong: the hold should already show the state the first caption talks about.
- **The poster is MD5-verified against the WebM's first decoded frame.** That check is
  what catches half-synced media. Never route around it.
- **Labels are mirrored in `STORYBOARD.md` and the check enforces `t` and the label
  text.** `node tooling/scripts/clip-storyboard.mjs --apply <id>` writes storyboard label edits
  back into the composition. Rects stay code-owned and are never in the storyboard.
- **Hand-authored compositions have no `BEATS`** and are skipped by the checker by
  design: `make-it-yours`, `overview-engine`, `overview-readme`,
  `write-only-specs`.
- **An underscore prefix means scaffolding.** `_template` is skipped by the storyboard
  checker and the encoder.

## Retheming

Two seams, and a re-theme almost always needs both.

**The captures.** `.storybook/capture-theme.ts` holds named palettes and one line —
`activeCapturePalette` — that decides which one every story, screenshot and clip frame
renders in. The fifty-odd `--vscode-*` variables are derived from a short set of roles,
so a re-theme is a handful of role edits rather than fifty coordinated ones. The set
currently ships **Constellation Light**, which is why the product reads as a light
surface on the site's near-black ground.

**The composition chrome.** The marker, scrim and caption band a clip draws over the
screenshot live in the `:root` block of its own `index.html`, named by role.

The trap is a composition that is **drawn rather than captured**: `make-it-yours`,
`living-specs-explained`, `write-only-specs`. Those have no screenshot under them, so the capture palette
cannot reach them at all and they have to be re-themed by hand or they end up as the one
dark thing in a light set. The same trap caught the README composite stories, which had
hardcoded a dark theme's neutrals instead of reading the derived variables; they read
the palette now, and new composite chrome must too.

After a re-theme, everything downstream is stale: re-shoot both capture lists, re-render
every composition, then `clips:render`, `clips:stills`, `clips:gifs`, `clips:sync`.

## Where things live

| What | Where |
| --- | --- |
| Compositions | `content/media/feature-clips/<id>/` |
| Template | `content/media/feature-clips/_template/` |
| Capture list | `CLIP_CAPTURES` in `tooling/scripts/capture-docs-images.mjs` |
| Capture palette | `.storybook/capture-theme.ts` |
| Canonical renders | `content/media/feature-clips/<id>/renders/` (gitignored) |
| Web outputs | `content/media/web/` (tracked on purpose) |
| What the site serves | `apps/website/public/media/` |
| Asset registry | `content/media/manifest.json` |
| Encode settings | `DEFAULTS` in `tooling/scripts/render-web-clips.mjs` |

## Encode settings, and why they are what they are

1440 px wide, H.264 CRF 26, VP9 CRF 40. The composition frame is 1836×1164 and the site
paints it into 864 CSS px, which is 1728 device px on a 2× display. The previous 960 px
encode was upscaled almost 2× in the browser on top of a 1.9× downscale in ffmpeg, and
CRF 32 smeared small UI text on the way. Width buys more than quantizer here, which
`content/media/WEB-RENDERS.md` established with a VMAF sweep before the numbers were raised.

Total bytes are not on the critical path: the `<video>` elements carry `preload="none"`
and only play when their tab is selected, so a visitor fetches the posters plus at most
one clip.

© alfredo · MIT · alfredoperez/speckit-companion

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
social-media-clip-creator davila7 Субагент social-media-clip-creator режет видео на клипы под TikTok, Reels, Shorts, Twitter и LinkedIn: кроп, субтитры, превью и перекодирование через FFmpeg. CX Codex 970установок cinetic Leonxlnx Скилл cinetic собирает рекламные и продуктовые видео из кода через Remotion или HyperFrames, от сценария до готового рендера. Запускается, когда нужен лонч-ролик, анимация фичи или тизер. CX Codex +1 2 100установок motion-ad danny.md — https://www.danny.md/skills/motion-ad Скилл motion-ad создаёт короткие 15-секундные рекламные видеоролики в MP4 из посадочной страницы с помощью GSAP, Playwright и ffmpeg. CX Codex +1 ★ 141звёзд репо clip perso-ai Скилл clip для Claude Code и ещё пяти агентных сред нарезает видео на короткие вертикальные клипы. Работает по явным таймкодам или выбирает моменты из транскрипта проекта Perso AI. CX Codex +1 ★ 40звёзд репо orbit-reel Artem Novitckii Скилл orbit-reel для Claude Code оформляет вертикальный ролик: карточки с изображениями движутся вокруг говорящего по 3D-кольцу. Запускается для портретного видео с таким визуальным эффектом. CX Codex +1 ★ 94звёзд репо lower-thirds iart-ai Скилл lower-thirds для Claude Code создаёт анимированные титры и другие прозрачные видеооверлеи. Запускается по запросу на плашку с именем, заставку стрима или графику поверх видео. CX Codex +1 894установок

Из того же набора83

Весь набор →
speckit.companion.doctor Команда speckit.companion.doctor проверяет здоровье пайплайна спецификаций: находит незавершённые шаги, пропущенные тесты, утечки задач и ложные отметки о дрифте. Работает только на чтение. CX Codex +1 ★ 110звёзд репо speckit.plan Субагент speckit.plan проходит этапы планирования по шаблону и создаёт исследовательские и проектные артефакты. Запускайте его после подготовки спецификации функции. CX Codex +1 ★ 110звёзд репо speckit.taskstoissues Субагент speckit.taskstoissues для Claude Code превращает задачи из tasks.md в пронумерованные GitHub-issues, сохраняя порядок зависимостей. Создаёт issues из плана задач. CX Codex +1 ★ 110звёзд репо submit-catalog-update Скилл submit-catalog-update формирует и отправляет issue для обновления расширения companion в каталоге spec-kit. Пригодится мейнтейнерам при выпуске минорных и мажорных версий. CX Codex +1 ★ 110звёзд репо publish-speckit-ext Команда publish-speckit-ext для публикации расширения spec-kit в релиз на GitHub. Позволяет другим разработчикам устанавливать расширение через каталог без локального клона репозитория. CX Codex +1 ★ 110звёзд репо speckit.constitution Субагент speckit.constitution создаёт и актуализирует конституцию проекта в .specify/memory/constitution.md на основе принципов команды. CX Codex +1 ★ 110звёзд репо ship-ticket Команда ship-ticket берёт уже готовую ветку, проверяет сборку и проводит изменения через код-ревью, PR и слияние. Она пригодится, когда код уже написан в SpecKit Companion. CX Codex +1 ★ 110звёзд репо speckit.tasks Субагент speckit.tasks разбивает фичу на задачи в tasks.md: берёт plan.md и spec.md из папки фичи и раскладывает работу по историям с зависимостями. CX Codex +1 ★ 110звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой