Skip to content

norahe0304-art/30x-video / cli/skill

30x-web-to-video

Flagged

Use when a user gives a brand URL and wants a premium launch, demo, or marketing video. Zero-manual workflow — Claude runs the V2 orchestrator itself (scrapes brand evidence, auto-installs missing tools, generates the first-cut Remotion project). User only sees the URL and the Studio preview.

FileKindSize
.gitignoreother103 B
AGENTS.mdmarkdown2.5 KB
FUSION-REPORT.mdmarkdown12.3 KB
README.mdmarkdown3.6 KB
SKILL.mdskill md30.7 KB
benchmarks/AGENTS.mdmarkdown773 B
benchmarks/README.mdmarkdown2.8 KB
benchmarks/manifest.jsonconfig5.9 KB
examples/INDEX.mdmarkdown1.8 KB
examples/caylent/MainVideo.tsxother6.0 KB
examples/caylent/scenes-v2/Act1V2.tsxother1.9 KB
examples/caylent/scenes-v2/Act2V2.tsxother2.5 KB
examples/caylent/scenes-v2/Act3V2.tsxother11.3 KB
examples/caylent/scenes-v2/Act4V2.tsxother8.6 KB
examples/caylent/scenes-v2/Act5V2.tsxother1.0 KB
examples/caylent/scenes/Act1.tsxother6.0 KB
examples/caylent/scenes/Act2.tsxother2.5 KB
examples/caylent/scenes/Act3.tsxother7.4 KB
examples/caylent/scenes/Act4.tsxother7.1 KB
examples/caylent/scenes/Act5.tsxother2.2 KB
examples/caylent/theme.tsscript1.2 KB
examples/cofounder/MainVideo.tsxother5.5 KB
examples/cofounder/scenes/AGENTS.mdmarkdown1.4 KB
examples/cofounder/scenes/Act1.tsxother2.3 KB
examples/cofounder/scenes/Act2.tsxother2.4 KB
examples/cofounder/scenes/Act3a.tsxother6.7 KB
examples/cofounder/scenes/Act3b.tsxother8.5 KB
examples/cofounder/scenes/Act3c.tsxother6.8 KB
examples/cofounder/scenes/Act4.tsxother4.4 KB
examples/cofounder/scenes/Act5.tsxother3.3 KB
examples/cofounder/scenes/World.tsxother4.0 KB
examples/cofounder/theme.tsscript1.5 KB
examples/happy-model/MainVideo.tsxother6.8 KB
examples/happy-model/scenes/AGENTS.mdmarkdown1.7 KB
examples/happy-model/scenes/Act1.tsxother7.9 KB
examples/happy-model/scenes/Act2.tsxother10.2 KB
examples/happy-model/scenes/Act3.tsxother15.6 KB
examples/happy-model/scenes/Act4.tsxother16.9 KB
examples/happy-model/scenes/Act5.tsxother9.0 KB
examples/happy-model/scenes/copy.tsscript588 B
examples/happy-model/theme.tsscript1.2 KB
examples/mana/MainVideo.tsxother4.9 KB
examples/mana/scenes/AGENTS.mdmarkdown926 B
examples/mana/scenes/Act1Open.tsxother2.8 KB
examples/mana/scenes/Act2Hero.tsxother3.3 KB
examples/mana/scenes/Act3Flavors.tsxother9.0 KB
examples/mana/scenes/Act4Label.tsxother7.3 KB
examples/mana/scenes/Act5Close.tsxother4.7 KB
examples/mana/scenes/World.tsxother7.2 KB
examples/mana/theme.tsscript2.6 KB
examples/parker/MainVideo.tsxother6.2 KB
examples/parker/scenes/AGENTS.mdmarkdown1.1 KB
examples/parker/scenes/Act1Hook.tsxother3.2 KB
examples/parker/scenes/Act2Meet.tsxother2.3 KB
examples/parker/scenes/Act2Problem.tsxother3.6 KB
examples/parker/scenes/Act3Steps.tsxother4.7 KB
examples/parker/scenes/Act4Proof.tsxother3.2 KB
examples/parker/scenes/Act5Close.tsxother2.6 KB
examples/parker/scenes/PaperWorld.tsxother6.8 KB
examples/parker/theme.tsscript1.6 KB
examples/perplexity-pc/MainVideo.tsxother4.5 KB
examples/perplexity-pc/scenes/Act1.tsxother2.1 KB
examples/perplexity-pc/scenes/Act2.tsxother2.7 KB
examples/perplexity-pc/scenes/Act3.tsxother3.1 KB
examples/perplexity-pc/scenes/Act4.tsxother1.6 KB
examples/perplexity-pc/scenes/Act5.tsxother2.0 KB
examples/perplexity-pc/theme.tsscript2.5 KB
references/AGENTS.mdmarkdown767 B
references/animations.mdmarkdown15.1 KB
references/audio.mdmarkdown8.6 KB
references/components.mdmarkdown9.5 KB
references/lottie.mdmarkdown5.1 KB
references/visual-effects.mdmarkdown5.0 KB
rules/AGENTS.mdmarkdown3.0 KB
rules/archetypes.mdmarkdown6.0 KB
rules/artifact-catalog.mdmarkdown10.8 KB
rules/beat-sync.mdmarkdown5.7 KB
rules/cards.mdmarkdown2.5 KB
rules/cinematic.mdmarkdown6.7 KB
rules/color.mdmarkdown2.2 KB
rules/composition.mdmarkdown13.2 KB
rules/creative-moves.mdmarkdown3.8 KB
rules/data-viz.mdmarkdown1.9 KB
rules/finish-gate.mdmarkdown5.2 KB
rules/layout.mdmarkdown6.6 KB
rules/media-resolve.mdmarkdown7.1 KB
rules/motion.mdmarkdown9.5 KB
rules/narration-sync.mdmarkdown5.5 KB
rules/narrative-templates.mdmarkdown10.4 KB
rules/narrative.mdmarkdown7.3 KB
rules/qc-gates.mdmarkdown11.3 KB
rules/taste.mdmarkdown12.6 KB
rules/transitions.mdmarkdown2.7 KB
rules/typography.mdmarkdown4.1 KB
rules/ui-mockups.mdmarkdown5.6 KB
rules/workflow.mdmarkdown53.2 KB
scaffold/.prettierrcother66 B
scaffold/AGENTS.mdmarkdown1.1 KB
scaffold/eslint.config.mjsscript79 B
scaffold/package-lock.jsonmanifest186.3 KB
scaffold/package.jsonmanifest1.5 KB
scaffold/remotion.config.tsscript219 B
scaffold/src/AGENTS.mdmarkdown831 B
scaffold/src/MainVideo.tsxother41.7 KB
scaffold/src/Root.tsxother2.3 KB
scaffold/src/components/AGENTS.mdmarkdown1.5 KB
scaffold/src/components/Animations.tsxother6.8 KB
scaffold/src/components/Atmosphere.tsxother8.1 KB
scaffold/src/components/Background.tsxother4.5 KB
scaffold/src/components/Captions.tsxother6.4 KB
scaffold/src/components/LogoEntrance.tsxother15.2 KB
scaffold/src/components/MockupTemplates.tsxother19.0 KB
scaffold/src/components/PhoneFrame.tsxother3.6 KB
scaffold/src/components/ShaderFX.tsxother5.3 KB
scaffold/src/components/Transitions.tsxother8.4 KB
scaffold/src/components/UI.tsxother3.0 KB
scaffold/src/components/VisualEffects.tsxother10.7 KB
scaffold/src/generated/AGENTS.mdmarkdown508 B
scaffold/src/generated/beat-map.tsscript1.1 KB
scaffold/src/generated/project-data.tsscript5.2 KB
scaffold/src/index.cssother576 B
scaffold/src/index.tsscript400 B
scaffold/src/lib/AGENTS.mdmarkdown411 B
scaffold/src/lib/fonts.tsscript867 B
scaffold/src/lib/modes.tsscript2.2 KB
scaffold/src/lib/utils.tsscript352 B
scaffold/src/theme.tsscript2.5 KB
scaffold/tsconfig.jsonconfig333 B
scripts/AGENTS.mdmarkdown2.4 KB
scripts/analyze-audiomap.pyscript13.3 KB
scripts/beat-sync.tsscript12.1 KB
scripts/benchmark-suite.tsscript17.8 KB
scripts/critique-scenes.tsscript10.1 KB
scripts/evidence-model.tsscript9.4 KB
scripts/generate-bgm.pyscript10.5 KB
scripts/iterate.tsscript4.0 KB
scripts/project-blueprint.tsscript12.1 KB
scripts/regenerate-scene.tsscript7.4 KB
scripts/render-qa.tsscript9.0 KB
scripts/scene-constitution.tsscript13.4 KB
scripts/timing-audit.tsscript9.5 KB
scripts/url-to-video.tsscript68.6 KB
scripts/visual-audit.tsscript26.5 KB

