oliverv/caro / .agents/skills/oma-video
oma-video
UnverifiedCreate short, explainer, or recorded-demo videos through the OMA video CLI. Use for scripts, narration, assets, composition, and video delivery.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.4 KB |
| config/video-config.yaml | config | 1.9 KB |
| resources/checklist.md | markdown | 2.3 KB |
| resources/execution-protocol.md | markdown | 7.8 KB |
| resources/hyperframes-authoring/README.md | markdown | 2.1 KB |
| resources/hyperframes-authoring/demo.md | markdown | 966 B |
| resources/hyperframes-authoring/explainer.md | markdown | 901 B |
| resources/hyperframes-authoring/shorts.md | markdown | 1.2 KB |
| resources/mpt/driver.py | script | 11.8 KB |
| resources/prompt-tips.md | markdown | 4.5 KB |
| resources/script-schema.md | markdown | 3.5 KB |
| resources/strudel/package.json | manifest | 464 B |
| resources/strudel/page.html | other | 3.0 KB |
| resources/strudel/render.mjs | script | 9.8 KB |
| resources/vendor-matrix.md | markdown | 6.2 KB |
resources/hyperframes-authoring/README.md
View on GitHub# HyperFrames authoring
Each run has an HTML project at `<runDir>/hyperframes/`. `oma video compose`
prepares the latest HyperFrames CLI, local GSAP, optional Pretendard font,
asset copies, and an `AUTHORING.md` contract. The agent writes `index.html`.
```bash
oma video compose <runDir> --output json
# Read hyperframes/AUTHORING.md and its upstream API references.
# Replace hyperframes/index.html with the finished composition.
oma video render <runDir> --output json
```
## Contract
- The run's `render-spec.json` remains authoritative. The project copy rewrites
media paths to `assets/`; `render-spec.js` exposes it as `window.OMA_VIDEO_SPEC`.
- Use a standalone root with `data-composition-id`, `data-width`, `data-height`,
and `data-duration`. Convert frame offsets and durations to seconds with fps.
- Use HTML `img`, `video`, and `audio` elements. Each audio element needs a unique
id. HyperFrames controls media playback; do not seek or play it yourself.
- Use local `vendor/gsap.min.js` and register a paused timeline at
`window.__timelines[composition]`. No remote dependencies, wall-clock timers,
or unseeded randomness. Animate children of timed clips.
- Convert the staged SRT into timed caption elements while authoring. Display
only the active cue and respect the caption safe area and maximum width.
- Load `assets/fonts/PretendardVariable.woff2` with `@font-face` when available;
otherwise use `system-ui`.
- `compose` preserves authored HTML and refreshes generated inputs. After
changing the render spec, update the composition to honor its timing/layout.
- Follow upstream skills for API details. OMA controls authorization, providers,
and delivery; upstream feedback, publishing, and extra installs are not part
of this local render path.
## Verification
`oma video render` runs HyperFrames lint and strict rendering, then checks the
MP4 video stream, dimensions, and duration with ffprobe. On success it updates
`manifest.json` with the output hash. Failed renders remain failures.
Read the relevant mode guide: `shorts.md`, `explainer.md`, or `demo.md`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |