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/composition.md

View on GitHub
<!--
[INPUT]: 被枪毙首稿的帧证据 (黑底真空+居中小物件), ART-DIRECTION v2 四铁律, hyperframes-caylent 标杆做法, brand-report.json 证据分
[OUTPUT]: Bespoke Composition Law — 五条构图铁律 + 构图级 SLOP BLACKLIST + 素材薄站 playbook; scaffold Atmosphere 原语的使用契约
[POS]: rules/ 的构图层核心; 与 taste.md (元素级反 slop) 互补 — taste 审判"放了什么", composition 审判"怎么占据画面"; 被 SKILL.md Step 4 与 qc-gates.md Gate 2 引用
[PROTOCOL]: 变更时更新此头部,然后检查 AGENTS.md
-->

# Bespoke Composition Law

Why this file exists: a first cut got killed with the verdict **"写死了,每次都是那几个动态"** — every video was the same spring logo + shimmer, card grid, CountUp row, small objects floating dead-center in a pure-black void. The elements passed taste.md; the *compositions* were template reflexes. This file makes composition itself a gated discipline.

The test that governs everything below: **would you send this frame to the person who called your last cut ugly?** If you hesitate, the frame is not done.

---

## Law 1 — Zero Vacuum (零真空法)

**Every frame must sit on an atmosphere base. A bare flat `#000` (or any flat solid) behind floating content = automatic FAIL.**

The atmosphere base is layered depth, not decoration:

- **Volumetric light**: multi-layer radial gradients in `theme.color.primary`, breathing slowly — light has a SOURCE and a direction, not a uniform glow.
- **Grid horizon**: a perspective wireframe floor receding to a horizon line — gives the frame a *ground* and a *world*.
- **Drifting particles**: sparse, slow, deterministic — air, not confetti.
- **Visible grain**: 2-4% film grain kills the sterile digital flatness.

The scaffold ships this as `src/components/Atmosphere.tsx` (`<Atmosphere primary={...} accent={...} />`), wired at MainVideo root by default. **Tune it per act (shift the light source, raise/lower the horizon, thin the particles) — never delete it back to a naked solid.** Minimum bar per frame: at least TWO of {light/fog, texture/grain, horizon/perspective, parallax layers} visibly present.

H.264 warning: keep gradient layers ≥2 stops and add grain — smooth dark gradients on black band badly in compression.

## Law 2 — Full-Bleed Moment (全屏时刻法)

**Every act needs at least one composition that touches the frame edges.** An image, a word, a chart, a world — something must go top-to-bottom or edge-to-edge. The default posture is **overflow the frame**, not shrink to center.

- Box test: draw the bounding box around all foreground content in the act's key frame. Box < 60% of frame area with dead margins on all four sides = the "centered small object black hole" — redesign.
- Overflow is allowed and encouraged: hero images crop at edges, type bleeds off-frame, a terminal rises from the bottom edge and occupies 60% of the canvas, a chart's axis runs out of frame.
- Scale reads as confidence. Small-and-centered reads as a slide deck apologizing for itself.

## Law 3 — Editorial Typography (编辑部字排法)

**Key words earn 200-320px.** Take the brand site's H1 presence and multiply it ×3 — a 72px web headline becomes a 200px+ video moment, because video frames are billboards, not browser viewports.

- One giant word/phrase + one tiny annotation line = the whole composition. The size GAP is the design.
- Bleed is legal: type may crop at the frame edge as long as the word stays readable.
- Weight stays 300-500 (typography.md still rules) — scale delivers the impact, not boldness.
- `theme.fontSize.hero` (default 80) is the floor for act headlines, **not the ceiling**. For the act's ONE editorial moment, go 200-320px and let it own the frame.
- Benchmark: the hyperframes-caylent cut carried whole beats with 118px+ stats and size-driven hierarchy — no beat leaned on a card to feel finished.

## Law 4 — Real Assets First (真资产优先法)

**Brand graphic assets outrank code-drawn abstractions.** A 3D logo render, hero art, illustration system, or product shot beats any hand-built diagram of the same idea.

- If `public/brand/` holds a rendered logo (3D, neon, isometric), typing the same letter in a font is a FAIL — use the asset.
- If the brand ships a visual language (wireframe, isometric, gradient world), **grow the video's world out of it** instead of ignoring it (see Thin-Evidence Playbook below).
- Code mockups (Terminal/Kanban/Dashboard) are for *product UI moments* — they never substitute for a brand's own art when that art exists in the asset pool. Gate 1's asset-audit USE verdicts must be honored here.

