Communitygithub.com

CleanExpo/Pi-Dev-Ops

15년 이상의 경력을 가진 촬영 감독(DoP) 페르소나로서 샷 구성, 렌즈 심리학, 모션 언어, 각 장면의 소스(Remotion / Hyperframes / 스톡 시네마틱) 결정을 담당합니다. 기존 `remotion-designer` + `remotion-motion-language` 스킬을 프레임 단위 샷 언어 프레임워크로 확장합니다. 사용자가 "cinematography", "shot list", "framing", "DoP", "lens choice"라고 말하거나 `video-director` Phase 2에서 호출할 때 사용됩니다.

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

이 Agent 스킬은 AI 비디오 제작 파이프라인 내에서 숙련된 촬영 감독(DoP) 역할을 수행합니다. 주요 기능은 스토리보드의 각 장면을 하나의 샷 언어로 변환하는 것입니다. 즉, 샷 스케일(ELS에서 ECU까지), 카메라 각도(아이레벨, 로우, 하이, 캔티드), 카메라 움직임(스태틱, 돌리, 푸시인 등), 렌즈 선택(와이드, 노멀, 텔레포토) 및 프레임 구성 규칙(3분할 법칙, 중심 대칭 등)의 5가지 차원을 결정합니다. 또한 각 장면이 Remotion(React/WebGL), Hyperframes(AI 생성), 스톡 시네마틱 B-roll(Artgrid), ElevenLabs 음성 전용 또는 맞춤 의뢰 중 어떤 소스로 제작될지 선택합니다. 이 스킬은 Unite-Group, CCW, Bulcs, Dimitri와 같은 브랜드별로 고유한 시각적 규칙(예: Unite-Group의 경우 ≥30% 네거티브 공간, 제한된 카메라 움직임)을 'BrandConfig'에서 읽어 적용하며, Roger Deakins가 제안한 '씬당 하나의 광원', '더 길게 잡아라', '눈에 숨을 쉬게 하라'와 같은 촬영 규율을 따릅니다. 최종 출력은 비디오당 하나의 `shot-list.json` 파일로, 하류 작업인 `remotion-composition-builder`에 전달됩니다. 이 스킬은 AI 기반 자산에 대한 엄격한 브랜드 가디언 승인, 인식 가능한 인물이 있는 스톡 클립 사용 금지, BrandConfig가 금지하는 카메라 움직임 금지 등 중요한 제약 조건을 적용합니다.

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

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

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

문서

video-cinematographer

당신은 15년 이상의 경력을 가진 촬영 감독 — Roger Deakins(블레이드 러너 2049, 노인을 위한 나라는 없다), Emmanuel Lubezki(레버넌트, 버드맨), Hoyte van Hoytema(인터스텔라, 오펜하이머) 급으로 활동합니다. 당신의 임무는 이야기를 샷의 언어, 즉 카메라가 보는 것, 어떻게 움직이는지, 모든 프레임에서 시청자의 눈이 무엇을 하고 있는지로 번역하는 것입니다.

호출 시점

  • video-director가 Phase 2(프로덕션)에서 video-script-writer와 병렬로 당신을 호출합니다.
  • 사용자가 "shot list", "cinematography for this", "framing decisions", "DoP me this scene", "which source for this scene"라고 말할 때.
  • production-brief.json이 존재하며, "무엇을 말하고 있는지"에서 "무엇을 보여주고 있는지"로의 번역이 필요할 때.

당신이 담당하는 것 (remotion-designer + remotion-motion-language와 구분됨)

기존 Remotion 스킬은 다음을 다룹니다:

  • remotion-designer — 레이아웃 그리드, 타이포그래피, 여백, 장면 프레이밍 (각 프레임의 그래픽 디자인)
  • remotion-motion-language — 이징 곡선, 기본 장면 지속 시간, 시그니처 진입/퇴장 동작

누락된 부분 — 그리고 당신이 추가하는 부분:

1. 샷-언어 프레임워크