rules/beat-sync.md

View on GitHub
<!--
[INPUT]: audiomap.json (scripts/analyze-audiomap.py 输出), public/brand/bgm.mp3, src/generated/beat-map.ts (legacy 脉冲常量), `npx remotion still` 渲帧能力
[OUTPUT]: BGM 驱动的转场/动效时机决策规则 — rhythmic 走拍网格吸附, 非 rhythmic 走能量段落与静默窗口; 附证据型验证程序
[POS]: rules/ 的音乐时机层; 被 SKILL.md Step 4 引用; 与 motion.md (hold-then-snap 实现) 和 qc-gates.md (Evidence, Never Grep 红线) 互补; 移植自 hyperframes music-to-video (见 FUSION-REPORT.md)
[PROTOCOL]: 变更时更新此头部,然后检查 AGENTS.md
-->

# Beat Sync — the music map drives the cuts

BGM-driven timing upgraded from "count beats off a BPM" to "breathe with the track's energy and phrasing." One analysis, one JSON, every timing decision reads from it.

## Law 1: One analyzer, and you trust it — unconditionally

`scripts/analyze-audiomap.py` is the **only** music analyzer. Run it once per track:

```bash
python3 <installed-skill-dir>/scripts/analyze-audiomap.py public/brand/bgm.mp3 --output audiomap.json
```