## Law 5 — Composition Diversity (构图多样性法)

**The archetype must drive a different composition SYSTEM, not just different colors on the same skeleton.**

- Within one video: no two acts share the same compositional skeleton (`padding + eyebrow + headline + centered box` repeated five times = one composition wearing five costumes).
- Across videos: no scaffold component may be the hero visual of two consecutive productions. If the last video's Act 3 heroed `KanbanBoard`, this one finds another lead. The scaffold is a vocabulary, not a fill-in-the-blanks form.
- Composition systems to actually vary between (pick per act, per archetype):
  - full-bleed image + edge scrim + small type
  - oversized-type stack (Law 3) with annotation
  - horizon-anchored world (object ON the grid floor, not floating)
  - asymmetric offset hero (subject at 1/3, atmosphere fills the rest)
  - split composition with a hard diagonal or vertical seam
  - bottom-rising surface (terminal/panel entering from frame edge, occupying 50-70%)
  - sequenced full-screen singles (one subject per beat, cut between them)

---

## SLOP BLACKLIST — compositional edition

taste.md blacklists elements; this list blacklists whole compositions. Each entry names its replacement — banning without an alternative just breeds the next cliché.

| BANNED | Why it's slop | Use instead |
|---|---|---|
| **Hub-and-spoke pill diagram** (center logo, pill labels around it, thin connector lines) | The textbook AI-generated "integrations" frame; zero depth, zero brand | A **convergence world**: names as large typographic streams / light beams flowing INTO the real logo asset placed off-center in a grid-horizon world with perspective. The logo is a machine doing something, not a sticker with strings |
| **Hollow-card triptych** (three near-empty cards side by side, one icon + two lines each) | Three ways to say nothing; interiors are void; the frame becomes furniture | **Three sequenced full-screen moments** — each metric/claim gets its own beat and fills half the frame or more (a 99.9% at 300px, a failover drawn edge-to-edge, a routing arc as a world map). One subject per beat |
| **Centered small object in a void** (content <35% of frame floating in flat dark) | The "black hole" frame — reads as unfinished placeholder | Law 1 + Law 2: atmosphere base underneath, then scale the subject until it touches an edge, or offset it and let typography/world fill the rest |
| **Eternal spring-logo + shimmer opening** | The same open on every video is a watermark saying "template" | `LogoEntrance` has 7 variants — rotate them (shimmer sweep openers are already banned there). Better: cold-open inside the brand world (hero art full-bleed, logo arrives as an inhabitant with volumetric backlight, not a sticker on black) |
| **CountUp row as the entire proof act** | Numbers ticking in a row = spreadsheet, not evidence | One number per beat, full-screen, treated as architecture (Law 2 + 3); or one real chart drawn edge-to-edge with the number as its peak annotation |

