Communitygithub.com

CleanExpo/Pi-Dev-Ops

비디오의 온스크립트를 장면별로 작성합니다 — 내레이션, 화면 텍스트, B-롤 콜아웃, CTA를 포함합니다. 목표나 주제는 있지만 장면 구조가 없는 브리프가 주어질 때 트리거됩니다. remotion-composition-builder와 remotion-render-pipeline(ElevenLabs 음성 합성용)이 사용할 스토리보드 JSON을 생성합니다.

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

이 스킬은 비디오 대본 작성을 자동화하여, 브리프(목표/주제)를 받으면 장면별 내레이션, 화면 텍스트, B-롤 지시사항, 행동 유도(CTA)로 구성된 완전한 스토리보드 JSON을 출력합니다. 기본적으로 3막 구조(훅, 본문, CTA)와 브랜드 음성 제약(금칙어, 문장 길이 제한)을 적용하므로 Pi-CEO, CCW 등 다양한 브랜드 톤에 맞출 수 있습니다. Cursor, Claude Code, Codex, VS Code 등 주요 AI 개발 환경에서 사용할 수 있으며, 생성된 스토리보드는 remotion-composition-builder와 remotion-render-pipeline으로 연결되어 ElevenLabs 음성 합성과 최종 렌더링까지 이어집니다. 특히 화면 텍스트는 내레이션보다 간결하게 작성하고, 이모지는 음성 합성 오류를 피하기 위해 내레이션에 포함하지 않으며, 배경 음악이 없어도 완성된 비디오가 성립하도록 설계되어 있습니다.

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

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

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

문서

remotion-screen-storyteller

말과 컷. 디자인(디자이너)이 아니라, 빌드(composition-builder)도 아닙니다.

트리거

  • 브리프가 장면 없이 목표/주제만 설명하는 경우(예: "RA의 NIR 기능에 대한 60초 설명 영상").
  • 사용자가 내레이션을 다시 쓰거나 장면을 다듬어 달라고 요청하는 경우.

입력

  • brand — 음성 제약(톤, 금칙어, 말투)을 위한 값
  • topic — 비디오의 주제
  • durationSec — 전체 재생 시간(초)
  • channel — LinkedIn / YouTube / Instagram / training (속도 조절용)
  • 가능한 경우 remotion-marketing-strategist의 채널 사양

방법

  1. 기본 3막 구조: 훅(약 13%) / 본문(약 74%) / CTA(약 13%). 60초 기준 → 8/44/8초.
  2. 훅 라인 — 문제나 놀라운 사실을 단 하나의 선언적 문장으로 제시. 소리 내어 읽을 때 3.5초 이내.
  3. 본문 — 2~4개의 마이크로 장면, 각 15초 이하, 각 장면은 완결된 생각으로 끝남. 3개 이상의 항목을 나열하지 않음.
  4. CTA — 브랜드명 + 태그라인 + 행동 동사. 4초 이내로 읽힘.
  5. 음성 제약 — 모든 줄은 BrandConfig.voice.forbiddenWords 필터를 통과해야 함(Pi-CEO 규칙에 따라 we / our / I / us / my 불가; CCW의 "cheapest" 같은 브랜드별 금지어 포함).
  6. 말투 — 짧은 말투 브랜드(RA, CCW)는 12단어 이하 문장 선호; 중간 말투(DR, NRPG, CARSI)는 18단어까지.

출력

{
  "storyboard": [
    {
      "sceneId": "hook",
      "durationSec": 8,
      "voiceover": "Australia ships hundreds of restoration report formats. One should be enough.",
      "onScreenText": "Hundreds of report formats.\nOne should be enough.",
      "broll": null
    },
    { "sceneId": "body", "durationSec": 44, "voiceover": "...", "onScreenText": "...", "broll": "logos/ra/nir-mockup.png" },
    { "sceneId": "cta",  "durationSec": 8,  "voiceover": "RestoreAssist. One National Inspection Standard.", "onScreenText": "..." }
  ]
}

onScreenText는 voiceover와 다를 수 있습니다 — 더 간결하고, 시각적 리듬을 위해 줄바꿈을 포함합니다.

경계

  • 화면 텍스트는 한 번에 표시할 수 있는 양을 초과하지 않음(대략 72pt 기준 14단어 이하).
  • 내레이션에 이모지를 절대 포함하지 않음(TTS 발음이 불안정함).
  • 배경 음악이 있다고 가정하지 않음 — 무음 상태에서도 비디오가 성립하도록 작성.

인계 대상

remotion-composition-builder(스토리보드 사용) 및 remotion-render-pipeline(ElevenLabs를 통한 음성 합성).

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

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.

관련 스킬