Communitygithub.com

oyi77/1ai-skills

임의의 텍스트(기사, 노트, 주제, 브리핑)를 HyperFrames를 사용한 얼굴 없는 설명 영상으로 변환합니다. 사용자가 제품/웹사이트 캡처 없이 주제 설명, 개념 분석, 사용법, 또는 리스트 형식 영상을 원할 때 사용하세요. 모든 장면은 시각적으로 새롭게 만들어집니다(타이포그래피, 추상 그래픽, 다이어그램, 데이터 시각화). 웹사이트 기반 영상이 아닙니다(웹사이트 기반은 hyperframes-product-launch-video 사용).

1ai-skills란 무엇인가요?

이 스킬은 AI 에이전트가 임의의 텍스트 입력(기사, 노트, 주제, 브리핑)을 바탕으로 전문적인 '얼굴 없는' 설명 영상을 제작할 수 있도록 설계되었습니다. HyperFrames 프레임워크를 활용하며, 시각 자료는 실제 자산을 캡처하지 않고 타자학, 추상 그래픽, 다이어그램, 데이터 시각화 등으로 완전히 새롭게 발명됩니다. 주요 사용 사례는 제품/웹사이트 캡처가 필요 없는 주제 설명, 개념 분석, 사용법/튜토리얼, 리스트클 등입니다. 워크플로우는 브리핑 작성, 디자인 시스템 선택(프레임 프리셋), 내러티브 중심의 스토리보드 및 스크립트 작성, 음성/배경음악 생성, 각 프레임별 시퀀스 디자인, 최종 렌더링 순으로 진행됩니다. 이 스킬은 Claude, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 사용 가능하며, 각 단계별로 명확한 CLI 명령어와 검증 체크리스트를 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/oyi77/1ai-skills/tree/HEAD/content/hyperframes-faceless-explainer

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

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

문서

개요

이 스킬은 얼굴 없는 설명 영상 — 나레이션 기반, 출연자 없는 — 을 HyperFrames 구성을 통해 제작합니다. 보이스오버와 시각 자료가 메시지를 전달하는 제품 또는 개념 설명용으로 사용하세요. 제공된 스크립트로 최종 MP4를 렌더링합니다.

HyperFrames — 얼굴 없는 설명 영상

임의의 텍스트를 설명 영상으로 변환하세요: 디자인 시스템을 선택하고, 교육적인 스토리를 계획한 후, 프레임 단위로 제작합니다. 얼굴 없음이란 모든 시각 자료가 발명된다는 뜻입니다 — 캡처 단계나 실제 자산 인벤토리가 없습니다.

사용 시기

  • 사용자가 기사, 노트, 브리핑을 바탕으로 주제 설명 영상을 원할 때
  • 사용자가 개념 분석 (어떤 것이 어떻게 작동하는지)을 원할 때
  • 사용자가 사용법/튜토리얼 (화면 캡처 없음)을 원할 때
  • 사용자가 리스트클 또는 애니메이션 리스트를 원할 때
  • 사용자가 데이터 기반 설명 영상 (차트, 통계, 비교)을 원할 때

사용하지 말아야 할 때

  • 사용자가 제품 출시 영상을 원할 때 (hyperframes-product-launch-video 사용)
  • 사용자가 출연자 영상을 원할 때 (hyperframes-embedded-captions 사용)
  • 사용자가 모션 그래픽을 원할 때 (hyperframes-motion-graphics 사용)
  • 사용자가 웹사이트를 캡처하려 할 때 (hyperframes-product-launch-video 사용)

워크플로우

0 · 설정

npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=faceless-explainer

초기화 직후 BRIEF.md를 작성하세요 (절대 초기화 전에 작성하지 마세요 — init는 비어 있지 않은 디렉토리를 거부합니다). node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . 명령으로 선호도를 기록하세요.

1 · 브리프 (캡처 없음)

사용자의 전체 입력을 그대로 저장합니다:

  • capture/extracted/visible-text.txt — 전체 기사/노트/주제/브리핑
  • capture/extracted/tokens.json — { "title": "", "description": "", "colors": [], "fonts": [] }

npx hyperframes capture를 실행하지 마세요 — URL이 없습니다. 얼굴 없는 시각 자료는 이후 단계에서 발명됩니다.

2 · 디자인 시스템

주제, 어조, 대상에 맞는 프레임 프리셋을 선택하세요:

node <SKILL_DIR>/scripts/build-frame.mjs --preset <이름> --hyperframes .

이 명령은 프리셋의 FRAME.md를 frame.md로 복사하고 브랜드 토큰을 리믹스합니다. 얼굴 없는 설명 영상은 일반적으로 브랜드 색상/폰트가 없으므로 — 스크립트가 프리셋의 자체 팔레트를 유지합니다.

