Communitygithub.com

CleanExpo/Pi-Dev-Ops

1~3개의 헥스 앵커와 색상군 분류를 기반으로 완전한 접근성 팔레트(기본, 보조, 강조, 4단계 중립, 의미 색상, 다크 변형)를 생성합니다. 모든 텍스트-배경 쌍에 대해 WCAG-AA 대비를 검증합니다. BrandConfig에 정의된 색상이 5개 미만이거나 대비가 실패할 때 실행됩니다.

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

이 스킬은 최소한의 입력만으로 브랜드에 완전하고 접근성 있는 컬러 팔레트를 생성하는 도구입니다. 개발자는 1~3개의 헥스 색상(기본 필수, 보조/강조 선택)과 색상군(안전, 복원, 산업 등)을 제공하기만 하면 됩니다. 선택적인 '학교(school)' 프리셋을 통해 디자인 스타일(예: 모던 미니멀, 에디토리얼 모노클)을 사전에 적용할 수 있어, 색조, 명도, 중립색 온도, 강조 채도 등이 체계적으로 결정됩니다. OKLch 색 공간에서 작동하여 명도 인지 일관성을 유지하며, 동일한 입력에 대해 항상 동일한 출력을 보장하는 결정론적 함수로 설계되었습니다. WCAG-AA(일부는 AAA) 대비를 자동 검증하고, 실패 시 해당 슬롯을 재생성합니다. 최종 출력물은 JSON 대비 보고서와 `@google/design.md` 사양을 따르는 YAML 조각으로, `remotion-brand-codify`와 같은 하위 도구가 브랜드 설정 파일에 직접 기록할 수 있습니다. Claude Code, Cursor, Codex 등 AI 에이전트 플랫폼에서 '팔레트 확장' 또는 '색상 감사' 같은 명령으로 트리거됩니다.

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

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

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

문서

remotion-colour-family

최소 앵커로 완전한 팔레트를 구축합니다. remotion-studio/src/colour/index.ts의 contrast() 헬퍼를 재사용합니다.

트리거

  • BrandConfig에 secondary, accent, neutral 또는 semantic 블록이 누락된 경우.
  • 렌더링이 대비 검사에 실패한 경우: 텍스트-배경 쌍의 비율이 4.5 미만.
  • 사용자가 "{brand}의 팔레트를 확장해줘" 또는 "색상을 감사해줘"라고 말한 경우.

입력

  • 1~3개의 헥스 앵커 (primary 필수; secondary, accent 선택)
  • family: restoration | safety | industrial | consumer | training
  • school (선택): editorial-monocle | modern-minimal | warm-soft | tech-utility | brutalist-experimental — 비주얼 스쿨 프리셋 (오픈 디자인 계열). family 휴리스틱이 실행되기 전에 타입 특성, 대비 편향, 강조 역할을 선택합니다. 기본값: modern-minimal.
  • 기존 팔레트 (확장하는 경우)

방법

  1. 학교 프리셋 — school 편향을 먼저 적용합니다. 각 학교는 색조 범위, 명도 범위, 중립색 온도, 강조 채도를 제한합니다:

    학교색조 편향명도 편향중립색강조 채도참고 (벤더됨)
    editorial-monocle따뜻한 흙색 (테라코타/진흙/모래)높음 (양피지/아이보리)따뜻한 회색만 — 모든 회색은 황갈색 언더톤을 지님하나의 채도 강조, 깊이 있는 흙빛_library/claude/, _library/monocle/ (존재하는 경우)
    modern-minimal차가운 중성 (슬레이트/청회색)균형 잡힘진정한 회색하나의 전기 강조, 뷰포트당 3회 미만 사용_library/airbnb/, _library/cal/
    warm-soft따뜻한 파스텔 (복숭아/발그레/크림)높음따뜻한 회색 + 크림 틴트낮은 채도의 장미/산호_library/airtable/, _library/cafe/
    tech-utility남색 / 시안 / 슬레이트낮음 (어두운 표면 선호)슬레이트-900 방향의 차가운 회색시안 신호 강조, 델타/상태에만 사용_library/binance/, _library/arc/
    brutalist-experimental원시 흰색 위의 고대비 기본색극단적 높음 + 극단적 어두움순수 검정/흰색만날카로운 네온, 적극적으로 사용_library/brutalism/, _library/bold/
  2. 군 휴리스틱 — 학교 이후에 적용됩니다. 군은 표준 인접 색상을 제공합니다:

    • safety: 네이비 + 비상 주황 + 아이보리
    • restoration: 청록 + 슬레이트 + 라임
    • industrial: 흑연 + 강철 + 호박색
    • consumer: 히어로 레드/블루 + 따뜻한 흰색 + 슬레이트
    • training: 테라코타 + 크림 + 잉크
  3. OKLch로 생성 — HSL이 아닌 OKLch 색 공간에서 작업하여 색조 회전이 인지된 명도를 보존합니다. 헥스 앵커를 먼저 OKLch로 변환하고, 학교의 명도 대역 내로 명도를 고정하면서 색조를 ±30°/±60° 회전합니다. 출력은 BrandConfig 저장을 위해 헥스로 변환합니다. 대비 보고서에 oklch 형제 필드를 유지하여 다운스트림 Tailwind-4 소비자(2단계)를 지원합니다.

  4. 결정론 — 동일한 (primary, family, school) 트리플은 실행 간에 항상 동일한 출력 팔레트를 생성해야 합니다. 무작위성 없음, 온도 없음, LLM 보간 없음. 생성기는 입력의 순수 함수입니다.

  5. 중립색 구축 — oklch(99% 0 hue) (50)과 oklch(15% 0 hue) (900) 사이를 보간하고, 학교 편향에 따라 chroma를 기본색 색조 방향으로 기울입니다 (warm-soft는 중립색을 따뜻하게, tech-utility는 차갑게).

  6. 의미 색상 구축 — 기본색과 충돌하지 않는 고정 풀에서 success/warning/danger를 선택합니다.

  7. 다크 변형 구축 — 중립색을 반전(50 ↔ 900 명도)하고 기본색을 OKLch 공간에서 8% 명도를 올립니다.

  8. 검증 — 각 쌍 (primary, neutral.50), (primary, neutral.900), (secondary, neutral.50), (accent, secondary)에 대해 대비 ≥ 4.5 (WCAG-AA)를 확인합니다. 실패하면 해당 슬롯을 재생성합니다. Brutalist-experimental은 ≥ 7.0 (AAA)이 필요합니다.

