Communitygithub.com

muse-video-master-skill

Plan, prompt, generate, stitch, and verify Muse videos — from a 10-second clip to a 30-second+ short. Every video starts with the Hook Formula: Hook + Trend Relevance + Value + Production. Use when the user wants a product demo, unboxing, ad, talking head, sci-fi short, or multi-scene video. Built by Corporeal Inc for Open House App.

What is muse-video-master-skill?

muse-video-master-skill is a Claude Code agent skill that plan, prompt, generate, stitch, and verify Muse videos — from a 10-second clip to a 30-second+ short. Every video starts with the Hook Formula: Hook + Trend Relevance + Value + Production. Use when the user wants a product demo, unboxing, ad, talking head, sci-fi short, or multi-scene video. Built by Corporeal Inc for Open House App.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/corporealinc/muse-video-master-skill/tree/HEAD

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Muse Video Master Skill v2

Built by Corporeal Inc — Open House App (https://openhousesheet.com) One skill, from idea to finished video. No video is prompted until it passes the Hook Formula.

The Hook Formula — Gate 0, Before Anything Else

Every brief must answer these four, in order. See references/hook-formula.md.

  1. Hook — What stops the scroll in the first 3 seconds? One line, one image, one surprise. If it cannot be said in one sentence, it is not a hook yet.
  2. Trend Relevance — Why now? A date, a season, a trend, a question people are already asking. No trend, no urgency.
  3. Value — What does the viewer get in the next 10 seconds? A saving, a how-to, a before/after, a decision made easier. Name it, do not imply it.
  4. Production — Can this be made within the real limits? One clip is about 10 seconds. Face lock is weak. Reference images need ASCII filenames. If the idea needs more, split it into segments first.

Rule: no prompt is written until Gate 0 is written down and the user approves it. A beautiful prompt for a video nobody watches is a failed video.

Routing — Route First, Then Act

User wants a video
  │
  ├─ Gate 0: Hook + Trend Relevance + Value + Production → user approves
  │
  ├─ One 10-second clip / product demo / unboxing / talking head → Fast path
  │     Write the six-part prompt → generate → verify by frames → deliver
  │
  ├─ Ad / script / storyboard / art direction / sci-fi short / multi-scene
  │  / reference a specific case style → Full path
  │     Brief → story → visuals → script → sound → storyboard
  │     → Creative Package, user approves → write prompts per segment → generate
  │
  ├─ Already has a video, wants edits / effects / subtitles → This skill does not render directly
  │     Produce a storyboard / edit plan for reference; route to a downstream
  │     tool only if one is configured
  │
  └─ Strong face lock / look like a specific real person → State the limit first:
        built-in video face lock is weak. Use Seedance 2.0 / a third-party
        model; this skill does not promise it

Fast Path — Prompt First

  1. Gate 0 first. Write the four Hook Formula lines. Get approval.
  2. Write the prompt. Use the six-part template in references/prompt-template.md: duration / aspect ratio, character, setting, timed beats, camera language, sound / dialogue, restrictions. The hook is beat 1 — it must land in the first 3 seconds. Reuse the character description word-for-word across the whole video. After the user approves the prompt, pass it to the generator exactly as approved — do not rewrite or expand it.
  3. Generate. Text-only first. If using a reference image, confirm the file exists and its filename is ASCII. See the capability limits in references/model-notes.md.
  4. Long video (over 10 seconds). Split by beats, each segment 10 seconds or less with 2–3 shots. Continue each later segment from the previous segment with resume_from_snapshot_id. Stitch with ffmpeg at the end. See references/stitch-workflow.md.
  5. Verify. Extract frames from every segment with bin/extract_frames.py and check them yourself. Audio, lip-sync, and motion continuity cannot be seen or heard by the agent — say so clearly and leave them for the user's final check.
  6. Record. Write one case card per experiment into references/cases/.

Full Path — Plan First, Then Prompt

See references/pre-production.md. In short:

  1. Brief — Gate 0, plus aspect ratio, use, setting, constraints
  2. Story — story, scenes, narrative structure; the hook opens scene 1
  3. Visual development — color, style, sets, character design
  4. Script — dialogue, camera language, action, duration
  5. Sound direction — music, sound effects, narration tone (direction only, do not generate audio)
  6. Storyboard — 6/9-panel storyboard; ask the user whether to generate storyboard images
  7. Assemble — Creative Package; the user confirms it and it is locked (the single final approval gate)
  8. Model compile — compile into six-part prompts + multimodal references + cost estimate; Seedance 2.0 supported
  9. Generate — take the compiled per-segment prompts and run Fast Path steps 3–5 to generate, stitch, and verify

Each stage is reviewed by the Director, with at most 2 revision rounds. Simple projects (1–2 scenes, no characters, user is in a hurry) use the fast-track: merge stages 2, 3, and 4 into a single draft, skip the Director's multi-round review.

Scene types: studio-ad (advertising) / logo-animation / product-demo (product demo and unboxing) / sci-fi / custom (general). Case matching: check references/cases/INDEX.md first — 38 benchmark cases plus tested cases from 2026-10-05.

Real Estate Shortcut — Open House App

This skill was built for real videos agents actually need. When the video is a listing, open house, or staging video:

  • Hook: the one thing that makes this home different, in 3 seconds.
  • Value: price, layout, or light — one concrete fact, not "beautiful home."
  • Production: shoot the hero room first, then the detail shots; one segment per room.
  • StageVibe: for an empty room, show the staged version first — https://openhousesheet.com/virtual-staging

Output Contract

  • Fast path: finished video + segment files (kept) + frame-check conclusions + items left for the user's final check (audio, lip-sync, motion)
  • Full path: Creative Package (script + storyboard + art direction + prompts, see assets/templates/) + finished video
  • Save everything under: workspace/prompt-experiments/<date>/, named <topic>-segN.mp4 / <topic>-full.mp4

Operating Rules — Honesty First

  1. Reply in English unless the user asks for another language.
  2. Gate 0 and the prompt are final only when the user approves them; show the draft first, generate only after approval.
  3. Do not promise face lock or that a reference image will look like the person. A single clip is capped at about 10 seconds — for longer videos, proactively offer the segment-and-stitch plan.
  4. Reference images must use ASCII filenames; /tmp is temporary, so confirm the file exists before uploading.
  5. Extract frames and check them before delivering any video; never say a video is fine without checking it.
  6. Never invent visual or audio details — if it has not been verified, say it has not been verified.
  7. Dialogue: see references/dialogue.md. The user's explicit language choice always wins.

Credits

This skill builds on two MIT-licensed open-source skills. Full credits and links: ATTRIBUTION.md. The workflow, Hook Formula gate, and Open House App shortcut in this file are original to Corporeal Inc.

Related Skills