Communitygithub.com

CleanExpo/Pi-Dev-Ops

Remotion 컴포지션(.tsx) 파일을 작성하거나 수정하며, BrandConfig, 스토리보드, 레이아웃 스펙, 모션 사양을 통합합니다. 실제 빌더 스킬로, Sonnet 등급 워커로 실행됩니다. 브랜드, 스토리보드, 디자이너, 모션 언어 출력물이 준비된 후 트리거됩니다. 생성된 파일은 remotion-studio/src/compositions/에 저장되고 src/Root.tsx에 등록됩니다.

Pi-Dev-Ops란 무엇인가요?

이 스킬은 Remotion 스튜디오에서 동영상 컴포지션을 실제로 생성하는 빌더 역할을 합니다. 브랜드 설정(BrandConfig), 디자인 토큰(design.md), 스토리보드 JSON, 레이아웃 명세, 모션 블록 등 이전 단계에서 생성된 모든 출력물을 입력으로 받아 하나의 완전한 Remotion 컴포지션 TSX 파일로 조립합니다. Claude Code, Cursor, Codex 등의 AI 에이전트 플랫폼에서 사용하도록 설계되었으며, 특히 'remotion-orchestrator' 워크플로우의 4단계에서 트리거됩니다. 이 스킬은 기존 컴포지션을 패치하거나 Explainer.tsx 템플릿을 기반으로 새 파일을 만들고, ZOD 스키마로 입력 props를 정의하며, 각 스토리보드 장면을 Sequence로 구성하고, 오디오 트랙을 연결하며, 최종 컴포지션을 src/Root.tsx에 등록합니다. 모든 브랜드 값은 토큰 시스템을 통해 참조되며, 인라인 하드코딩을 금지하고, 빌드 시 타입 검사를 수행하여 안정성을 보장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CleanExpo/Pi-Dev-Ops/tree/HEAD/skills/remotion-composition-builder

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

remotion-composition-builder

실제 작업을 수행합니다. 다른 모든 것을 읽고 TSX를 작성합니다.

트리거

  • remotion-orchestrator 계획의 4단계(Wave 4)
  • 사용자가 브랜드와 스토리보드가 이미 알려진 상태에서 "{주제}에 대한 컴포지션 빌드"를 요청할 때

입력

동일한 작업의 이전 스킬 출력물에서 모두 가져옵니다:

  • BrandConfig (src/brands/{slug}.ts에서) — 런타임 및 동작: voice, voiceover, motion, audience, channel, forbiddenWords
  • {slug}.design.md (src/brands/loadDesign.ts에서 loadDesign(slug)로 로드) — 시각적 토큰: 색상, 타이포그래피, 간격, 구성 요소, 레이아웃, elevation
  • 스토리보드 JSON (remotion-screen-storyteller에서)
  • 레이아웃 명세 (remotion-designer에서) — 이름으로 design.md 토큰 참조
  • 모션 블록 (BrandConfig의 일부)
  • 채널 명세 / 종횡비 (remotion-marketing-strategist에서)

BrandConfig와 design.md 간의 전체 소유권 경계는 src/brands/CONTRACT.md를 참조하세요.

방법

  1. 컴포지션 찾기 — src/compositions/{Name}.tsx가 존재하는가?
    • 예 → 그 자리에서 패치 (기존 API 유지).
    • 아니요 → Explainer.tsx를 템플릿으로 사용하여 새 파일 생성.
  2. 임포트 연결 — 런타임용 import { brands } from '../brands', 시각적 토큰용 import { loadDesign, colour, spacing, componentRecipe, typography } from '../design', 모션 헬퍼용 ../motion.
  3. 스키마 정의 — 스토리보드 형태와 일치하는 입력 props에 대한 z.object.
  4. 장면 구성 — 스토리보드 장면당 하나의 <Sequence>. 각 장면 구성 요소는 cfg = brands[props.brand] (motion/voice/voiceover용) 및 tokens = loadDesign(props.brand) (색상/타이포그래피/간격/구성 요소 레시피용)를 읽고 조합합니다. hex를 인라인으로 사용하는 대신 componentRecipe(tokens, 'cta-primary')를 사용하여 완전히 해석된 CSS 준비 객체를 얻습니다.
  5. 오디오 — 경로가 설정된 경우 장면당 <Audio src={staticFile(scene.voiceoverAudioPath)} /> 연결.
  6. Root에 등록 — src/Root.tsx에 <Composition id="{Name}" ... /> 추가 또는 업데이트. durationInFrames = sum(scene.durationSec) * fps.
  7. 파일 위생 — 컴포지션 파일 500줄 이하. 그 이상 커지면 장면을 src/compositions/{Name}/scenes/*.tsx로 추출.
  8. 타입 검사 — npx tsc --noEmit 실행. 오류 시 수정 후 한 번 재시도.

출력

수정된 파일:

  • src/compositions/{Name}.tsx (또는 장면 하위 파일)
  • src/Root.tsx (등록 항목)

remotion-orchestrator에 상태 보고:

{ "composition": "Explainer", "filesChanged": [...], "tscPassed": true, "ready": true }

경계

  • 브랜드 값(hex 코드, 글꼴 이름, 간격 리터럴)을 절대 인라인으로 사용하지 말 것 — 항상 tokens(시각적) 또는 cfg(런타임)에서 읽어야 함. 각 항목의 소유권은 CONTRACT.md 참조.
  • durationInFrames를 스토리보드 장면 길이 × fps를 합산하지 않고 설정하지 말 것.
  • 존재하지 않는 에셋 경로에 대해 staticFile()을 호출하지 말 것 — 빌드 시 명확하게 실패하고, 렌더링 시 조용히 넘어가지 않도록.
  • 진입 모션을 위해 signatureEntry()를 우회하지 말 것 — 모션 언어의 일관성 유지.
  • BrandConfig.ts와 {slug}.design.md 간에 토큰을 중복하지 말 것. 값이 .design.md에 있으면 .ts에서 다시 선언하지 않아야 함.

재사용

다음으로 넘김

실제 렌더링을 위해 remotion-render-pipeline으로 전달.

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

Visual-design specialist for Remotion compositions. Sets layout grid, typography hierarchy, white-space, scene framing, and visual rhythm for a given composition + brand. Triggered after remotion-composition-builder for QA, or upfront when authoring a new composition type. Produces a layout spec consumed by remotion-composition-builder.

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.

관련 스킬