yuv-pilot — YUV.AI 스킬 피라미드

비행 관제사. 비행기를 조종하지는 않지만 — 어떤 승무원이 움직여야 할지 알려줍니다.

이 스킬은 YUV.AI 스킬 피라미드의 최상위에 있습니다. YUV.AI 브랜드 요청을 인식하고, 실제로 무엇이 요청되었는지 파악하며, 적절한 하위 YUV.AI 스킬 조합을 선택하고 깔끔하게 전달하는 것이 임무입니다. 시각적 출력을 생성하거나, 코드를 작성하거나, 에셋을 렌더링하지 않습니다. 라우터입니다.

이 비유는 브랜드에 매핑됩니다: 항공 운영에서 조종사는 항공기에 연료를 보급하지 않고, 화물을 싣지 않으며, 관제탑을 운영하지 않습니다. 조종사는 임무를 결정하고 적절한 전문가에게 행동할 시기를 알려줍니다.

§0. 적용 시점 — 엄격한 YUV.AI 게이트

✅ 적용하는 경우

사용자가 YUV.AI, "내 브랜드", "내 디자인 시스템", "나를 위해", "내 런칭", "내 채널", "Let's Fly High" 를 언급하거나 /yuv-pilot을 명시적으로 호출할 때
결과물이 여러 매체에 걸쳐 있을 때 — 런칭에 사이트 + 데크 + 릴 + 소셜 카드가 필요한 경우가 대표적입니다.
사용자가 "YUV.AI를 위해 무엇을 만들어야 할까요" / "내 브랜드로 X를 어떻게 출시하나요" 와 같이 전략적이고 아직 단일 결과물이 아닌 질문을 할 때
매체가 모호하여 명확히 하면 도움이 될 때 — 예: "MCP에 대해 뭔가 해줘" (데크, 블로그, 릴, 소셜, 사이트 섹션 등이 될 수 있음)

❌ 적용하지 않는 경우

요청이 명확히 단일 매체이고 특정 하위 스킬이 분명히 처리할 수 있을 때:
- "X에 대한 YUV.AI 데크 만들어 줘" → yuv-decks가 직접 처리합니다. yuv-pilot은 관여하지 않습니다.
- "이 영상을 편집해서 나를 위한 바이럴 숏으로 만들어 줘" → yuv-viral-video가 처리합니다. yuv-pilot은 관여하지 않습니다.
요청이 YUV.AI 관련이 아닐 때 (일반 게임/앱/클라이언트 작업/타사 브랜드). 전체 피라미드가 관여하지 않습니다.
사용자가 이미 원하는 특정 도구/스킬을 지명했을 때

원칙: yuv-pilot은 모호함을 위한 정문입니다. 경로가 명확하면 특정 스킬이 요청을 직접 처리하도록 합니다.

§1. YUV.AI 스킬 피라미드

                          ┌─────────────────────┐
                          │     yuv-pilot       │  ← 여기 있습니다
                          │  (의도 → 경로)       │
                          └──────────┬──────────┘
                                     │
            ┌────────────────────────┼────────────────────────┐
            ▼                        ▼                        ▼
       ┌─────────┐            ┌─────────────┐          ┌──────────────┐
       │yuv-decks│            │ yuv-design- │          │ yuv-viral-   │
       │         │            │   system    │          │   video      │
       │  토크   │            │             │          │              │
       │ 슬라이드│            │ 팔레트,     │          │ 짧은 MP4,    │
       │ 키노트  │            │ 타이포그래피,│          │ 릴, 쇼츠    │
       │ open-   │            │ 에셋,       │          │ video-use +  │
       │ slide   │            │ 소셜,       │          │ hyperframes  │
       │ Yuval   │            │ 자격 증명   │          │ MrBeast 템포 │
       │ 음성    │            │ 3가지 모드  │          │              │
       └────┬────┘            └──────┬──────┘          └──────┬───────┘
            │                        │                        │
            ▼                        ▼                        ▼
        open-slide          토큰 / 컴포넌트            hyperframes
        슬라이드 저작       브랜드 에셋                video-use
        nano-banana-pro      소셜 링크 세트             gsap
        mermaid-diagrams     lessons-learned            nano-banana-pro
        gsap                                           gsap
                            ╲                          ╱
                             ╲                        ╱
                              ╲                      ╱
                               ▼                    ▼
                          ┌─────────────────────────────┐
                          │ 브랜드 DNA (보편적인 Fly    │
                          │ High 스레드)                │
                          │ • 비행 메타포               │
                          │ • HUD + 다이얼              │
                          │ • 피닉스 마크 + 워터마크    │
                          │ • Anton + JetBrains Mono    │
                          │ • "Let's Fly High"          │
                          └─────────────────────────────┘

