Communitygithub.com

CleanExpo/Pi-Dev-Ops

Remotion 組合的視覺設計專家。設定排版網格、字型階層、留白、場景框架與視覺節奏。在「remotion-composition-builder」之後觸發,或在新組合類型建立時使用。產出佈局規格供「remotion-composition-builder」使用。

Pi-Dev-Ops 是什麼?

此技能專精於 Remotion 組合的視覺設計,聚焦於「外觀」而非文案、動態或建構。它由 remotion-orchestrator 在草案組合達到第 3 波時觸發,也可在新組合類型建立或渲染失敗需要設計審查時啟用。技能會讀取品牌設計系統(BrandConfig 與 design.md)中的視覺標記,並依序套用 12 欄網格、字型階層、顏色應用、元件槽位、留白及 Logo 放置等規則。所有數值皆以設計標記名稱(如 {spacing.outer-margin-landscape})表示,而非寫死像素值。輸出包含一份佈局規格 JSON 檔案,並對組合的 TSX 進行內嵌編輯。此外,技能會透過 lint 命令驗證所有使用的標記都存在於品牌的 design.md 中,並強制執行一個基於五個正交維度(哲學一致性、視覺階層、細節執行、功能性、創新性)的 5-D 評論關卡,分數需達特定門檻才算通過。此技能適用於 Claude Code、Cursor 等 AI 代理工具,尤其適合處理需要嚴謹品牌跟隨與高品質視覺輸出的媒體製作流程。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CleanExpo/Pi-Dev-Ops/tree/HEAD/skills/remotion-designer

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

remotion-designer

主掌外觀。不是文字(由 storyteller 負責),不是動態(由 motion 負責),不是建構(由 composition-builder 負責)——就是外觀。

觸發時機

  • remotion-orchestrator 在草案組合達到第 3 波時觸發。
  • 正在撰寫新的組合類型(例如 v1.1+ 的 Intro、SocialAd 等)。
  • 渲染失敗,需進行設計審查(偏離品牌、難以辨識、過於擁擠)。

輸入

  • brandSlug ——用於讀取 BrandConfig(執行階段,透過 brands[slug])以及 {slug}.design.md(視覺標記,透過 loadDesign(slug))
  • compositionId —— Explainer | Intro | SocialAd | …
  • aspectRatio —— 1920x1080 | 1080x1920 | 1080x1080
  • storyboard(選用)——用於調整文字區塊大小
  • 現有組合檔案(若是在審查現有組合)

方法

依序套用以下規則。每當某個值來自品牌的設計系統時,請以 design.md 標記的名稱來參照(例如 {spacing.outer-margin-landscape}、{typography.display-xl}、{colors.primary}),而不是直接寫出像素值——remotion-composition-builder 會在構建時解析。

  1. 網格 ——12 欄。外邊距:1920×1080 使用 {spacing.outer-margin-landscape},1080×1920 使用 {spacing.outer-margin-portrait}。安全區域:{spacing.safe-area}(預設為 5%)。
  2. 字型階層 ——從品牌的 design.md 字型比例尺中選取。角色對應到比例尺的階層:
    • 標題 / CTA 英雄區 → {typography.display-xl}
    • 主體標題 → {typography.display-md} 或 {typography.headline}
    • 主體文字 → {typography.body-lg} 或 {typography.body-md}
    • 說明文 / 小標 → {typography.caption}
    • 程式碼 / 識別標籤 → {typography.mono-md} 或 {typography.mono-lg}(若有定義)
  3. 顏色應用 ——英雄區背景:{colors.primary}。CTA 填充:強調 CTA 使用 {colors.accent},次要 CTA 使用 {colors.secondary}。主體文字:若文字位於已知背景上,選取 on-{role} 標記(例如 {colors.on-primary});否則退一步使用 colour/readableOn() 以確保 WCAG-AA 對比度。
  4. 元件槽位 ——當佈局使用到已識別的元件(CTA、卡片、單色晶片、信號晶片、價格標籤、網路徽章)時,請輸出 {component: cta-primary} 並讓 componentRecipe() 在構建時解析完整設定。若有現成的配方,請勿發明臨時樣式。
  5. 留白 ——每個文字區塊上方與下方至少要有 0.5 × 字型大小 的垂直呼吸空間。
  6. Logo 放置 ——左上角或右下角,切勿置中。安全區域 = BrandConfig.logo.safeAreaPx(保留在 .ts 中,由 motion 強制執行)。

