kinetograph-markup — скилл для Claude Code
Скилл kinetograph-markup для Claude Code пишет и меняет сцены Kinetograph в TSX, HTML или JSON для видео.
Apache-2.0 ★ 542 обновлён 2026-11-17
npx skills add 0xS4N4TG/kinetograph --skill kinetograph-markup -a claude-codeЧто делает kinetograph-markup
kinetograph-markup пишет и изменяет композиции Kinetograph: слои, формы, текст, изображения, камеру, звук, шрифты, эффекты и тайминг. Он использует API Remotion и нативные элементы Layer, Rect, Text, Image, Camera, Audio, а также поддерживает Web Audio через onFrame.
Новая композиция импортирует API из @kinetographdev/core, который входит в kinetograph; устанавливать remotion для неё не нужно. Существующий проект Remotion сохраняет импорты remotion и @remotion/*. Файл сцены должен вызвать registerRoot. Шрифты регистрируются до измерения текста, а для повторяемого рендера применяется random(seed), не Math.random().
HTML, CSS, SVG, Canvas и WebGL работают в режиме совместимости, но неподдерживаемый движок может пропустить или приблизить часть кадра. Для такого проекта перед render запускается doctor из kinetograph-render; список плагинов проверяется командой npx kinetograph plugins.
Какие задачи решает
- создать сцену видео в TSX, HTML или JSON
- разложить композицию по слоям, формам и тексту
- добавить шрифты, изображения, эффекты и 3D-камеру
- синхронизировать музыку и Web Audio со шкалой кадров
- проверить совместимость DOM, CSS или SVG перед рендером
Примеры запросов агенту
- Создай композицию Kinetograph в
scene.tsxс текстом, фоном и анимацией появления. - Добавь в сцену
card.jsonслойAudioи синхронизируй громкость с кадрами. - Проверь плагины Kinetograph и запусти диагностику проекта перед рендером.
Как установить kinetograph-markup
1Через Skills CLI (Vercel)
npx skills add 0xS4N4TG/kinetograph --skill kinetograph-markup -a claude-code2Вручную: положить файлы
~/.claude/skills/kinetograph-markup/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/kinetograph-markup/
1Через Skills CLI (Vercel)
npx skills add 0xS4N4TG/kinetograph --skill kinetograph-markup -a codex2Вручную: положить файлы
.agents/skills/kinetograph-markup/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add 0xS4N4TG/kinetograph --skill kinetograph-markup -a cursor2Вручную: положить файлы
.cursor/skills/kinetograph-markup/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install 0xS4N4TG/kinetograph packages/cli/skills/kinetograph-markup2Вручную: положить файлы
.github/skills/kinetograph-markup/SKILL.md1Через Skills CLI (Vercel)
npx skills add 0xS4N4TG/kinetograph --skill kinetograph-markup -a gemini-cli2Командой платформы
gemini skills install https://github.com/0xS4N4TG/kinetograph --path packages/cli/skills/kinetograph-markupВручную: положить файлы
.devin/skills/kinetograph-markup/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о kinetograph-markup
Как установить kinetograph-markup в Claude Code?
Выполните npx skills add 0xS4N4TG/kinetograph --skill kinetograph-markup -a claude-code. Затем файл скилла будет доступен по пути ~/.claude/skills/kinetograph-markup/SKILL.md.
Что делает kinetograph-markup?
Скилл пишет и меняет композиции Kinetograph в TSX, HTML и JSON. Он описывает работу с Remotion API, нативными элементами, шрифтами, медиа, эффектами, звуком и таймингом.
Что нужно для работы kinetograph-markup?
Для новой композиции используется @kinetographdev/core, который входит в kinetograph; для рендера и диагностики нужен kinetograph-render. В существующем проекте Remotion сохраняются remotion и @remotion/*.
Исходный текст
SKILL.md · Apache-2.0
---
name: kinetograph-markup
description: Write or change a Kinetograph composition: the Remotion API, native elements (Layer, Rect, Text, Image, Camera, Audio), layout, type, fonts, media, effects, Web Audio sound, timing, plugins, and what the engine draws and does not. Use when writing or editing the TSX, HTML or JSON scene of a video.
metadata:
version: "0.4.0-rc.1"
---
# Write a composition
A new project imports the API from `@kinetographdev/core`, which comes with `kinetograph`; never install `remotion`
(`@remotion/*` imports such as the font loaders are mapped too). An existing Remotion project keeps its `remotion` and
`@remotion/*` imports, which map onto the same code. The entry must call `registerRoot`; a file that only exports a
component is not an entry. An entry is a project file (`.tsx`, `.ts`, `.jsx`, `.js`), a `.json` scene, or an HTML page.
```tsx
import { AbsoluteFill, Composition, Layer, Rect, Text, interpolate, registerRoot, spring,
useCurrentFrame, useVideoConfig, dropShadow, linearGradient, registerFont, staticFile } from '@kinetographdev/core';
registerFont({ family: 'DM Sans', path: staticFile('fonts/DMSans-Medium.ttf') }); // fonts BEFORE any text is measured
const Card = () => {
const frame = useCurrentFrame();
const { fps, width, height } = useVideoConfig();
const s = spring({ frame, fps, config: { damping: 14 } });
return (
<AbsoluteFill style={{ backgroundColor: '#10131a' }}>
<Layer x={width / 2} y={height / 2} scale={s} origin="center" effects={[dropShadow({ y: 12, blur: 24 })]}>
<Rect width={600} height={300} radius={32} fill={linearGradient(['#f9a', '#fc6'])} />
<Text font="DM Sans" size={72} color="#fff" x={60} y={100}>gets better</Text>
</Layer>
</AbsoluteFill>
);
};
registerRoot(() => <Composition id="Main" component={Card} durationInFrames={90} fps={30} width={1080} height={1920} />);
```
- Remotion's API works as documented: `useCurrentFrame`, `useVideoConfig`, `interpolate`, `interpolateColors`, `spring`,
`Easing`, `random`, `Sequence`, `Series`, `Loop`, `Freeze`, `AbsoluteFill`, `Img`, `staticFile`, `delayRender`.
`staticFile('x.png')` is `public/x.png` next to the entry file, or in the `public/` at the package.json's folder.
- Rendering is a pure function of the frame number. `Math.random()`, `Date.now()` and timers are driven by the frame; use
`random(seed)` for jitter. Never read the real clock.
- Register fonts before text is laid out. Text with a font that is not registered is a lint error.
- For new work use the native elements below. `<div>`s, `className`, stylesheets, Tailwind and SVG also work (compat
mode); a frame holding something the engine cannot draw yet is drawn without it or approximated, and the command warns.
Run `doctor` on such a project before `render` (`kinetograph-render`).
## Elements and effects
Every element takes `id`, `x`, `y`, `scale`, `rotation`, `origin="center"`, `opacity`, `blendMode`, `effects`, `clip`,
`mask`, `matte`, `motionBlur`, and 3D `z`, `rotateX`, `rotateY`. Numbers may be plain or keyframe lists.
| Element | For |
|---|---|
| `<Layer>` | a group; `layout` (flexbox) and `preserve3d` |
| `<Rect>`, `<Ellipse>`, `<Path>`, `<Shape>` | vector shapes with `fill` (colour or gradient) and `stroke` |
| `<Text>` | text; `font`, `size`, `color`, `maxWidth`, `align`, per-character `chars` |
| `<Image>`, `<Img>` | PNG, JPEG, GIF, WebP, SVG files; `fit="cover"` |
| `<Noise>`, `<MeshGradient>`, `<Lottie>` | generated and Lottie layers |
| `<Camera>` | a perspective camera for 3D transforms |
| `<Audio>` | a sound file: `src`, `volume`, `trimBefore`, `playbackRate`, `loop` |
Effects (helpers of the same name; `kinetograph effects` lists their fields): `blur`, `backdropBlur`, `glow`,
`chromaticAberration`, `dropShadow`, `insetShadow`, `saturate`, `contrast`, `brightness`, `grayscale`, `sepia`, `invert`,
`hueRotate`, `gradientMap`, `lut`, `colorGrade` (HyperFrames' grade and its 18 look effects: `{ effects: { halftone: 0.9 } }`),
`grain`, `dither`, `halftone`, `dotMatrix`, `displace`, `cornerPin`, and `shader` for your own WGSL. `motionBlur({ samples: 8 })`
goes in the same `effects` array.
## Sound
Web Audio code runs offline against the frame timeline. Call `onFrame` at module level; `ctx` is an `OfflineAudioContext`,
`t` is the start time in seconds.
```ts
import { onFrame } from '@kinetographdev/audio';
onFrame(42, (ctx, t) => {
const o = ctx.createOscillator(); const g = ctx.createGain();
o.frequency.setValueAtTime(3000, t); o.frequency.exponentialRampToValueAtTime(4500, t + 0.055);
g.gain.setValueAtTime(0.4, t); g.gain.exponentialRampToValueAtTime(0.001, t + 0.06);
o.connect(g).connect(ctx.destination); o.start(t); o.stop(t + 0.06);
});
```
`<Audio src={staticFile('audio/music.mp3')} volume={(f) => interpolate(f, [0, 30], [0, 1])} />` plays a file. `render`
mixes both into the video. Measure it with `audio analyze` (`kinetograph-render`).
## Habits
- Run `npx kinetograph plugins` and read each plugin's `SKILL.md` before using it. Plugin tools show as `<plugin>_<tool>`.
- Give an explicit `id` to matte sources and to anything an `<Audio>` or matte refers to.
- Use `random(seed)`, never `Math.random()`, so a frame is the same every time.
## References
Read the part you need; these files are large.
| File | What it holds |
|---|---|
| `references/capabilities.md` | the `@remotion/*` packages that import, compat mode (DOM, CSS, SVG, Canvas, WebGL), libraries and plugins that render, HTML and HyperFrames pages, fonts, datamosh, motion tracking, video matting |
| `references/AUTHORING.md` | the contract of each package: §5 helpers, §6 elements and their JSON, §7 the Remotion API, §8 audio, §9 CLI and export, §11 video layers, GSAP and plugins |
| `references/SCENE.md` | the `.json` scene: every layer type, effect and field, and what each means exactly |
| `references/ENGINE.md` | the DOM and CSS engine: what CSS and SVG it draws |
| `references/INTERNALS.md` | how a frame is made, and the code map |
© 0xS4N4TG · Apache-2.0 · 0xS4N4TG/kinetograph