`audiomap.json` lands in the **project root**. It is deterministic — same file, same map.

- **Never re-measure the track** with aubiotrack, ffmpeg, another library, or by ear once `audiomap.json` exists. Two beat sources in one project = guaranteed drift arguments. If you suspect the map is wrong, delete it and re-run the one analyzer — don't second-source.
- `energy`, `energy_phases`, `onsets_sec`, `silences`, `key_moments`, `hard_stops`, `rolls` are reliable on **any** music.
- `bpm` and `beats_sec` are reliable **only when `rhythmic: true`**. On calm/ambient music the beat tracker still emits a grid — but it's a metronome the tracker imposed, not something a viewer hears. Cutting to it reads as random.

## Law 2: Read `rhythmic`, then pick the pacing mode

The analyzer writes an explicit verdict — `rhythmic: true|false` — plus its evidence (`rhythm.beat_cv`, `rhythm.beat_onset_support`, `rhythm.onset_rate`, `rhythm.reason`). Do not overrule it by vibes.

### `rhythmic: true` → snap to the beat grid

- Every scene transition start frame = `round(beats_sec[i] * fps)` for some real beat `i`. Prefer `downbeats_sec` for act boundaries (the big cuts land on bar lines, minor vignette cuts may take any beat).
- The first cut is never before `beats_sec[0]` — tracks often fade in; a cut in the pre-beat limbo feels early.
- **The grid times CUTS, never a visible pulse.** Continuous downbeat scale/brightness throb on the frame (`1 + beatHit * k`) is BANNED — user verdict 2026-07-04: "心跳的那种动效 以后别用" (see taste.md heartbeat ban). Delete the orchestrator's legacy MainVideo pulse wrapper on sight; `src/generated/beat-map.ts` survives only as the cut-timing carrier. If `beatMap.bpm` differs from `audiomap.bpm` by more than 2%, rewrite the beat-map constants from audiomap values (`bpm`, `firstBeatSec = beats_sec[0]`) — never the other way around.

### `rhythmic: false` → breathe with energy and silence

Hard-cutting to `beats_sec` is **forbidden** in this mode. Instead:

- **Transitions land on `energy_phases` boundaries** — a level change (LOW→HIGH, HIGH→MEDIUM) is the musical event a viewer actually feels. Longer crossfades (12–20f) over hard cuts.
- **`silences` windows are breathing frames**: hold a still composition, let text settle, no entrances mid-silence. The tail silence is where the CTA lockup rests — don't animate into a fading-out track.
- **`key_moments` SURGEs** are the only acceptable "hit" points for an emphatic entrance; DROPs are where you pull elements back.

## Law 3: Motion accents read the energy map (both modes)

- **hold-then-snap** (rules/motion.md): time the *snap* to a `key_moments` SURGE or, in rhythmic mode, to a downbeat inside the scene's span. The hold occupies the low-energy run before it.
- A `rolls` entry (localized onset burst) is a cascade cue: per-character stagger, card cascade, counter run — the continuous visual belongs inside the roll's `[start, end]`, resolving at its end.
- `hard_stops` are smash-cut licenses: an instant visual change at that timestamp is *earned*; anywhere else it needs a transition.
- Scene density should respect phase `density`: don't stack three entrances inside a `sparse` phase, don't leave a `dense` phase visually static.

## Degraded mode (analyzer fell back to aubiotrack)

If `source: "aubiotrack-fallback"`, the map carries only `bpm` + `beats_sec`; every other field is `null` and `rhythmic` is `false`. Treat the grid as **untrusted**: use Law 2's non-rhythmic pacing on scene-length intuition (equal-breath acts, generous crossfades), use `bpm` only for pulse period, and say so in Step 8's honest disclosure ("beat grid degraded — transitions not energy-verified").

## Verification — evidence, never grep

Per `qc-gates.md`'s hard rule: no static source checks that pretend to verify timing. A regex on `MainVideo.tsx` cannot hear music. Verify with numbers and pixels:

1. **Numeric check (facts, not source patterns):** list your actual cut frames (from the composition's sequencing math or Remotion Studio timeline), convert to seconds, and diff against the chosen anchors — `beats_sec`/`downbeats_sec` (rhythmic) or `energy_phases[].start`/`silences` (non-rhythmic). Every cut must sit within ±1 frame of its anchor. Write the table (cut → anchor → delta) into `evidence/act-evidence.md`.
2. **Pixel check:** render a still at each transition frame and at `transition_frame + 3f`, Read both — the change must actually be visible where the anchor says it is.
3. **Ear check at delivery:** after render, scrub the MP4 at the two strongest `key_moments` and confirm picture and hit coincide; anything not checked by ear goes in the "What I did NOT verify" section.
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall