Communitygithub.com

CleanExpo/Pi-Dev-Ops

하나 또는 여러 개의 일관된 브랜드 마케팅 비디오를 주제만으로 제작합니다: 스크립트, ElevenLabs 보이스오버(타임스탬프 포함), 비트별 스타일 일러스트레이션, ffmpeg로 1080p로 연결, 선택적으로 YouTube에 미등록 업로드합니다.

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

이 스킬은 `/brand-video` 명령어를 통해 브랜드 일관성을 유지하는 무연고 마케팅 비디오를 대량 생산합니다. `styles.md`에 정의된 고유 스타일(flat-line, hand-doodle, bold-kinetic, cinematic-photoreal, minimal-corporate, retro-print)을 기반으로 스크립트, 보이스오버, 이미지 생성을 자동화합니다. 파이프라인은 스크립트 작성 → TTS 보이스오버 → 비트별 이미지 생성(서버 측 `image_gen.py` 또는 대화형 `mcp__margot__image_generate` 사용) → ffmpeg 스티칭 순서로 진행됩니다. 병렬 배치, 재보이스, YouTube 업로드(YouTube Data API v3 사용)를 지원하며, 각 비디오는 고유 슬러그 폴더에 격리되어 구성됩니다.

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

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

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

문서

brand-video — 일관된 스타일의 무연고 비디오, 주문 제작

**/brand-video**로 호출합니다. 하나의 명령으로 다양한 룩을 제공합니다. 검증된 RestoreAssist 실행(9개 비디오 전달)을 기반으로 구축되었습니다. styles.md에서 스타일을 선택하고, 다른 모든 것은 일정하게 유지하여 배치 간, 브랜드 간 일관된 출력을 보장합니다.

입력 (누락된 경우에만 묻고, 합리적으로 추론)

  • brand — RestoreAssist / Synthex / DR / NRPG / CARSI / CCW / Unite 또는 클라이언트. 주장 + CTA + 음성을 설정합니다.
  • style — styles.md의 키값 (기본값 flat-line). 이것이 "룩"/드롭다운 값입니다.
  • topic(s) — 하나의 각도 또는 배치 목록 (각 주제마다 하나의 비디오, 병렬 처리).
  • voice — ELEVENLABS_VOICE_ID (브랜드별; ~/.hermes/.env에서 가져옴). 중요: 생성 전에 현재 값을 반드시 확인하세요 — 사용자가 변경합니다.
  • upload? — 기본값: 렌더링 + 스테이징만. 요청 시에만 YouTube 미등록 업로드.

파이프라인 (비디오당 하나의 슬러그 폴더, 디렉토리 공유 금지)

  1. 스크립트 → <slug>/script.md: 하나의 깔끔한 VO 문단, 약 120–140 단어, 약 12–16개의 짧은 문장 (한 문장 = 하나의 시각적 비트 = 하나의 이미지), 문제→해결→CTA 순서. 브랜드 위키에 근거하여 주장을 뒷받침하며, 기능을 절대 허위로 만들지 마세요. 브랜드 CTA 라인으로 끝냅니다.
  2. 보이스오버 → 번들 tts.py 실행 (ELEVENLABS_API_KEY + ELEVENLABS_VOICE_ID + DIR 읽음): cd <workdir> && set -a && . ~/.hermes/.env && set +a && DIR=$PWD/<slug> python3 <skill>/pipeline/tts.py <slug>/voiceover.mp3 + <slug>/transcript.json (비트)를 작성합니다. 비트 수를 확인하세요.
  3. 이미지 → 비트당 하나, 프롬프트 = 선택한 스타일의 POSITIVE 토큰 + 해당 문장에 대한 구체적인 장면 + 스타일의 NEGATIVE 토큰, 가로 16:9, 제로 패딩된 <slug>/images/01.png …로 저장.
    • 프로덕션 / 헤드리스(기본값): python3 <skill>/pipeline/image_gen.py "<prompt>" <out.png> — Gemini gemini-2.5-flash-image ("Nano-Banana") HTTPS를 통해, GEMINI_API_KEY는 환경 변수에서 가져옴. 서버 측에서 작동하며 종단 간 검증됨. 앱 워커가 호출하는 방식입니다 (로컬 MCP 불필요).
    • 대화형(선택 사항): Claude 세션 내에서 실행 시 mcp__margot__image_generate 사용; 슬러그 접두사가 붙은 파일명을 사용하여 병렬 충돌을 방지합니다 ([[parallel-agents-shared-output-collision]] 참조).
  4. 스티칭 → python3 <skill>/pipeline/stitch.py <slug> → <slug>/final-1080p.mp4 (1920×1080@25, 비트의 이미지 타이밍 기반). 최종 길이가 보이스오버 길이와 일치하는지 확인하세요.

배치 및 새 룩

  • 배치: 주제당 하나의 하위 에이전트를 디스패치합니다 (병렬), 각자 고유한 슬러그 디렉토리를 소유합니다. 정확한 에이전트 프롬프트 형태는 RestoreAssist 실행을 참조하세요.
  • 재보이스 (음성 변경, 동일 스크립트/이미지): VO 재생성, list.txt 지속 시간을 new_total/old_total로 재조정, 다시 스티칭합니다. (revoice 패턴.)
  • 룩 추가: styles.md에 블록을 추가합니다 (positive/negative 토큰). 해당 키는 즉시 선택 가능한 스타일이 됩니다 — 이 레지스트리가 드롭다운의 데이터 소스입니다.

업로드 (YouTube, 선택 사항)

브라우저 파일 업로드는 비활성화되었습니다 (호스트 경로 거부됨). [[youtube-api-upload-restoreassist]]에 문서화된 YouTube Data API 경로를 사용하세요: Desktop OAuth 클라이언트 → ~/.hermes/yt-restoreassist-token.json의 토큰 → videos().insert privacyStatus=unlisted, category 27, not-for-kids; 채널 제목으로 가드; uploaded.json을 통해 멱등성 보장. OAuth 클라이언트의 GCP 프로젝트에서 YouTube Data API v3가 활성화되어 있어야 합니다.

가드레일

  • 주장은 실제여야 합니다 (브랜드 위키/제품 진실). 플랫 일러스트 + 합성 음성 → YouTube AI 공개는 일반적으로 "아니요"입니다 (업로드 시 확인, AI 음악이 추가된 경우 "예"로 전환).
  • 일관성을 위해 배치당 하나의 스타일을 유지하세요. SKILL.md를 [[feedback-tight-code]] 당 200줄 이하로 유지하세요.
  • 참조 구현 + 자산: /Users/phill-mac/restoreassist-videos/.

Individual skills in this repo

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

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.

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.

관련 스킬