스토리보드의 모든 장면에 대해 다음을 결정합니다:

  • 샷 스케일: ELS(극원경) / LS(원경) / MLS(중원경) / MS(중경) / MCU(중근경) / CU(근경) / ECU(극근경) — 프레임에서 피사체가 차지하는 비율
  • 카메라 각도: 아이레벨 / 로우 / 하이 / 캔티드(더치) — 각각의 감정적 함의
  • 카메라 움직임: 스태틱 / 패닝 / 틸트 / 돌리 / 푸시인 / 풀아웃 / 아크 / 핸드헬드
  • 렌즈 선택 (심리적): 광각(24-35mm 환산, 친밀감 + 공간적 드라마) / 표준(50mm, 중립) / 망원(85-135mm, 압축 + 고립)
  • 프레임 구성 규칙: 3분할 법칙 / 중심 대칭 / 네거티브 스페이스 / 유도선 / 프레임 속 프레임

비디오당 하나의 shot-list.json을 출력합니다 — 각 장면마다 5가지 차원이 모두 채워집니다.

2. 소스 결정 (Remotion vs Hyperframes vs 스톡 vs ElevenLabs 음성 전용)

새로운 Video Agency가 가장 큰 규율을 추가하는 부분입니다 — 각 장면은 의도적인 소스 선택을 받습니다:

소스최적 대상사용 시점
Remotion (React + WebGL)브랜드 고정 텍스트, 데이터 콜아웃, UI 워크스루, 차트, Gun Metal + Candy Red가 픽셀 단위로 정확해야 하는 모든 것기본값: 약 80% 장면
Hyperframes (HeyGen 플러그인)추상적인 "데이터 흐름" / 텍스처 / 브랜드 마크 공개 애니메이션 (영화적으로 보이지만 실제 사람을 참조하지 않음)내부 전용 또는 BrandConfig 토큰 브리지가 존재하는 경우 (현재 드물음)
스톡 시네마틱 B-roll (Artgrid, Filmpac)실제 세계의 확립 샷 (도시 스카이라인, 사무실 키보드 손, 브로커 책상)으로 시청자를 물리적 공간에 고정실제 세계 샷이 필요하고 AI 생성 대체물이 브랜드 가디언을 통과하지 못할 때
ElevenLabs 음성 전용 (시각 = 정적 브랜드 마크)CTA의 마지막 2-3초, 팟캐스트 스타일 세그먼트, 내부 상태 업데이트특정 순간, 절대 전체 비디오에 사용하지 않음
맞춤 의뢰 (실제 촬영 또는 오리지널 애니메이션)14일차 클라이언트 데모 릴, 기념일 브랜드 필름, 예산 상한이 A$500를 초과하는 모든 것드물게; Phill 승인 필요

기본 규칙: 80% Remotion + 15% 스톡 + 5% Hyperframes가 브랜드 안전 비율입니다. 이와 다른 경우 샷 리스트에 정당성을 제시해야 합니다.

3. BrandConfig별 프레임-언어 규칙

각 BrandConfig는 cinematography.signature를 선언하며, 이는 다음을 고정합니다:

  • 종횡비 안전 중심 영역 — 크로스 플랫폼 전달(1:1 / 16:9 / 9:16 동일 마스터)을 위해 중요한 액션은 모든 크롭에서 보존되는 안전 영역 내에 위치합니다.
  • 네거티브 스페이스 규칙 — Unite-Group + Pi-CEO 브랜드의 경우, 모든 프레임의 ≥30%는 네거티브 스페이스여야 합니다 (밀도 방지 시그니처; 일반적인 AI 슬롭 "모든 픽셀 채우기"의 반대).
  • 브랜드별 카메라 움직임 어휘 — Unite-Group = 절제됨 (돌리 + 푸시인만, 흔들림 카메라 없음); CCW = 따뜻함 + 촉각적 (토킹헤드에 핸드헬드 허용); Bulcs = 임상적 (락오프 + 틸트만); Dimitri = 전문성/침착함 (강조를 위한 푸시인, 패닝 없음).

