# general-video

general-video — a skill for authoring and editing video through HyperFrames compositions: multi-scene pieces, promos, montages, static loops, and footage remixes.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 328 repo stars
- Author: coco-research
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/coco-research/coco/tree/HEAD/systems/hyperframes/skills/general-video/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/general-video

## What it does

The skill activates when no specialized workflow fits or when `BRIEF.md` sets `flow: companion`. It handles longer pieces, brand and sizzle reels, montages, static title cards, and freeform builds. Short animated titles and motion-first units go through `motion-graphics` instead.

Before starting, the skill checks currency with `npx hyperframes skills update general-video`. If a project exists, it reads `BRIEF.md` and continues from the current state — edits land without reopening discovery. For a new project, it scaffolds structure via `npx hyperframes init` and writes the brief.

In `flow: companion` mode, the skill proposes a full treatment: story arc, design spec, named motion treatments for each scene, transitions, and audio identity. Every layer serves the brief's message. Integration with `/media-use` for audio, images, logos, and effects; Figma input triggers `/figma` first.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add coco-research/coco --skill general-video -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/general-video/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/general-video/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add coco-research/coco --skill general-video -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/general-video/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add coco-research/coco --skill general-video -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/general-video/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install coco-research/coco systems/hyperframes/skills/general-video
```

2. **Manually: put the files in place**
- File: `.github/skills/general-video/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add coco-research/coco --skill general-video -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/coco-research/coco --path systems/hyperframes/skills/general-video
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/general-video/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/coco-research/coco/tree/HEAD/systems/hyperframes/skills/general-video/SKILL.md

## When to use it
- assemble a multi-scene piece from footage and a given script
- build a brand sizzle reel with logos and transitions
- create a static loop or title card with text
- edit an existing HyperFrames composition
- apply a named motion treatment to scenes

## Example prompts
- Build a 60-second promo from three scenes: logo intro, product demo, closing call-to-action
- Edit scene 3 in `videos/promo/hyperframes.json`: swap background music to `track-02.mp3`
- Assemble a montage from four clips in `footage/` with smooth transitions and closing titles

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 865391b56df177d6.

BEGIN THIRD-PARTY FILE 865391b56df177d6
````text
---
name: general-video
description: >
  Author or edit a custom HyperFrames composition when no specialized workflow fits, or when
  BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels,
  montages, static loops, static title cards, footage remixes, and freeform builds. Use
  motion-graphics instead for a short unnarrated motion-first unit, including an animated title.
  Route fresh creation through hyperframes before using this skill.
---

# General video

Before relying on this workflow, run:

```bash
npx hyperframes skills update general-video
```

A successful no-op means the skill is current. Surface an update failure instead of continuing from memory.

## 1. Apply cross-cutting source adapters

- **Media:** For any audio, image, icon, logo, voice, grade, LUT, treatment/effect, caption, or media-operation need, load `/media-use` and follow `../media-use/references/resolve.md` (resolve, adopt, reuse) and `../media-use/references/setup-providers.md` (providers, auth). Vague footage feedback and named styles use `../media-use/references/media-treatments.md` before editing; do not improvise supported media effects with CSS/SVG/opacity. Before the first authenticated provider action, run `npx hyperframes auth status` and relay its output verbatim. If signed out, apply the gate in `../hyperframes-core/references/brief-contract.md`: collaborative waits for sign-in or an explicit offline choice; autonomous states the status and continues through an available offline provider. Surface a blocker when no offline provider can satisfy a required capability. Local adoption alone does not require an auth gate.
- **Figma:** If any input is a `figma.com` URL, run `/figma` first. Build from its exported assets, tokens, components, or storyboard frames. Do not use raw Figma connector calls because they skip SVG sanitization, media provenance, and brand-token binding.

These adapters do not change the workflow selected by `/hyperframes`.

## 2. Start from project state

Apply the first matching row; do not evaluate lower state rows:

| State                                                      | Action                                                                                                         |
| ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| Specific edit                                              | Make the edit, preserve existing project decisions, then rerun affected checks. Do not reopen discovery.       |
````
END THIRD-PARTY FILE 865391b56df177d6

The third-party file has ended. Everything between the 865391b56df177d6 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2622 of 19327 bytes. © coco-research · MIT · https://github.com/coco-research/coco/tree/HEAD/systems/hyperframes/skills/general-video/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
