Communitygithub.com

CleanExpo/Pi-Dev-Ops

1~3つの16進カラーアンカーと色相ファミリー分類から、完全でアクセシブルなパレット(プライマリ、セカンダリ、アクセント、4段階ニュートラル、セマンティック、ダークバリアント)を生成します。すべてのテキスト・背景ペアのWCAG-AAコントラストを検証します。BrandConfigの定義色が5未満の場合、またはコントラストが基準を満たさない場合にトリガーされます。

Pi-Dev-Ops とは?

このスキルは、最小限のカラーアンカーから完全なブランドパレットを生成する純粋関数型ツールです。最大3つの16進カラー(プライマリ必須、セカンダリ・アクセントはオプション)と、カラーファミリー分類(restoration, safety, industrial, consumer, training)を受け取り、OKLch色空間でパレットを計算します。特筆すべきは「スクールプリセット」機能で、editorial-monocle、modern-minimal、warm-soft、tech-utility、brutalist-experimentalの5つのビジュアルスクールから選択でき、各スクールは色相範囲、明度範囲、ニュートラルの色温度、アクセント彩度を事前に制約します。生成後はすべてのテキスト・背景ペアに対してWCAG-AA(4.5:1以上)を自動検証し、不合格の場合は該当スロットを再生成します。また、brutalist-experimentalスクールではAAAレベル(7.0:1以上)を要求します。出力はJSONコントラストレポートと、Synthexのブランド設定ファイルに直接挿入可能なYAMLフラグメントの2種類です。このジェネレータは完全に決定論的であり、同じ入力(primary, family, schoolの3つ組)からは常に同じパレットが得られます。LLMによる補間は一切行わず、コード内の純粋関数として動作するため、テストや再現が容易です。主にremotion-studio環境向けに設計されていますが、OKLch座標も出力するためTailwind CSS v4などの後段システムでも活用できます。

対応✓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 つの 16 進カラーアンカー(primary は必須、secondary と accent は任意)
  • family:restoration | safety | industrial | consumer | training
  • school (任意):editorial-monocle | modern-minimal | warm-soft | tech-utility | brutalist-experimental — ビジュアルスクールのプリセット(オープンデザインの系譜)。ファミリーヒューリスティックが実行される 前に、タイプキャラクター、コントラストバイアス、アクセントの役割を選択します。デフォルト:modern-minimal。
  • 既存のパレット(拡張時)

メソッド

  1. スクールプリセット — school のバイアスを 最初に 適用します。各スクールは色相範囲、明度範囲、ニュートラルの色温度、アクセント彩度を制約します。

    スクール色相バイアス明度バイアスニュートラルアクセント彩度参考(ベンダー化)
    editorial-monocle暖色アース(テラコッタ/クレイ/サンド)高(パーチメント/アイボリー)暖色グレーのみ — すべてのグレーが黄褐色のアンダートーンを持つ1つのクロマチックアクセント、深くアース調_library/claude/、_library/monocle/(存在する場合)
    modern-minimalクールニュートラル(スレート/ブルーグレー)バランス純粋グレー1つのエレクトリックアクセント、ビューポートあたり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 色空間で作業し、色相回転が知覚明度を維持するようにします。16 進アンカーを最初に OKLch に変換し、色相を ±30°/±60° 回転させながら、明度をスクールのバンド内にクランプします。BrandConfig ストレージ用に出力を 16 進に戻します。コントラストレポートには oklch の兄弟フィールドを保持し、下流の Tailwind-4 コンシューマー(フェーズ 2)に対応します。

  4. 決定論 — 同じ (primary, family, school) の 3 つ組は、実行ごとに常に同じ出力パレットを生成しなければなりません。ランダム性、温度、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)が必要です。

出力

2 つのアーティファクト:

  1. JSON コントラストレポート(OKLch 座標付き、remotion-brand-codify およびフェーズ 2 の Web 消費向け):
{
  "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 を使用しないでください — 関数は決定論的です。決定論が破綻した場合(同じ入力で実行ごとに異なる出力)、それはジェネレーターのバグであり、機能ではありません。
  • 2 つのスクールを決して混ぜないでください。1 つを選んでください。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.

関連スキル