3 · 스토리보드 및 스크립트

텍스트를 프레임별 교육 계획으로 전환합니다. 영상의 순서는 내러티브 디자인에 의해 결정되며, 입력 텍스트의 단락 순서가 아닙니다 — 재정렬, 병합, 생략, 압축하세요.

STORYBOARD.md와 (나레이션이 필요할 때) SCRIPT.md를 작성하세요. 각 프레임에는 다음이 필요합니다:

  • focal / roles — 발명된 시각 요소 (히어로 단어, 다이어그램 노드, 데이터 시각화 계열)
  • blueprint — 샷 모양 (hyperframes-animation/blueprints/에서)
  • transition_in — 프레임이 진입하는 방식

3.1 · 오디오

node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json --voice <음성-id> &

파이프라인 기본 음성: Marcia (여성) (HeyGen) / am_michael (Kokoro). BGM 분위기는 스토리보드의 music: 필드에서 결정됩니다.

표준 무음 표시: STORYBOARD.md 상단 YAML 블록에 music: none 그리고 SCRIPT.md 없음 = 완전 무음 프로젝트.

4 · 프레임 시각 디자인

모든 프레임에 대해 시간 코드가 있는 샷 시퀀스를 작성하세요:

  • 프레임의 청사진을 선택 (또는 구성)
  • 이 프레임의 발명된 콘텐츠로 청사진을 인스턴스화
  • 각 장면의 공개를 보이스오버에 맞춰 프레임이 전체 지속 시간 동안 전개되도록 속도 조절

레이아웃과 모션은 장면별로 인라인으로 지정하세요. 영상 전반에 걸친 ## Video direction 블록을 하나 추가하세요.

5 · 프레임 제작

3.1단계 오디오가 완료될 때까지 기다리세요. 그런 다음:

node <SKILL_DIR>/scripts/audio.mjs sync-durations --audio-meta ./audio_meta.json --storyboard ./STORYBOARD.md
node <SKILL_DIR>/scripts/audio.mjs fetch-sfx --storyboard ./STORYBOARD.md --hyperframes .
node <SKILL_DIR>/scripts/frame-packets.mjs --project "$PROJECT_DIR" --storyboard "$PROJECT_DIR/STORYBOARD.md"

프레임당 하나의 하위 에이전트를 파견합니다. 각 워커는 다음을 받습니다:

  • _role.md (프레임 워커 역할)
  • 해당 프레임의 패킷 (정확한 스토리보드 블록 + 청사진 본문 + 인용된 규칙 레시피, 인라인화됨)

워커는 compositions/frames/NN-*.html만 작성합니다. STORYBOARD.md는 절대 편집하지 않습니다.

전면 배경은 class="clip" 레이어에 적용되며, 절대 #root에 적용되지 않습니다. 프레임의 바탕은 자체 전체 지속 시간 배경 클립입니다.

백그라운드에서 자막을 제작하고 인덱스를 조합합니다:

node <SKILL_DIR>/scripts/captions.mjs build --storyboard ./STORYBOARD.md --audio-meta ./audio_meta.json --hyperframes . --out ./caption_groups.json &
node <SKILL_DIR>/scripts/assemble-index.mjs --storyboard ./STORYBOARD.md --hyperframes .

6 · 마무리

node <SKILL_DIR>/scripts/transitions.mjs inject --storyboard ./STORYBOARD.md --hyperframes .
node <SKILL_DIR>/scripts/transitions.mjs verify --storyboard ./STORYBOARD.md --index ./index.html
npx hyperframes lint
npx hyperframes check
npx hyperframes snapshot --at <프레임-중간점>

사용자 승인 후에만 렌더링하세요:

npx hyperframes render --skill=faceless-explainer --quality high --output renders/video.mp4

합리화 방지 표

합리화현실
"기사의 웹사이트를 캡처할게요"얼굴 없음 = 캡처 없음. 시각 자료는 발명되는 것이지 캡처되지 않습니다
"텍스트의 단락 순서를 사용할게요"내러티브 디자인이 순서를 결정하며, 원본 순서가 아닙니다
"디자인 시스템을 건너뛸게요"frame.md는 색상/타이포그래피/레이아웃의 진실 공급원입니다
"모든 콘텐츠를 미리 로드한 후 멈출게요"보이스오버에 맞춰 공개 속도를 조절 — 프레임이 전체 지속 시간 동안 전개됩니다
"청사진 하나만 작성해서 재사용할게요"각 프레임은 콘텐츠에 따라 자체 청사진을 선택합니다
"오디오를 건너뛰고 텍스트만 사용할게요"오디오는 시계입니다 — 모든 비트 시간은 단어 타임스탬프에서 비롯됩니다
"공개 사이에 유휴 애니메이션을 추가할게요"모든 단계가 공연됩니다 — 단계적 공개, 의도가 있는 카메라, 또는 순차적 UI
"자막 공간을 확보하려면 42%로 중앙 정렬할게요"자막은 오버레이입니다 — 실제 중앙을 기준으로 중앙 정렬하세요 (y = H/2)

