Communitygithub.com

BintzGavin/helios-skills

엔드투엔드 가이드 워크플로우로 브랜드 홍보 하입 비디오를 제작합니다. 리포지토리에서 브랜드 아이덴티티를 추출하고, 비트 동기화 음악을 생성하며, Helios CLI를 통해 고에너지 motion.dev 컴포지션을 렌더링합니다. 브랜드에 맞는 프로모션이나 하입 비디오를 만들 때 사용하세요.

helios-skills란 무엇인가요?

이 스킬은 브랜드 리포지토리나 URL에서 브랜드 아이덴티티를 분석하여, 맞춤형 홍보 하입 비디오를 제작하는 완전 가이드 워크플로우를 제공합니다. 사용자는 먼저 브랜드 컨텍스트(리포지토리 또는 URL)와 배경 음악 생성 여부를 설정합니다. 이후 Helios 런타임 의존성을 설치하고, 브랜드 정보(Tailwind 설정, 디자인 토큰, 로고, 마케팅 카피 등)를 추출하여 브랜드 프로필을 구성합니다. 필요시 ElevenLabs API를 사용해 브랜드 톤에 맞는 음악을 생성하고, ffmpeg로 비트와 에너지 피크를 분석해 타이밍 맵을 만듭니다. motion-design-rules를 읽고 적용한 후, motion.dev 호환 언어로 크리에이티브 스펙을 작성한 뒤, HTML+CSS+motion.dev로 컴포지션을 구현하고 Helios CLI(DOM 모드)로 렌더링하여 output.mp4를 출력합니다. 이 스킬은 Claude Code, Cursor, Codex 등 Helios CLI와 motion.dev를 지원하는 모든 플랫폼에서 사용할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BintzGavin/helios-skills/tree/HEAD/skills/guided/promo-video

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

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

문서

브랜드의 리포지토리 내에서 작업 중일 수도 있고, 외부 컨텍스트에서 작업 중일 수도 있습니다.

브랜드 아이덴티티를 추측하지 마세요. 코드베이스를 분석하거나 제공된 URL을 연구하세요.


실행 파이프라인

1단계 — 컨텍스트 수집

⛔ 중지. 사용자에게 다음 두 가지 질문을 하세요:

  1. "브랜드의 리포지토리 안에 계신가요, 아니면 브랜드를 온라인에서 조사할 수 있도록 URL(예: 마케팅 사이트)을 제공하시겠습니까?"

  2. "배경 음악을 생성하시겠습니까? '예'라고 답하시면 환경에 ELEVEN_LABS_API_KEY가 필요합니다. https://elevenlabs.io → 프로필 → API 키에서 받을 수 있습니다."

사용자가 두 질문에 모두 응답할 때까지 기다리세요.

.env 파일을 읽거나 키를 직접 확인하지 마세요. 사용자의 응답을 신뢰하세요.

사용자가 URL을 제공하면 3단계에서 코드베이스 대신 해당 URL을 브랜드 조사에 사용하세요. 사용자가 음악 생성을 거부하면 4단계와 5단계를 건너뛰세요.


2단계 — Helios 런타임 의존성 확인

필요한 패키지 설치:

npm install @helios-project/core @helios-project/renderer @helios-project/cli

DOM 모드를 사용하여 렌더링합니다.


3단계 — 리포지토리에서 브랜드 인텔리전스 추출

사용자가 리포지토리 대신 URL을 제공한 경우, 해당 URL을 가져와 라이브 사이트에서 동일한 브랜드 신호를 추출하세요. 코드베이스별 항목(Tailwind 설정, 디자인 토큰 등)은 건너뛰고 보이는 브랜드 요소에 집중하세요.

분석:

• Tailwind 설정 또는 CSS 변수 • 전역 스타일시트 • 디자인 토큰 • 로고 에셋 • 파비콘 • 히어로 섹션 • 마케팅 카피 • CTA 구조 • 제품 포지셔닝 • UI 컴포넌트 • 기존 모션 사용

내부 브랜드 프로필 구성:

• 핵심 가치 제안 • 타겟 오디언스 • 톤 앤 보이스 • 시각적 밀도 • 기본 팔레트 • 엑센트 팔레트 • 타이포그래피 특성 • 감성적 포지셔닝

모든 크리에이티브 결정은 이 프로필과 일치해야 합니다.


4단계 — 오리지널 음악 생성 (음악 없음 시 건너뛰기)

기존 ELEVEN_LABS_API_KEY로 ElevenLabs를 사용하세요.

다음에 맞는 악기 트랙 생성:

• 브랜드 톤 • 감성적 아크 • 목표 런타임

오디오를 로컬에 저장하세요.


5단계 — ffmpeg로 오디오 분석 (음악 없음 시 건너뛰기)

추출:

• BPM • 비트 타임스탬프 • 다운비트 • 에너지 피크

비트 타이밍 맵 생성.

모든 애니메이션은 이 타이밍 맵과 정렬되어야 합니다.


6단계 — 모션 디자인 규칙 읽기

크리에이티브 스펙을 생성하기 전에 다음을 읽고 숙지하세요:

skills/guided/motion-design-rules

해당 스킬의 모든 규칙은 이 컴포지션에 필수입니다.


7단계 — 크리에이티브 스펙 생성