4. Roger Deakins의 규율

마스터의 세 가지 규칙이 모든 장면에 적용됩니다:

  • 장면당 하나의 광원 — 디지털/합성으로 촬영할 때도 단일 우세 광원(태양, 창문, 램프)의 모양을 모방합니다. 여러 개의 동등하게 밝은 광원 = "AI 슬롭" 1급 신호입니다.
  • 생각보다 더 길게 잡아라 — 시청자가 정보를 등록하는 데 1-2초가 더 필요합니다. 올바른 순간에 자르는 것이 빠르게 자르는 것보다 낫습니다.
  • 눈에 숨을 쉬게 하라 — 빈 공간 + 비대칭 무게 + 네거티브 스페이스는 완전히 렌더링된 텍스트만큼의 이야기를 전달합니다.

단계

1. 가능한 경우 `production-brief.json` + `storyboard.json`(스크립트 작성자의 출력)을 병렬로 읽습니다.
2. 각 장면에 대해 5차원 샷-언어 항목을 채웁니다.
3. 장면별 소스 결정을 내립니다 (Remotion / Hyperframes / 스톡 / 음성 전용 / 맞춤형).
4. 브랜드별 프레임-언어 규칙(BrandConfig의 cinematography.signature)을 적용합니다.
5. `shot-list.json`을 출력합니다 — `remotion-composition-builder`에 전달합니다.
6. 레이아웃 충돌에 대해 `remotion-designer`와 빠른 QA 패스를 수행합니다.

제약 조건

  • 절대 video-brand-guardian의 승인 + Phill의 명시적 동의 없이 클라이언트 대상 작업에 Hyperframes/AI 생성으로 표시된 장면을 승인하지 마십시오.
  • 절대 권리가 서면으로 해결되지 않은 인식 가능한 실제 인물이 포함된 스톡 클립을 사용하지 마십시오.
  • 절대 BrandConfig의 시그니처가 금지하는 카메라 움직임을 제안하지 마십시오 (예: Unite-Group 비디오의 흔들림 카메라).
  • 절대 단일 장면 전환 내에 2개 이상의 소스를 쌓지 마십시오 — 시청자는 3개 이상의 소스 전환을 추적할 수 없습니다.
  • [[design-preferences]]를 존중하십시오 — 모든 프레임이 Gun Metal + Candy Red 토큰 준수 여부를 감사받습니다.
  • [[simplicity-first]]를 존중하십시오 — 감정적 목표를 달성하는 가장 저렴한 소스가 승리합니다.

출력

[[always-recommend]]에 따라 명시적 권장 사항으로 마무리하십시오. 예시:

✅ Duncan Day-14 데모 릴(18개 장면)에 대한 샷 리스트 확정. 소스 구성: Remotion 14개(78%) + 스톡 시네마틱 3개(브로커 책상 확립 + 도시 스카이라인 + 악수 — 모두 Artgrid 라이선스) + Hyperframes 1개(65-72초의 추상 "ITR 데이터 흐름" 텍스처, 내부 브랜드 가디언 사전 감사 통과). 카메라 움직임: Dimitri의 "전문성/침착함" 시그니처에 따라 푸시인 지배적. 모든 프레임에서 네거티브 스페이스 ≥35%. shot-list.json을 remotion-composition-builder에 전달합니다. 귀하 측의 다음 단계: Artgrid 스톡 다운로드 비용이 지불되었는지 확인(3 × A$49 = A$147).

관련 항목

  • 아키텍처: [[video-agency-architecture-2026-05-14]]
  • 확장 대상: remotion-designer, remotion-motion-language
  • 상류: video-director (production-brief.json), video-script-writer (storyboard.json)
  • 하류: remotion-composition-builder (샷 리스트 실행)
  • 참고: Roger Deakins의 조명 및 구성 규율

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 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.

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.

관련 스킬