yuv-pilot — the YUV.AI skills pyramid
The flight director. Doesn't fly the plane — tells you which crew member should.
This skill is the top of the YUV.AI skills pyramid. Its job is to recognise a YUV.AI brand request, identify what's actually being asked for, pick the right combination of downstream YUV.AI skills, and hand off cleanly. It does not produce visual output, write code, or render assets. It is a router.
The metaphor maps to the brand: in flight ops, the pilot doesn't refuel the aircraft, doesn't load the cargo, doesn't run ATC. The pilot decides the mission and tells the right specialist when to act.
§0. When to apply — strict YUV.AI gate
✅ Apply when
- The user mentions YUV.AI, "my brand", "my design system", "for me", "my launch", "my channels", "Let's Fly High", OR explicitly invokes
/yuv-pilot. - The deliverable spans multiple media — a launch needing a site + deck + reel + social cards is the canonical case.
- The user is asking "what should I build for YUV.AI" / "how do I ship X for my brand" — strategic, not yet a single artifact.
- The medium is ambiguous and clarification would help — e.g. "do something for me about MCP" (could be deck, blog, reel, social, site section).
❌ Do NOT apply when
- The request is clearly single-medium AND a specific downstream skill obviously owns it:
- "Make me a YUV.AI deck about X" →
yuv-deckswins directly. yuv-pilot stays out. - "Edit this video into a viral short for me" →
yuv-viral-videowins. yuv-pilot stays out.
- "Make me a YUV.AI deck about X" →
- The request is non-YUV.AI (generic game / app / client work / third-party brand). The whole pyramid stays out.
- The user has already named the specific tool / skill they want.
The principle: yuv-pilot is the front door for ambiguity. When the path is obvious, let the specific skill take the request.
§1. The YUV.AI skills pyramid
┌─────────────────────┐
│ yuv-pilot │ ← you are here
│ (intent → route) │
└──────────┬──────────┘
│
┌────────────────────────┼────────────────────────┐
▼ ▼ ▼
┌─────────┐ ┌─────────────┐ ┌──────────────┐
│yuv-decks│ │ yuv-design- │ │ yuv-viral- │
│ │ │ system │ │ video │
│ talks │ │ │ │ │
│ slides │ │ palette, │ │ short MP4s, │
│ keynotes│ │ typography, │ │ Reels, Shorts│
│ open- │ │ assets, │ │ video-use + │
│ slide │ │ socials, │ │ hyperframes │
│ Yuval │ │ credentials │ │ MrBeast-pace │
│ voice │ │ 3 modes │ │ │
└────┬────┘ └──────┬──────┘ └──────┬───────┘
│ │ │
▼ ▼ ▼
open-slide tokens / components hyperframes
slide-authoring brand assets video-use
nano-banana-pro social link set gsap
mermaid-diagrams lessons-learned nano-banana-pro
gsap gsap
╲ ╱
╲ ╱
╲ ╱
▼ ▼
┌─────────────────────────────┐
│ Brand DNA (Universal Fly │
│ High Throughline) │
│ • flight metaphors │
│ • HUD + dials │
│ • phoenix mark + watermark │
│ • Anton + JetBrains Mono │
│ • "Let's Fly High" │
└─────────────────────────────┘
How to read the pyramid
- Top tier (orchestrator):
yuv-pilot. Routes intent. - Middle tier (opinionated YUV.AI skills):
yuv-decks,yuv-design-system,yuv-viral-video. Each owns one mode of output. Each calls down to the bottom tier. - Bottom tier (generic tools):
open-slide,hyperframes,gsap,nano-banana-pro,video-use,mermaid-diagrams,slide-authoring. Not YUV.AI-specific; the middle tier uses them. - The Brand DNA layer runs across the entire pyramid — every YUV.AI output, regardless of medium, carries the flight throughline. The palette is the chapter; the motifs are the brand.
§2. Routing table — medium → composition
When the deliverable is clear, route directly. When it's ambiguous, ask once and then route.
| User wants… | Lead skill | Compose with | Notes |
|---|---|---|---|
| Slide deck / keynote / talk / hackathon presentation for YUV.AI | yuv-decks | yuv-design-system (Decks mode — Fly High purple/yellow/grey) · slide-authoring · open-slide · optionally nano-banana-pro for hero imagery · optionally mermaid-diagrams for architecture diagrams | yuv-decks scaffolds via ./scripts/new-deck.sh. Drops AGENTS.md / CLAUDE.md / .github/copilot-instructions.md into the new deck root. |
| Website / landing page / portfolio / About page for YUV.AI | yuv-design-system (Neon mode — pink/cyan/white or rich black) | gsap for non-trivial animation · hyperframes if the hero needs an MP4-renderable composition | New project: run install-agent-instructions.sh /path/to/project to drop in the cross-tool instructions. |
| Cinematic scroll-scrub landing from a short video (the github/lion/hope showcase pattern — 5–15s clip becomes a single-screen hero where scrolling scrubs the video frame-by-frame and 5 text overlays crossfade) | parallax-landing-page | Brings its OWN type stack (Anton + Caveat + Inter) and accent palette (gold/amber/accent/cream). Does NOT call yuv-design-system — they coexist. For YUV.AI parallax landings, optionally add the phoenix watermark + Linktree URL as throughline. | Saves to ~/Documents/yuv-projects/landings/<slug>/. Reference implementations live at examples/parasites/. |
| Apple-style video-scrub landing with normal sections below (sticky hero scrubs N frames as you scroll, then content sections continue) | video-to-landing-page | yuv-design-system in Neon mode for YUV.AI projects; no design system at all for generic / third-party work | The shorter, more conventional sibling to parallax-landing-page. Use when the hero is a teaser and the rest of the page carries copy + CTA. |
| Web app / dashboard / interactive tool for YUV.AI | yuv-design-system (Neon mode) | gsap · framework of choice (React, Svelte, plain) · mermaid-diagrams if there's an architecture diagram | One-Anton-per-screen rule applies. Use <CounterUp> for big stats. Glow on hero / primary CTA only. |
| Game / interactive 3D experience for YUV.AI | yuv-design-system (Neon mode) | Three.js · gsap for tweening · hyperframes if the game is capture-destined for a reel | Faceted brand-colored geometry. Pink/cyan accents on rich-black canvas is the strongest look. |
| Promo video / reel / short / TikTok / Shorts featuring Yuval | yuv-viral-video | video-use (cuts) · hyperframes (composition layer) · gsap (motion graphics) · yuv-design-system for type/palette overlay decisions · optionally nano-banana-pro for cutaway imagery | Always renders BOTH 9:16 AND 16:9. Saves with _V<N> suffix. Opinionated YUV.AI editorial style — MrBeast pacing, signature glass cards. |
| Captioned video / tutorial / talking-head with subtitles (Hebrew, English, or any Whisper-supported language) | video-edit | hyperframes · hyperframes-cli · yuv-design-system for type/palette decisions if YUV.AI-branded · Whisper (large-v3 default) for transcription | More general than yuv-viral-video — transcript-review-before-render workflow, dual aspect (16:9 + 9:16 from same source), liquid-glass caption pills. Use when the user wants a captioned showcase rather than a viral MrBeast-paced short. |
| Cinematic / cinematic AI-generated video / 3D virtual cinematography for YUV.AI | cinematic-ai-video (if available) | hyperframes · yuv-design-system for any overlay typography · nano-banana-pro | When the source is fully AI-generated rather than edited footage. |
| Signature video banner (the cinematic looping iframe at the top of a YUV.AI landing page) | yuv-design-system (Neon site + Hyperframes-compatible composition) | hyperframes (renders the banner) · gsap (animation) | Pattern documented in yuv-design-system/references/presentations.md § Signature video banner. |
| Social card / OG image / Instagram square / poster for YUV.AI | yuv-design-system (Neon mode — or Warm Editorial for Hope/practical) | nano-banana-pro for in-brand imagery · mermaid-diagrams if technical diagram | Watermark bottom-right, canonical socials if there's a footer. |
| Speaker bio / About card / "meet the host" | yuv-design-system (Neon mode) | The canonical credentials block (2× GitHub Star, AWS Gen AI Superstar, Channel 12 News, AI Builder & Speaker, Founder YUV.AI) + canonical socials | Always uses assets/profile-yuval-studio.png for the photo. |
| Hope / Marcus / bigcats.ai / practical.yuv.ai (course landing) | yuv-design-system (Warm Editorial mode) | hope-born-to-run (if it's a Hope/Marcus campaign) · cinematic-ai-video for any wildlife clips · nano-banana-pro for editorial imagery | This is the only mode that bans pure #FFFFFF. Paper-grain texture mandatory. |
| Cross-channel launch (site + deck + reel + social cards + email) | yuv-pilot stays loaded | Calls each of the above in sequence. Recommend a build order: design system + brand assets in place → deck (for the talk) → site (for the landing) → reel (for distribution) → social cards (for amplification) → email (for list). | This is the canonical multi-medium case. Build the design system surface first; the rest borrows from it. |
§3. Worked examples
Example A — "Build me something for my next AI talk"
Read: YUV.AI signal ✓ (it's his talk), medium = deck. Single-medium → route directly to yuv-decks, no need for yuv-pilot to stay involved.
Hand-off response:
Loading
yuv-decks— it'll scaffold an open-slide project with the 4-act nar