당신은 Helios를 위해 motion.dev를 사용하여 디자인하는 시니어 크리에이티브 디렉터이자 모션 시스템 아키텍트입니다.

입력 예시: 15초 하입 비디오 만들기

출력:

• 하나의 구조화된 크리에이티브 스펙 • 단일 코드 블록으로 감싸기 • 블록 외부에는 설명 없음

스펙에는 다음이 포함되어야 합니다:

• 지속 시간 • 가로세로 비율 • 브랜드 요약 • 모션 언어 • 비트 동기화된 장면별 분석 • 정확한 타임스탬프 • 내레이션 • 화면 텍스트 • 시각적 구성 • 명시적인 motion.dev 애니메이션 동작 • 전환 로직 • 레이어링 순서 • 오디오 방향 • 에셋 요구 사항

motion.dev 호환 용어만 사용하세요.


8단계 — DOM 기반 Helios 컴포지션 구현

크리에이티브 스펙을 사용하여:

composition.html 파일 생성:

• HTML + CSS + motion.dev 사용 • WAAPI / CSS / motion.dev를 사용한 애니메이션 구현 • 비트 타임스탬프에 애니메이션 정렬 • 생성된 오디오 파일 포함 • 정확한 지속 시간

Helios 런타임 노출:

import { helios } from "@helios-project/core";

window.helios = helios;

helios.bindToDocumentTimeline({
  autoSyncAnimations: true
});

요구 사항:

• window.helios가 정의되어야 함 • helios.bindToDocumentTimeline()이 호출되어야 함 • autoSyncAnimations: true가 활성화되어야 함 • 모든 CSS 및 WAAPI 애니메이션이 올바르게 동기화되어야 함 • 무작위성 없음 • 결정적 타이밍


9단계 — 공식 Helios CLI를 사용하여 렌더링 (DOM 모드)

다음으로 렌더링:

npx @helios-project/cli render ./composition.html -o output.mp4

요구 사항:

• 올바른 가로세로 비율 • 올바른 지속 시간 • 오디오 첨부 • CSS 및 WAAPI 완전 동기화 • 고품질 MP4 출력

출력 파일은 다음과 같아야 합니다:

output.mp4


런타임 규칙

지속 시간 ≤ 15초인 경우 펀치와 명확성을 우선시하세요.

지속 시간이 지정되지 않은 경우 기본값 30초.

원래 프롬프트를 다시 말하지 마세요. 추론을 설명하지 마세요. 크리에이티브 스펙은 단일 코드 블록 내에서만 출력해야 합니다.

Individual skills in this repo

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

BintzGavin/helios-skills

Make a video, MP4, GIF, animation, music video, short film, explainer, chart animation, product demo, logo reveal or social clip from code. Write one HTML page that draws any frame from its time t, render it frame-exact to MP4 with Helios, check stills and contact sheets, and add a soundtrack. Use whenever the user asks for a video or an animation file.

BintzGavin/helios-skills

>- Story-first motion design philosophy for animated video: motion must earn its place; arc (establish, complicate, resolve); show vs tell; shots as units of thought; quiet vs loud motion; Disney principles with restraint; timing heuristics; composition; grammar by medium (product demos, logos, data viz, explainers); technical commitments (deterministic time, scrubbability, refs); cutting discipline; explicit anti-patterns. Use when planning, storyboarding, critiquing, or implementing programmatic or motion-driven video (Helios, Remotion, explainers, loops, UI capture, logo reveals), or when the user asks for motion direction, pacing, or visual-story structure.

BintzGavin/helios-skills

>- End-to-end production plan template for feeling-first cinematic product promos: brief interrogation, 45s beat structure (cold open through brand), hero-element metaphor, storyboard fidelity ladder, visual system (palette, type, camera, texture), motion mix and easing vocabulary, audio and captions, tooling (animatic through HTML or AE), deliverables matrix, accessibility, review milestones, and compromises to accept or refuse. Use when planning, pitching, storyboarding, or producing polished brand films for any SaaS or consumer product—not category-specific; pair with skills/design/animated-video-philosophy for broader motion principles.

BintzGavin/helios-skills

Patterns for using Helios with Framer Motion. Use when you want to use Framer Motion's physics and transitions but need frame-perfect synchronization with Helios.

BintzGavin/helios-skills

Patterns for using Helios with GSAP (GreenSock). Use when integrating GSAP timelines with the Helios timeline for precise scrubbing and rendering.

BintzGavin/helios-skills

End-to-end guided workflow for creating an explainer or walkthrough video. Extracts brand identity from the repo, generates a measured soundtrack, and produces a narrative-driven motion.dev composition rendered via Helios CLI. Use when making how-it-works, feature walkthrough, or educational videos.

BintzGavin/helios-skills

Motion design framework for programmatic video. Defines anti-slideshow architecture, visual layering, physics-based easing, choreography rules, and quality validation. Reference this skill from any guided video skill.

BintzGavin/helios-skills

End-to-end guided workflow for creating a social proof or testimonial video. Extracts brand identity from the repo, generates a warm soundtrack, and produces a trust-building motion.dev composition rendered via Helios CLI. Use when making customer testimonial, review highlight, or social proof videos.

BintzGavin/helios-skills

Workflow for rendering a Helios composition to a video file. Use when you need to automate video production or export a high-quality animation.

관련 스킬