검증

  • hyperframes.json과 BRIEF.md가 존재하는가
  • 명명된 프리셋에서 가져온 frame.md가 존재하는가
  • STORYBOARD.md가 필수 내러티브 필드와 함께 존재하는가
  • 나레이션이 필요할 때 SCRIPT.md가 존재하는가
  • 오디오 작업이 시작되었거나 프로젝트가 무음으로 표시되었는가
  • 모든 프레임이 보이스오버에 맞춰 시간 코드가 있는 샷 시퀀스를 가지고 있는가
  • 각 프레임이 발명된 focal 및/또는 roles를 명시하는가
  • index.html이 존재하는가
  • 자막이 제작되었거나 명시적으로 건너뛰었는가
  • 렌더링 전에 lint와 check가 통과되었는가
  • 사용자가 검토 일시 중지 시점에서 승인했는가

Individual skills in this repo

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

oyi77/1ai-skills

Turn a weekly changelog .md into a finished branded changelog video using HyperFrames. Use when the user provides a changelog/digest markdown and wants the weekly video, or says 'changelog video'. Self-contained — fonts, background, lexicon, and scripts ship in the skill. Produces square 1080, ~45-60s videos with animated brand mock-UIs.

oyi77/1ai-skills

The transition technique catalog for HyperFrames videos — five velocity-matched SEAMS (zoom-through, inverse zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus in-scene techniques (waterfall entry, nudge curve). Covers partial-travel velocity matching, Z scale-sign rule, size-scaled blur, the 10/65/25 slide ratio, and the 2-3 transition budget. Read before authoring any transition, text-beat handoff, or kinetic text entry.

oyi77/1ai-skills

Add captions/subtitles to talking-head or launch videos using HyperFrames. Use when the user wants embedded captions, verbatim caption rails, or cinematic text behind the subject. Covers the drop/rail/embed caption model, the overlay law (captions are NOT a reserved band), matte occlusion for embedded climaxes, and word-timestamp alignment from TTS output.

oyi77/1ai-skills

The fallback HyperFrames workflow for anything that doesn't fit other skills — longer multi-scene pieces, brand/sizzle reels, title cards, static loops, freeform compositions. Input- and length-agnostic. Also the home of companion mode (co-create with the full toolbox). Use when no other HyperFrames skill matches, or when the user wants a freeform video.

oyi77/1ai-skills

Create short, unnarrated, design-led motion graphics (~under 10s) using HyperFrames. Use when the user wants kinetic type, stat/chart hits, logo stings, lower-thirds, animated tweets/headlines, or transparent overlay motion graphics. MP4 or transparent overlay output. Teaches seek-safe keyframe authoring and the 2-3 transition budget rule.

oyi77/1ai-skills

Turn a music track into a beat-synced HyperFrames video — lyric, slideshow, or kinetic promo. Use when the user provides an audio file, a video to pull audio from, or a mood brief for generated music. Music drives pacing. Teaches beat-map extraction, section-based scene planning, and audio-reactive visuals.

oyi77/1ai-skills

Create product launch videos from a URL, brief, or script using HyperFrames (HTML→MP4). Use when the user wants a product launch video, site tour, social clip featuring a product's own visuals, or marketing/promoting a product. Up to ~3 min (sweet spot 30-90s). Teaches the HyperFrames production loop: plan → write HTML → wire seekable animations → add media → lint → preview → render.

oyi77/1ai-skills

The Video Production Manager — manages ALL video production under 1ai-content. Delegates to HyperFrames, Remotion, AI video, and FFmpeg based on the task. Has memory via 1ai-hub brain, follows 1ai-rules, and reports to Content Director. Use when the user says 'make a video', 'create video', 'edit video', 'video strategy', or needs any video production work.

oyi77/1ai-skills

Agent skill at content/video/gen/SKILL.md

oyi77/1ai-skills

Use when track portfolio company KPIs, variances, returns analysis. Use when user says "monitor portfolio", "track KPIs", "portfolio returns".

oyi77/1ai-skills

Use when go-to-market planning — launch sequencing, channel strategy, audience building, PR outreach. Use when planning product launches, building launch checklists, or coordinating multi-channel campaigns.

oyi77/1ai-skills

Use when portfolio manager — capital allocation, risk management, and performance metrics tracking for trading strategies.

관련 스킬