피라미드 읽는 법

최상위 계층 (오케스트레이터): yuv-pilot. 의도를 라우팅합니다.
중간 계층 (고정된 YUV.AI 스킬): yuv-decks, yuv-design-system, yuv-viral-video. 각각 하나의 출력 모드를 담당합니다. 각각 하위 계층을 호출합니다.
하위 계층 (일반 도구): open-slide, hyperframes, gsap, nano-banana-pro, video-use, mermaid-diagrams, slide-authoring. YUV.AI에 특화되지 않았으며 중간 계층이 사용합니다.
브랜드 DNA 계층은 피라미드 전체에 걸쳐 있습니다 — 모든 YUV.AI 출력은 매체에 관계없이 비행 스레드를 포함합니다. 팔레트가 장(chapter)이고 모티프가 브랜드입니다.

§2. 라우팅 테이블 — 매체 → 구성

결과물이 명확하면 바로 라우팅합니다. 모호하면 한 번 질문한 후 라우팅합니다.

사용자가 원하는 것	리드 스킬	함께 구성	참고
슬라이드 데크 / 키노트 / 토크 / 해커톤 발표 (YUV.AI 용)	`yuv-decks`	`yuv-design-system` (데크 모드 — Fly High 보라/노랑/회색) · `slide-authoring` · `open-slide` · 선택적으로 `nano-banana-pro` (히어로 이미지) · 선택적으로 `mermaid-diagrams` (아키텍처 다이어그램)	yuv-decks는 `./scripts/new-deck.sh`를 통해 구조를 생성합니다. 새 데크 루트에 AGENTS.md / CLAUDE.md / .github/copilot-instructions.md를 넣습니다.
웹사이트 / 랜딩 페이지 / 포트폴리오 / About 페이지 (YUV.AI 용)	`yuv-design-system` (네온 모드 — 분홍/시안/흰색 또는 풍부한 검정)	`gsap` (복잡한 애니메이션) · `hyperframes` (히어로가 MP4 렌더링 가능한 구성이 필요할 경우)	새 프로젝트: `install-agent-instructions.sh /path/to/project`를 실행하여 크로스-툴 지침을 넣습니다.
짧은 비디오에서 만든 시네마틱 스크롤-스크럽 랜딩 (github/lion/hope 쇼케이스 패턴 — 5~15초 클립이 단일 화면 히어로가 되어 스크롤 시 비디오를 프레임별로 스크럽하고 5개의 텍스트 오버레이가 크로스페이드됨)	`parallax-landing-page`	자체 타입 스택(Anton + Caveat + Inter)과 악센트 팔레트(금/호박/악센트/크림)를 가져옵니다. `yuv-design-system`을 호출하지 않습니다 — 공존합니다. YUV.AI 패럴랙스 랜딩의 경우 선택적으로 피닉스 워터마크 + Linktree URL을 스레드로 추가합니다.	`~/Documents/yuv-projects/landings/<slug>/`에 저장합니다. 참조 구현체는 `examples/parasites/`에 있습니다.
Apple 스타일 비디오-스크럽 랜딩 (아래에 일반 섹션 포함) (고정 히어로가 스크롤 시 N 프레임을 스크럽한 후 콘텐츠 섹션이 계속됨)	`video-to-landing-page`	YUV.AI 프로젝트의 경우 `yuv-design-system` (네온 모드); 일반/타사 작업의 경우 디자인 시스템 없음	`parallax-landing-page`의 더 짧고 전통적인 형제입니다. 히어로가 티저이고 나머지 페이지가 카피 + CTA를 전달할 때 사용합니다.
웹 앱 / 대시보드 / 인터랙티브 도구 (YUV.AI 용)	`yuv-design-system` (네온 모드)	`gsap` · 선택한 프레임워크(React, Svelte, 순수) · 아키텍처 다이어그램이 있으면 `mermaid-diagrams`	화면당 하나의 Anton 규칙이 적용됩니다. 큰 통계에는 `<CounterUp>`을 사용합니다. 히어로/기본 CTA에만 글로우를 사용합니다.
게임 / 인터랙티브 3D 경험 (YUV.AI 용)	`yuv-design-system` (네온 모드)	Three.js · 트위닝에 `gsap` · 게임이 릴 캡처 대상이면 `hyperframes`	면처리된 브랜드 색상 기하학. 풍부한 검정 캔버스에 분홍/시안 악센트가 가장 강력한 룩입니다.
프로모션 비디오 / 릴 / 쇼트 / TikTok / Shorts (Yuval 등장)	`yuv-viral-video`	`video-use` (컷) · `hyperframes` (구성 레이어) · `gsap` (모션 그래픽) · 타입/팔레트 오버레이 결정을 위한 `yuv-design-system` · 선택적으로 컷어웨이 이미지용 `nano-banana-pro`	항상 9:16과 16:9를 모두 렌더링합니다. `_V<N>` 접미사로 저장합니다. 고정된 YUV.AI 편집 스타일 — MrBeast 페이싱, 시그니처 글래스 카드.
자막 비디오 / 튜토리얼 / 토킹헤드 (자막 포함) (히브리어, 영어 또는 Whisper 지원 언어)	`video-edit`	`hyperframes` · `hyperframes-cli` · YUV.AI 브랜드인 경우 타입/팔레트 결정을 위한 `yuv-design-system` · 전사용 Whisper (large-v3 기본값)	`yuv-viral-video`보다 더 일반적입니다 — 대본 검토 후 렌더링 워크플로우, 이중 화면비(16:9 + 9:16 동일 소스), 리퀴드-글래스 캡션 알약. 사용자가 바이럴 MrBeast 템포 쇼트보다는 자막이 있는 쇼케이스를 원할 때 사용합니다.
시네마틱 / 시네마틱 AI 생성 비디오 / 3D 가상 촬영 (YUV.AI 용)	`cinematic-ai-video` (가능한 경우)	`hyperframes` · 오버레이 타이포그래피용 `yuv-design-system` · `nano-banana-pro`	소스가 편집된 영상이 아닌 완전 AI 생성일 때 사용합니다.
시그니처 비디오 배너 (YUV.AI 랜딩 페이지 상단의 시네마틱 루핑 iframe)	`yuv-design-system` (네온 사이트 + Hyperframes 호환 구성)	`hyperframes` (배너 렌더링) · `gsap` (애니메이션)	패턴은 `yuv-design-system/references/presentations.md` § 시그니처 비디오 배너에 문서화되어 있습니다.
소셜 카드 / OG 이미지 / 인스타그램 정사각형 / 포스터 (YUV.AI 용)	`yuv-design-system` (네온 모드 — 또는 Hope/실용적인 경우 따뜻한 편집 모드)	브랜드 내 이미지용 `nano-banana-pro` · 기술 다이어그램이면 `mermaid-diagrams`	오른쪽 아래 워터마크, 바닥글이 있으면 정식 소셜 링크.
발표자 약력 / About 카드 / "호스트 소개"	`yuv-design-system` (네온 모드)	정식 자격 증명 블록 (2× GitHub Star, AWS Gen AI Superstar, Channel 12 News, AI Builder & Speaker, Founder YUV.AI) + 정식 소셜 링크	사진은 항상 `assets/profile-yuval-studio.png`를 사용합니다.
Hope / Marcus / bigcats.ai / practical.yuv.ai (코스 랜딩)	`yuv-design-system` (따뜻한 편집 모드)	`hope-born-to-run` (Hope/Marcus 캠페인인 경우) · 야생동물 클립용 `cinematic-ai-video` · 편집 이미지용 `nano-banana-pro`	순수 `#FFFFFF`를 금지하는 유일한 모드입니다. 종이 질감 필수.
크로스채널 런칭 (사이트 + 데크 + 릴 + 소셜 카드 + 이메일)	yuv-pilot이 계속 로드됨	위의 각각을 순서대로 호출합니다. 빌드 순서 권장: 디자인 시스템 + 브랜드 에셋 우선 → 데크 (토크용) → 사이트 (랜딩용) → 릴 (배포용) → 소셜 카드 (증폭용) → 이메일 (리스트용).	이것이 정식 다중 매체 사례입니다. 먼저 디자인 시스템 표면을 구축하고 나머지는 그것을 차용합니다.

§3. 실제 예제

예제 A — "내 다음 AI 토크를 위해 뭔가 만들어 줘"

판단: YUV.AI 신호 ✓ (그의 토크입니다), 매체 = 데크. 단일 매체 → yuv-decks로 직접 라우팅, yuv-pilot이 관여할 필요 없음.

전달 응답:

yuv-decks를 로딩합니다 — 4막 서사로 open-slide 프로젝트를 생성할 것입니다.

yuv-pilot — YUV.AI 기술 피라미드