輸出

兩個成品:

  1. 一份佈局規格 JSON,寫入 .research/design/{compositionId}-{brandSlug}.json,其值以 {slug}.design.md 標記的名稱來參照(例如 { "outer-margin": "{spacing.outer-margin-landscape}", "hook-type": "{typography.display-xl}" })——內文不含像素值或十六進制色碼。
  2. 對組合的 TSX 進行內嵌編輯(若是在審查現有組合)。

寫完佈局規格後,請執行 npx --prefix Pi-Dev-Ops/remotion-studio design.md lint Synthex/packages/brand-config/src/brands/{slug}.design.md,以確認佈局中參照的每個標記都存在於品牌的 design.md 中。lint 錯誤會導致封鎖;警告僅供參考。

5-D 評論關卡(輸出佈局規格前強制執行)

此關卡採用自 nexu-io/open-design(Apache-2.0 授權)。透過 opus-adversary 模式生成一個 Opus 4.7 子代理,從五個正交維度對提議的佈局進行評分,每個維度 0-10 分,並附上引用證據。將評分表寫入 .research/design/{compositionId}-{brandSlug}.critique.json,與佈局規格放在一起。

維度

  1. 哲學一致性 ——此佈局是朝著單一方向(例如科技實用性、編輯單色風)發展,還是混合了三種風格?請引用具體元素。
  2. 視覺階層 ——陌生人能否在不被告知的情況下,判斷出閱讀的優先順序(第一/第二/第三)?請引用最大的元素 vs. 最重要的元素。
  3. 細節執行 ——對齊、行距、大尺寸字距、圖像構圖、邊緣情況的間距。請引用具體畫面。
  4. 功能性 ——在目標渠道上是否有效?垂直 9:16 的標題在手機上是否可讀?CTA 是否在安全區域內?請引用畫面編號與尺寸。
  5. 創新性 ——是否存在一個意料之外、但為簡報所賦予的動作出現,還是完全千篇一律?是否存在一個非必要但能鎖定識別度的強調手法?請引用該動作。

分數區間

0-4 損壞 · 5-6 可用 · 7-8 優秀 · 9-10 卓越。請勿分數膨脹——平均分高於 8 分需懷疑;請再次確認。

通過 / 失敗

  • 通過:每個維度 ≥ 6,且平均分 ≥ 7。
  • 失敗:任一維度 ≤ 5,或平均分 < 7。返回 remotion-composition-builder,附上每個維度的「保留/修正/速勝」清單,待修改後重新執行關卡。
  • 覆寫:創辦人可透過明確訊息(「直接發佈」)強制通過。覆寫記錄會寫入 .research/design/{compositionId}-{brandSlug}.critique.json,附上時間戳記與原因。

重複使用模式

使用 opus-adversary 技能——相同的 Opus 4.7 子代理生成方式,相同的引用證據紀律。請勿編寫平行的評論框架。

邊界

  • 切勿覆寫 BrandConfig 的值——請透過 remotion-brand-codify 提出變更建議。
  • 切勿在佈局中使用動畫(不要在懸停時縮放文字)——那是 remotion-motion-language 的範疇。
  • 每個場景最多使用 3 種顏色;第三種顏色僅保留給強調色使用。

交接對象

remotion-composition-builder 會使用這些佈局規格並加以套用。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

CleanExpo/Pi-Dev-Ops

Produce one or many consistent, on-brand faceless marketing videos from a topic: script, ElevenLabs voiceover with timestamps, one styled illustration per beat, ffmpeg stitch to 1080p, optional Unlisted YouTube upload. The look is a named style from styles.md (flat-line, hand-doodle, bold-kinetic, cinematic-photoreal, minimal-corporate, retro-print), so one command yields repeatable output per brand. The automated pipeline; distinct from faceless-video and video-director.