출력

두 가지 산출물:

  1. JSON 대비 보고서 — OKLch 좌표 포함 (remotion-brand-codify 및 2단계 웹 소비용):
{
  "school": "modern-minimal",
  "family": "restoration",
  "tokens": {
    "primary": { "hex": "#0E7C7B", "oklch": "oklch(48% 0.10 195)" },
    "neutral": {
      "50":  { "hex": "#F5F7F8", "oklch": "oklch(97% 0.005 200)" },
      "900": { "hex": "#0E1518", "oklch": "oklch(15% 0.010 215)" }
    }
  },
  "passes": [ { "fg":"#F5F7F8", "bg":"#0E7C7B", "ratio": 7.21, "level":"AAA" } ],
  "fails": []
}
  1. YAML 조각 — Synthex/packages/brand-config/src/brands/{slug}.design.md의 colors: 블록에 바로 넣을 수 있습니다. 토큰 이름은 @google/design.md 사양을 따릅니다 (계층 이름은 소문자 + 대시, 예: neutral-50, dark-primary):
colors:
  primary: "#0E7C7B"
  secondary: "#2A3D45"
  accent: "#C5E063"
  neutral-50: "#F5F7F8"
  neutral-100: "#E4E9EC"
  neutral-500: "#6F7B82"
  neutral-900: "#0E1518"
  success: "#3FA34D"
  warning: "#E0A800"
  danger: "#C0392B"
  on-primary: "#FFFFFF"
  on-secondary: "#FFFFFF"
  on-accent: "#0E1518"
  surface: "{colors.neutral-50}"
  on-surface: "{colors.neutral-900}"
  dark-primary: "#16B5B3"
  dark-secondary: "#1A2428"
  dark-surface: "#0E1518"
  dark-on-surface: "#F5F7F8"

결과 .design.md 파일에 대해 npx --prefix Pi-Dev-Ops/remotion-studio design.md lint를 실행하여 대비 오류가 없음을 확인하세요.

경계

  • AA 실패가 있는 팔레트를 절대 제공하지 마세요 — 실패한 슬롯을 차단하고 설립자 입력을 요청하세요.
  • 브랜드가 설정한 명시적 darkVariant를 절대 재정의하지 마세요.
  • family === 'consumer'이고 브랜드 이름이 명시적으로 빨간색을 고정하지 않는 한, 빨간색을 기본색으로 사용하지 마세요.
  • 생성 중에 LLM을 사용하지 마세요 — 함수는 결정론적입니다. 결정론이 실패하면(동일한 입력 → 실행 간 다른 출력), 이는 기능이 아닌 생성기의 버그입니다.
  • 두 학교를 혼합하지 마세요 — 하나를 선택하세요. editorial-monocle의 따뜻함과 tech-utility의 슬레이트를 혼합하면 모든 브랜드가 시작하는 진흙탕 "AI 기본" 팔레트가 생성됩니다.

인계

remotion-brand-codify가 결과를 src/brands/{slug}.ts에 씁니다.

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

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.

관련 스킬