General Video

General video

Before relying on this workflow, run:

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/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:

For a new project, choose a kebab-case directory name from the brief and scaffold before writing the brief:

npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video

Then write BRIEF.md at the project root using ../hyperframes/references/brief-format.md. In an existing project, the root is the directory containing hyperframes.json. Record only the confirmed preference-backed fields named by the brief format, using node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>; never record inferred defaults. Here <MEDIA_DIR> is the installed /media-use skill directory and <PROJECT_ROOT> is the directory containing hyperframes.json. If the intent layer adopted a recipe, apply it now with node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <name> and do not ask again.

3. Interpret the run shape

Use only the canonical terms from ../hyperframes/references/brief-contract.md:

Do not invent synonyms for these states. An ongoing “just build it” signal is handled by the intent layer and arrives as flow: automation, storyboard: no.

• For flow: automation, choose the route and state it in one line in the first progress update.
• For a specific edit, make the edit without inventing a new route.

For a hard cut, trim, splice, or reorder of existing footage, duplicate the same video source into multiple clip elements. On each copy, set the source range with data-media-start plus data-duration, then set authored placement/order with data-start. Separately authored audio follows the identical clip ranges and timing on matching <audio> elements. /hyperframes-core owns this temporal edit; use /hyperframes-keyframes only for visual-property animation such as zoom, punch, pan, crop, mask, or clip-path on an inner wrapper. Copy the full contracts from ../hyperframes-core/references/creator-editing-recipes.md.

Companion flow

When flow: companion:

• Read BRIEF.md and reconcile accepted ## Assets and ## Customizations with project artifacts. Complete accepted work that is still pending; leave completed work alone; do not offer an accepted capability again as if it were new.
• Arrive as the director, not the contractor. A user who chose companion chose involvement and quality; the honest response is the best version you can design, not the smallest one you can defend. The first plan is the ceiling treatment: the story arc (borrow the nearest genre lens — menu § Genre lenses), the design spec, each scene's motion treatment cited by name (§ 5's plan discipline), the transitions, the audio identity — music and sound marks, or deliberate silence — the user's material placed, and a designed open and close. Say what each layer adds in one line; flag the expensive ones (render time, sign-in, billing) as you name them. The user trims a treatment down; they should never have to assemble one approval by approval.
• The ceiling belongs to the concept, not the toolbox. Every layer must serve the brief's message — a treatment that would dress any video the same way is decoration. Craft rises to the ceiling; content never grows past what was asked (§ 6).
• Between checkpoints, ../hyperframes/references/capability-menu.md works two ways. As the trigger list: offer a relevant capability when the user mentions its input or the build reaches its need. As each pass's upgrade channel: a plan, sketch, or build checkpoint may carry one or two traced offers pointed at material the user is looking at ("scene 3's stat wants the count-up treatment"). Read it before offering; never dump the full catalog.
• After the user accepts a capability, produce its artifact and record the decision in the matching BRIEF.md body section immediately. Rewrite a frontmatter field and record the confirmed preference only when the user explicitly changes it.
• Keep the same storyboard, validation, final-preview, and render-approval gates. Companion changes who steers, not what quality requires.

4. Load required knowledge before each stage

These reads are mandatory when their condition matches:

| Condition | Read before acting |