CleanExpo/Pi-Dev-Ops

Produce a faceless YouTube-style video (hand-drawn doodle / simple-illustration channels like Zen, Nick Invest) end-to-end from a single topic. ASKS FACT-vs-STORY mode first (non-fiction educational vs fiction storytelling) and branches the whole run — built to serve multiple clients/channels, not one fixed format. Reverse-engineers a proven reference video's script format, writes a new script in that format, generates an ElevenLabs voiceover with timestamps, creates one styled Artlist (AI Toolkit) image per timestamp, and stitches everything with FFmpeg — fully automated, no human recording. Use when the user says "faceless video", "/faceless-video", "doodle video", "make a YouTube short/long-form in the Zen style", or wants an organic faceless-channel content piece. Composes with video-distribution-strategist (channel/launch) and video-director (when motion/edit polish is wanted instead of stills).

CleanExpo/Pi-Dev-Ops

The 15+ year brand director extension of `brand-guardian` specifically for video — frame-by-frame audit of brand-mark integrity, Gun Metal `#1a1a1a` + Candy Red `#dc143c` consistency, NO AI slop, NO Lucide icons, custom geometric marks ONLY, real logos correctly placed. PASS / FAIL gate before any client-facing video ships. Use after `video-colorist` completes the grade pass.

CleanExpo/Pi-Dev-Ops

The 15+ year Director-of-Photography persona (Roger Deakins / Emmanuel Lubezki / Hoyte van Hoytema-tier) that owns shot composition, lens psychology, motion language, and the decision of which source (Remotion / Hyperframes / stock cinematic) each scene uses. Extends the existing `remotion-designer` + `remotion-motion-language` skills with a frame-by-frame shot-language framework. Use when the user says "cinematography", "shot list", "framing", "DoP", "lens choice", or invoked by `video-director` Phase 2.

CleanExpo/Pi-Dev-Ops

The 15+ year colorist persona (Light Iron / Company 3 / The Mill-tier) that applies per-brand LUT + grade pass to every Unite-Group video. Closes the "raw Remotion render colours" gap — today Remotion outputs whatever colours BrandConfig declares with zero cinematic grade. Use when the user says "colour", "grade", "LUT", "look", "cinematic finish", or invoked by `video-director` Phase 3 (post-production) after `video-sound-designer` mixes audio.

CleanExpo/Pi-Dev-Ops

The Creative Director persona that owns brief intake, composition selection and narrative POV for every Unite-Group video. ENTRY POINT for the Video Agency: use for any video creation brief (explainer, promo, social cut, demo reel, case study, testimonial, client video). Dispatches the full production team: script-writer, cinematographer, editor, sound designer, colorist, brand-guardian.

CleanExpo/Pi-Dev-Ops

The 15+ year platform-native distribution expert (early TikTok creator economy + YouTube algorithm + LinkedIn organic reach + IG Reels native specialist) that owns per-platform aspect ratio + duration cap + caption format + hook density + thumbnail composition. Extends `remotion-marketing-strategist` with platform-native specs locked per BrandConfig. Use when the user says "which platform", "distribution", "channel-fit", "thumbnail", "captions", or invoked by `video-director` Phase 4 (QA + Delivery) for per-platform cuts.

CleanExpo/Pi-Dev-Ops

The 15+ year screenwriter persona (Pixar / Apple keynote / Nike spot tier) that engineers hooks (0-3s), retention beats (7-15s), narrative tension curves, and CTA placement. Extends the existing `remotion-screen-storyteller` skill with a structural framework lifted from Pixar's 22 Rules + Apple keynote architecture. Use when the user says "script", "voiceover", "narration", "hook", "story arc", or invoked by `video-director` Phase 2.

CleanExpo/Pi-Dev-Ops