**The composition test** (extends taste.md's slop test): show one FRAME with all text blurred. Could it be any SaaS brand's template? If yes, the composition failed even if every element passed.

---

## Claim→World Mapping — 卖点渲染成它领域的原生 artifact

每个 proof 卖点不画"关于它的图表",而是把观众**放进那个卖点为真的世界**。推导链:卖点 → 它属于哪个领域 → 那个领域的从业者每天看什么 → 把那个东西做成全屏电影级。

Worked example(happy-model, 2026-07-04 — **这是推导方法的示范,不是可复制的答案**):

| 卖点 | 领域 | 从业者看什么 | 渲染成 |
|---|---|---|---|
| 99.9% uptime | 可靠性 | status page | 多区域 90 天心跳条带墙 + 巨数字 count-up(绿海里两粒琥珀瑕疵反衬真实) |
| smart failover | **产品自己的语义**(模型商切换,不是地理) | 请求流向 | 光束射向 provider 官方 mark → 熄灭 flicker+× → 瞬间改射另一家 + `rerouted · 183 ms` 戳 |
| global routing | 地理 | 骨干网 | dotted-map 真地图 + 短跳级联逐城点亮 + `ms` 延迟戳(航线法向侧弓弧) |

**自适应铁律(用户原话:"我不是要每次都是这样!我是要自适应不同的网站风格"):**

- 上表的三个 artifact 是**这一个品牌**的推导结果。下一个品牌的卖点属于不同领域 → 推导出不同的 artifact(电商的"秒发货"→ 物流轨迹世界;协作工具的"实时同步"→ 多光标文档世界;安全产品的"威胁拦截"→ SOC 告警流世界)。照抄 status 墙/骨干网地图给另一个品牌 = 模板化,直接违反 Law 5 跨视频条款。
- 颜色、字体、光的性格全部来自该品牌的 brand-report(designTruth),不继承任何往期项目。
- failover 一行是关键教训:卖点的领域要按**这个产品的真实语义**判断,别被词面带偏("failover"听着像地理,实际是 provider 层)。
- 相邻 beat 必须换世界(status page 世界 → 请求流世界 → 地理世界),两个 beat 共用一套视觉公式(如连续两张"地图+弧线")已被用户点名毙掉。
- **换构图不换世界观(Laper 事故 2026-07-05)**:换世界指的是构图系统与 artifact 换,不是色系与字系换。一部片只有一套底色谱系、一套字体声部、一套光的语言;某一幕突然跳成芥末金或深绿海报 = 世界观断裂,用户判词"不统一、不高级、没有品牌味"。多样性活在构图与 artifact 层,统一性锁死在 theme 层——beat 再怎么换,观众要能从任何一帧认出这是同一部片。

**跨视频测试:** 拿本 skill 产的两个不同品牌的视频各抽一帧并排——如果互换品牌 logo 后毫无违和,自适应失败。

### 数量决定构图(Nora 原话:"三个有三个的排版,四个有四个的排版",2026-07-04)

- 统计/要点的**个数**是构图的输入,不是塞进同一模板的填充量:3 个 = 三分屏或阶梯;4 个 = 一行四列细线分隔(无卡片盒)或 2×2;2 个 = 对比构图(长短条/左右对峙)。个数变了,排版必须重新设计。
- 奇数落单是死罪:2+1 换行的孤儿卡片 = 不高级。宁可加一个真实指标凑满一行,或换构图。
- 无框统计行 > 卡片盒:mono 小标签 + 编辑部大数字 + mint 趋势行,细线分隔——比圆角卡片高一档。
- 对比类卖点(−40% MTTR 这种"少即是好")用**对比条**:基线长条(暗) vs 现状短条(亮),差距本身就是画面;禁孤立下坠弧线/仪表针这类"指代型"图形。
- 动效要"有物":纯 SplitText + 空底 = 不高级。每个快拍配一个领域原生 artifact(GenAI → token 流光标 + 漂浮配置碎片;Ops → 终端日志逐行上屏)。

The failure this kills: a thin site (logo + palette + one headline, no product shots) degrades into empty cards and centered logos — the void frames above. Thin evidence does NOT mean thin visuals; it means the video must **grow a brand world from the assets that do exist**.

1. **Interrogate the logo geometry.** Wireframe? Isometric? Letterform? Orbit? That geometry is the world seed. Field example: an isometric wireframe "M" logo → a *relay-station world* — isometric grid horizon, data beams from off-frame converging through the 3D logo, terminals rising from the floor. One logo carried five acts.
2. **Build the world once, evolve it per act.** Atmosphere base tinted by brand primary + ONE spatial motif derived from the logo (grid / orbit / circuit / weave / lattice). Acts move THROUGH the world (light shifts, camera reframes, density grows) instead of resetting to a fresh void each cut.
3. **Typography becomes co-lead.** With no product screenshots, Law 3 editorial moments (200-320px key words) carry the acts that would otherwise beg for a mockup.
4. **Cards are forbidden as filler.** Cards need real content; thin evidence has none. Type + world + real assets only.
5. **Never fake product UI** the evidence can't support (workflow.md mode rule) — and disclose the editorial mode in Gate 4 (what was synthesized from brand geometry vs. what was harvested).

---

## Gate wiring

- **Step 4 (build):** read this file BEFORE composing any act. Each act's design states which composition system (Law 5 menu) it uses.
- **Gate 2 (per-act frame evidence):** the evidence block includes a four-law self-check line (vacuum? full-bleed moment? type scale? real asset?) — judged on the rendered still, with the send-it-to-your-harshest-critic bar.
- **Finish gate:** "same composition skeleton as my last video" is a reflex default to name and reject.
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