Files
hyperframes/skills/hyperframes-creative/frame-presets/blue-professional/FRAME.md
T
WaterrrForeverandClaude Opus 4.8 d0f0ec29e7 feat(skills): frame-preset library + shared audio engine (foundation) (#1632)
* feat(hyperframes-creative): add frame-preset library

Add a library of ready-made visual frame presets (claude, biennale-yellow,
blockframe, blue-professional, bold-poster, broadside, capsule, cartesian,
cobalt-grid, coral, creative-mode, daisy-days, editorial-forest, …), each with
a FRAME.md spec, a frame-showcase.html, and a per-preset caption-skin.html.
Registered in the creative design-spec so workflows can remix a preset onto
brand tokens.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* feat(hyperframes-media): shared TTS/BGM/SFX audio engine

Add a shared audio engine under hyperframes-media (scripts/audio.mjs + lib/
tts.mjs, bgm.mjs, sfx.mjs, heygen.mjs) plus a bundled SFX pack and manifest.
Workflows resolve this engine by path (../../hyperframes-media/scripts/
audio.mjs) for text-to-speech, background music, and sound effects, so audio
is authored once and reused across skills instead of duplicated per workflow.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* feat(skills): gate render on user review; refresh router, core, general-video

- hyperframes-cli: render is now user-gated — preview opens Studio (the timeline
  editor where the user can hand-edit anything, not just watch); never
  auto-render once checks pass, pause at preview and render only after approval.
- hyperframes (router): tighten the entry SKILL.md description + routing.
- hyperframes-core: rewrite SKILL.md and add script-format.md + storyboard-format.md
  references for the script-driven authoring architecture.
- general-video: tidy the fallback-workflow description and routing table.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* style(hyperframes-creative): reformat frame-preset showcase HTML

Run the HTML formatter over the frame-showcase.html files (indentation,
self-closing void tags, one CSS declaration per line). Formatting only — no
content or markup changes.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* fix(hyperframes-media): correct wait-bgm field mapping and guard credential parse

Two correctness fixes from review (#1632):

- wait-bgm.mjs read audioMeta.bgm_path / audioMeta.bgm_enabled, but audio.mjs
  writes the path nested as bgm.path and the flag as bgm_pending. The detached
  generate path (Lyria/MusicGen) therefore always saw an empty path and exited
  status: disabled, silently dropping the music track even while generation was
  running. Read audioMeta.bgm?.path and gate on bgm_pending.
- heygenCredential() had an unguarded JSON.parse despite documenting that it
  never throws — a malformed ~/.heygen credentials file crashed the engine at
  startup instead of degrading to no-credential. Wrap the parse and return null.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* chore(hyperframes): add router tag to entry skill metadata

Fold the router metadata tag into the foundation rewrite of the entry SKILL.md.
This file is owned by this PR (the full router rewrite); keeping the tag tweak
here — instead of a separate edit on the pre-rewrite version in another PR —
avoids a guaranteed merge conflict between the two.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-22 22:49:10 +08:00

17 KiB
Raw Blame History


version: alpha name: Blue Professional — Frame (video / frame layer) description: > Video-first companion to Blue Professional's design.md. The unit is the frame (1920×1080). Atoms are identical and sacred — the warm cream canvas, a single saturated cobalt (#1e2bfa) as the only accent, the three-step gray text ladder, Space Grotesk (display/numerals/chrome) + Inter (body), soft cobalt-tinted cards (4% fill / 20% border / 1014px radius) with NO shadows, pill chrome, and the cobalt progress bar. Composition + frame scale rewritten. Motion out of scope. unit: the frame — 1920×1080 primary; 9:16 and 1:1 documented principle: atoms are sacred · composition is free · numbers come from the script

colors: bg: "#fdfae7" primary: "#1e2bfa" text: "#111111" text-muted: "#6b6b6b" text-light: "#9a9a9a" accent-light: "rgba(30,43,250,0.08)" accent-medium: "rgba(30,43,250,0.15)" border: "rgba(30,43,250,0.2)" card-bg: "rgba(30,43,250,0.04)" positive: "#059669" negative: "#dc2626"

radii: pill: "100px" card-lg: "14px" card-md: "12px" card-sm: "10px" bar: "6px" circle: "50%"

typography:

— reading ramp (Inter body + Space Grotesk chrome) —

body: { fontFamily: "Inter", cqw: 0.85, weight: 400, lineHeight: 1.6, color: "text-muted" } h4-eyebrow:{ fontFamily: "Space Grotesk", cqw: 0.8, weight: 600, tracking: "0.08em", upper: true, color: "primary" } tag: { fontFamily: "Space Grotesk", px: 12, weight: 500, color: "primary" } counter: { fontFamily: "Space Grotesk", px: 13, weight: 500, tracking: "0.05em", color: "text-muted" }

— display / numerical ramp (Space Grotesk, near-black headings / cobalt numerals) —

h3: { fontFamily: "Space Grotesk", cqw: 1.25, weight: 500, lineHeight: 1.3, tracking: "-0.02em", color: "text" } stat-num:{ fontFamily: "Space Grotesk", cqw: 1.9, weight: 700, lineHeight: 1.0, color: "primary" } blockquote:{ fontFamily: "Space Grotesk", cqw: 2.4, weight: 500, lineHeight: 1.35, color: "text" } h2: { fontFamily: "Space Grotesk", cqw: 2.6, weight: 600, lineHeight: 1.1, tracking: "-0.02em", color: "text" } metric-value:{ fontFamily: "Space Grotesk", cqw: 3.0, weight: 700, lineHeight: 1.0, color: "primary" } h1: { fontFamily: "Space Grotesk", cqw: 4.2, weight: 700, lineHeight: 1.08, tracking: "-0.02em", color: "text" } quote-mark:{ fontFamily: "Space Grotesk", cqw: 8.0, weight: 700, lineHeight: 0.5, color: "primary", opacity: 0.15 }

spacing: pad-x: "5cqw" pad-y-top: "5cqw" gap-cards: "1.4cqw" accent-line: "60px × 4px"

components: card-tinted: backgroundColor: "{colors.card-bg}" border: "1.5px solid {colors.border}" rounded: "{radii.card-lg}" shadow: "none" description: "Universal content card. Never solid-colored, never opaque-bordered, NO shadow." metric-card: backgroundColor: "{colors.card-bg}" border: "1.5px solid {colors.border}" rounded: "{radii.card-lg}" typography: "{typography.metric-value} ({colors.primary}) + {typography.metric-label} + {typography.metric-desc}" description: "+ optional inline ↑/↓ change chip ({colors.positive}/{colors.negative} text, no fill)." tag-pill: backgroundColor: "{colors.accent-light}" textColor: "{colors.primary}" rounded: "{radii.pill}" typography: "{typography.tag}" description: "Top-right of the slide-header." cta-button: backgroundColor: "{colors.primary}" textColor: "{colors.bg}" rounded: "{radii.pill}" typography: "Space Grotesk 600" shadow: "soft cobalt on hover only — the system's only shadow" description: "The one solid element." accent-line: backgroundColor: "{colors.primary}" size: "60×4, 2px radius" description: "Above cover titles / eyebrow separators." bar-track: backgroundColor: "{colors.accent-light}" fill: "{colors.primary} (display:block so width resolves)" rounded: "{radii.bar}" description: "28px track; fill carries the value." step-circle: backgroundColor: "{colors.primary}" textColor: "{colors.bg}" rounded: "50%" size: "56px" description: "Sequential steps fade opacity 1.0→0.85→0.7→0.55." split-highlight: backgroundColor: "{colors.accent-light}" borderLeft: "4px solid {colors.primary}" rounded: "{radii.card-md}" description: "Inline pull-quote callout." slide-header: typography: "{typography.h4-eyebrow} (cobalt) left, tag-pill right; {typography.h2} below" description: "Top band of every content frame." atmosphere: elements: "clipped diagonal cobalt-tint panel, 3×3 cobalt dot grid, concentric closing rings" description: "Cover/closing only. Never on content frames." progress-bar: backgroundColor: "{colors.primary}" size: "3px tall, bottom edge, width grows with index" description: "Persistent progress strip."

Blue Professional — Frame (video / frame layer)

Overview

Blue Professional at frame scale is a consulting-grade system: restraint with one strong commitment. A warm cream canvas and a single saturated cobalt that carries every accent — eyebrow, metric, CTA, chart fill, progress bar. No secondary brand color, no pastels, just cream, cobalt, and a tight ladder of grays. The register is investment-research / McKinsey briefing: measured, data-dense without crowding, executive-readable at distance.

The voice is two faces in fixed roles: Space Grotesk (display, every numeral, all chrome — eyebrows uppercase 0.08em) and Inter (body, muted gray, line 1.6). Headlines are near-black; cobalt is reserved for accent moments. Depth is soft and tinted — 4% cobalt card fills with 20% cobalt borders and 1014px radii — never shadowed. The lack of harsh shadows is the premium signal.

Key characteristics at frame scale:

  • Warm cream ground on every frame; single cobalt as the only accent.
  • Space Grotesk (display/numerals/chrome) + Inter (body) — near-black headlines, cobalt numerals.
  • Tinted cards — cobalt 4% fill, cobalt 20% 1.5px border, 1014px radius, no shadow.
  • Pill chrome (100px) — tag pills + the one solid cobalt CTA; cobalt progress bar.
  • Soft rounded corners everywhere (no square corners save the progress bar).
  • Atmosphere (diagonal panel, dot grid, concentric rings) on cover/closing only.

The Frame

Frame Craft Bar

Three eyeball tests gate every frame before any structural check:

  • Squint — one near-black headline or cobalt numeral dominates at 36× its neighbor.

  • Silence — content frames read balanced, not crowded; the dashboard is the one dense exception.

  • Restraint — a single cobalt accent carries everything; headlines stay near-black (never cobalt); no shadows (tinted cards do the lift); positive/negative inline-text only.

  • Reference — aim at an investment-research / McKinsey quarterly briefing; failure looks like a heavy-outlined, multi-color dashboard.

  • Primary: 1920×1080 (16:9). Display authored in cqw (px ÷ 1920 × 100 = cqw).

  • Vertical: 1080×1920 (9:16). Square: 1080×1080 (1:1).

  • Safe area: pad-x 5cqw; bottom reserves room for the counter + progress bar.

The container law (load-bearing). Every frame ground sets container-type: size; ALL frame-relative units are cqw/cqh against it — never vw. Card radii stay px (1014px); the pill radius stays 100px; borders stay 11.5px.

Colors

Tokens identical to the source. {colors.bg} cream is the universal ground; {colors.primary} cobalt is the only accent — every eyebrow, numeral, CTA, chart fill, progress bar, and the 4px highlight left-rule. Headlines are {colors.text} near-black (never cobalt); body is {colors.text-muted}; tertiary is {colors.text-light}. Cards fill {colors.card-bg} (4%) with {colors.border} (20%) borders. {colors.positive}/{colors.negative} appear only inline on directional change chips — never as fills. No second accent color.

Typography

Two ramps. The reading ramp (Inter body 0.85cqw muted; Space Grotesk eyebrow uppercase 0.08em cobalt) carries copy + chrome; the display/numerical ramp (Space Grotesk h3 1.25cqw → h1 4.2cqw near-black; numerals stat-num/metric-value in cobalt) carries headings and figures.

  • Legibility floor: any load-bearing line ≥ 1.4cqw; px chrome (tag/counter) is colophon only.
  • Fit-to-measure: size the headline to its length. Cap the block at ≤ 78cqw; ≤3 words → h1; 46 → h2; 7+ → h3. Cobalt numerals scale metric-valuestat-num by card size.
  • Headlines near-black, 0.02em; eyebrows cobalt, uppercase, 0.08em; numerals cobalt 600700; body Inter 400 muted, line 1.6. No italic, no uppercase body, no cobalt headline.

Depth & Surface

Soft and tinted — never offset. Depth from:

  • Tinted cards — 4% cobalt fill + 20% cobalt 1.5px border + 1014px radius reads as lifted without offset.
  • Border-left accent — the 4px cobalt rule on split-highlight blocks pulls a callout forward.
  • Rounded corners — the 1014px radius is part of the softness; square corners break it.

Ceiling: zero box-shadow on content (the only shadow is a soft cobalt CTA hover); no opaque cobalt borders; no harsh outlines.

Shapes

  • 100px — tag pills, CTA, nav buttons (pill chrome).
  • 14/12/10px — cards by size (large metric / standard stat / detail + mini).
  • 6px — bar tracks + fills. 50% — step circles, nav circles, dots, closing rings.
  • 0 — only the progress bar. No square-cornered content.

Components

  • card-tinted / metric-card — the universal soft-tint content cards (no shadow).
  • tag-pill / cta-button / accent-line — the cobalt pill chrome + the one solid CTA + the 60×4 rule.
  • bar-track / step-circle / split-highlight — cobalt data + sequence + callout patterns.
  • slide-header (eyebrow + tag pill) — the structural rhythm; atmosphere (diagonal/dots/rings) on cover/closing only; progress-bar on every frame.

Frame Treatments

Recipe: ground · container · composes · focal · chrome · accent · silence · Fixed/Free · density. Atmosphere only on cover/closing; content frames carry the slide-header rhythm.

1 · Cover (identity · move: diagonal accent · left)

Ground cream + the clipped diagonal cobalt-tint panel (right ~36%) + a 3×3 cobalt dot grid. Composes accent-line, meta, h1, body sub. Focal a 2-line Space Grotesk h1 near-black, left, under a cobalt accent-line + meta. Chrome counter + progress bar. Accent the cobalt line + diagonal panel. Silence the diagonal panel holds the right third. Fixed near-black h1, cobalt accents, atmosphere here only. Free title, meta. Density low.

2 · Dashboard (data · move: 3-up metric grid · the dense frame)

Ground cream, pad-x. Composes slide-header (eyebrow + tag-pill), h2, 3× metric/tinted card. Focal a row of tinted cards — cobalt metric-value + Inter label + muted desc + optional green/red change chip. Chrome eyebrow left, tag-pill right; progress bar. Accent the cobalt numerals. Silence tight — the density exception. Fixed 4% tint cards, 20% borders, no shadow, cobalt numerals. Free figures (from script), labels. Density dense-exception.

3 · Bar Ranking (data · move: cobalt bars · left)

Ground cream, pad-x. Composes eyebrow, h2, bar-track rows. Focal 35 labeled cobalt-fill bars on cobalt-8% tracks with cobalt percentages. Chrome eyebrow; progress bar. Accent the cobalt fills + figures. Silence moderate. Fixed 6px tracks, cobalt fills. Free rows, values (from script). Density standard.

4 · Pull Quote (quote · move: concentric rings · centered)

Ground cream, centered, with faint concentric closing-rings behind. Composes quote-mark, blockquote, cite. Focal a Space Grotesk blockquote near-black under a 15%-opacity cobalt quote-mark; an uppercase cobalt-muted cite beneath. Accent the faint rings + quote-mark. Silence ~55%. Fixed near-black quote, soft rings. Free quote, cite. Density low.

5 · Split + Highlight (content · move: asymmetric split · left)

Ground cream, two columns. Composes eyebrow, h2, body, split-highlight block. Focal an Inter body column beside a cobalt-8% highlight block (4px cobalt left rule) carrying an inline pull quote. Accent the highlight's left rule. Silence generous gutter. Fixed tinted highlight, 4px cobalt rule. Free body, callout. Density standard.

6 · Closing / CTA (closer · move: centered rings + CTA)

Ground cream + concentric closing-rings. Composes accent-line, h1, body, cta-button. Focal a Space Grotesk h1 near-black, centered, with the one solid cobalt cta-button pill below. Accent the CTA + rings. Silence ~60%. Fixed one CTA, near-black h1, soft rings. Free sign-off, CTA label. Density low.

Composition Rules

Do

  • Start every frame on warm cream; let cobalt carry every accent (eyebrow, numeral, CTA, bar, progress).
  • Set headlines near-black, 0.02em; eyebrows cobalt uppercase 0.08em; numerals cobalt 600700.
  • Use tinted cards (4% fill, 20% border, 1014px radius, no shadow); body Inter 400 muted, line 1.6.
  • Keep all chrome pill-shaped (100px); one solid cobalt CTA per closing frame.
  • Reserve atmosphere (diagonal panel, dots, rings) for cover/closing; content frames keep the slide-header rhythm.
  • Lean left on cover/dashboard/split, centered on quote/closer.

Don't

  • No second accent color; no cobalt headlines.
  • No drop shadows on content (only the soft cobalt CTA hover); no opaque cobalt borders.
  • No square corners (save the progress bar); no font substitutes; no uppercase body.
  • Don't use the green/red change chips as general accents — directional comparisons only.
  • Don't fill space with heavier borders — add substance; don't blow a headline edge-to-edge.

Aspect-Ratio Behavior

Treatment 16:9 9:16 1:1
Cover title left, diagonal right title top, diagonal band below title upper, dots corner
Dashboard 3 cards across 3 stacked 2×2
Bar Ranking 35 bars 35 bars (tighter) 3 bars
Pull Quote centered, rings behind centered, taller centered
Split + Highlight side-by-side stacked stacked
Closing / CTA centered + CTA centered + CTA centered + CTA

pad-x holds on the short edge; re-step display above the 1.4cqw floor. The diagonal cover panel becomes a top/bottom band on 9:16. Numerals stay Latin Arabic digits in CJK builds.

Approved Entities

No real customers, logos, or vendors are defined in the source — render any such mark as a placeholder. Figures, metrics, and quotes are content; the system supplies cream + cobalt + grays.

Numerals & Claims (hard rule)

Never invent figures, financials, percentages, or dates at frame scale. Render slots as — figure —, {metric}, +NN%, ↑ —. Metric cards, bar values, and stat cells especially carry placeholders until the script supplies them. Directional chips require a real comparison from the script.

Pre-Render Self-Audit

  • Squint — one near-black headline or cobalt numeral dominates per frame.
  • Silence — content frames balanced, not crowded; only the dashboard runs dense.
  • Single accent — cobalt only; headlines near-black; positive/negative inline only.
  • Type — Space Grotesk headings 0.02em near-black, cobalt eyebrows 0.08em + numerals; Inter body muted line 1.6; ≥1.4cqw floor.
  • Depth — tinted cards (no shadow), soft rounded corners, 20% cobalt borders; no square content corners.
  • Anchor — left on cover/dashboard/split, centered on quote/closer; atmosphere on cover/closing only.
  • Fabrication — every numeral traces to the script, else placeholder.

Known Gaps

  • Motion intentionally out of scope. frame.md specifies composition only; the source's 500ms translateX transitions + bar-fill animations are deck mechanics.
  • Space Grotesk + Inter via Google Fonts. CJK pairing (Noto Sans SC 700 display / Noto Serif SC 400 body) carries over; the eyebrow's uppercase+tracking signal weakens in CJK — pair it with the accent-line.
  • 9:16 / 1:1 are guidance; verify the floor and that the diagonal panel reflows to a band.
  • Diagonal panel (clip-path), dot grid, concentric rings, and bars are CSS-only; no external imagery is required.