The 15+ year sound designer persona (Skywalker Sound / Sound Lounge / Audio Network-tier) that mixes ElevenLabs voiceover with music bed, sound effects, ambient texture, and audio polish. Closes the single biggest gap in the existing Remotion pipeline — today voiceover is the ONLY audio; this skill adds music + SFX + mix. Use when the user says "sound design", "audio mix", "music bed", "SFX", "score this", or invoked by `video-director` Phase 3 (post-production).

CleanExpo/Pi-Dev-Ops

Converts a BrandResearch dossier into THREE artifacts — (1) typed BrandConfig TypeScript at Synthex/packages/brand-config/src/brands/{slug}.ts (runtime/behaviour — voice, voiceover, motion, audience, channel, forbiddenWords); (2) spec-conformant {slug}.design.md at Synthex/packages/brand-config/src/brands/{slug}.design.md (visual tokens — colour, typography, spacing, components, layout, elevation); (3) human-readable 9-section .md projection at Pi-Dev-Ops/remotion-studio/src/brands/{slug}.md derived from BOTH. Boundary contract at Pi-Dev-Ops/remotion-studio/src/brands/CONTRACT.md. Triggered after remotion-brand-research, or when the user pastes brand assets and says "codify". PRs are auto-merge:false — a human reviews before merge.

CleanExpo/Pi-Dev-Ops

Researches a portfolio company's visual identity from public sources (homepage, about page, marketing copy, GitHub README) and produces a structured BrandResearch dossier. Triggered when `Synthex/packages/brand-config/src/brands/{slug}.ts` (canonical home per RA-1985 / Synthex SYN-897) is missing, older than 90 days, or the user explicitly says "refresh brand for {brand}". Output feeds remotion-brand-codify.

CleanExpo/Pi-Dev-Ops

Generates a complete, accessible palette (primary, secondary, accent, 4-step neutral, semantic, and dark variant) from one to three hex anchors plus a colour-family classification. Validates WCAG-AA contrast for all text-on-background pairs. Triggered when a BrandConfig has fewer than 5 defined colours or contrast fails.

CleanExpo/Pi-Dev-Ops

Authors or extends a Remotion composition (.tsx) wired to BrandConfig + Storyboard + layout spec + motion. The actual builder skill — runs as a Sonnet-tier worker. Triggered after brand, storyboard, designer, and motion-language outputs are ready. Produces the file under remotion-studio/src/compositions/ and registers it in src/Root.tsx.

CleanExpo/Pi-Dev-Ops

Use when a Remotion video needs creative direction — hook, visual sequence, scene purpose, motion restraint, and CTA direction before render.

CleanExpo/Pi-Dev-Ops

Use when a Remotion video has timing, sync, transition, caption, pacing, or audio-fit risk and needs editing discipline before render.

CleanExpo/Pi-Dev-Ops

Use when /remotion-video needs existing Synthex ElevenLabs, brand-config, Remotion, output storage, Claude, or Hermes integration without adding vendors.

CleanExpo/Pi-Dev-Ops

Tunes a video's format and message for the target channel — LinkedIn, YouTube, Instagram Reel, internal training. Sets aspect ratio, total duration, hook timing, CTA timing, and pacing. Triggered when the brief mentions a specific channel or campaign goal. Output feeds remotion-screen-storyteller and remotion-composition-builder.

CleanExpo/Pi-Dev-Ops

Designs a brand-specific motion vocabulary — easing curves, default scene durations, signature entry/exit, transition frames. Each brand gets one signature move (rise / sweep / pulse / iris / whip) that recurs across compositions to build motion-recognition. Triggered when BrandConfig.motion is empty.

CleanExpo/Pi-Dev-Ops

/remotion-video one-shot Remotion command skill and ENTRY POINT for the Remotion Skills Package. Use for video, explainer, ad, promo, reel, intro, social cut, marketing, training, or launch videos. Reads the brief, classifies intent, enforces one single Synthex ElevenLabs voice, emits a production/wave plan, and dispatches the right sub-skills in topological order. Always invoked first.

CleanExpo/Pi-Dev-Ops

Use when a Remotion video job needs production gates, render evidence, output discipline, and pass/fail validation before it can be called shippable.

相關技能