Communitygithub.com

Helios 소셜 프루프 비디오 생성기

리포지토리에서 브랜드 아이덴티티를 추출하고, 따뜻한 배경 음악을 생성하며, 신뢰를 구축하는 motion.dev 기반 동영상을 Helios CLI로 렌더링하는 엔드투엔드 가이드 워크플로우입니다. 고객 추천사, 리뷰 하이라이트, 또는 소셜 프루프 동영상 제작에 사용하세요.

Helios 소셜 프루프 비디오 생성기란 무엇인가요?

이 스킬은 AI 에이전트가 브랜드 리포지토리 또는 제공된 URL을 분석하여 브랜드 아이덴티티를 자동으로 추출하고, ElevenLabs를 통해 맞춤형 배경 음악을 생성하며, motion.dev 기반의 시각적 구성을 만들어 신뢰를 구축하는 소셜 프루프 또는 추천사 동영상을 제작하는 완전한 파이프라인을 제공합니다. Helios CLI를 사용하여 DOM 모드로 렌더링하며, 비트 동기화된 장면 전환과 명확한 타이핑 효과 등이 적용됩니다. 사용자는 단순히 브랜드 컨텍스트(리포지토리 또는 URL)와 동영상 길이만 제공하면 되며, 스킬이 자동으로 브랜드 톤, 색상, 타이포그래피를 분석하고, 인용문과 통계를 시각화하며, 최종 MP4 파일을 출력합니다. 이 스킬은 Claude Code, Cursor, Codex 등 모든 AI 에이전트 플랫폼에서 사용할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BintzGavin/helios-skills/tree/HEAD/skills/guided/testimonial-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 구조

내부 브랜드 프로필 구성:

• 핵심 가치 제안 • 타겟 대상 • 톤 (따뜻함, 진정성, 신뢰감) • 시각적 밀도 • 기본 팔레트 • 악센트 팔레트 (신뢰를 위한 따뜻한 톤) • 타이포그래피 특성 • 소셜 프루프 전략 (인용문, 통계, 로고 또는 조합)

모든 창의적 결정은 이 프로필과 일치해야 합니다.


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

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

다음 조건과 일치하는 악기 트랙을 생성하세요:

• 따뜻하고 고양되는 분위기 • 감정적 절정을 향한 부드러운 빌드업 • 영감을 주지만 공격적이지 않음 • 대상 런타임

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


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

추출:

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

비트 타이밍 맵을 생성하세요.

인용문 공개는 다운비트에 맞춰야 합니다. 이름/직함 공개는 비트에 맞춰야 합니다.


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

크리에이티브 사양을 생성하기 전에 다음을 읽고 내면화하세요:

skills/guided/motion-design-rules

해당 스킬의 모든 규칙은 이 구성에 필수 사항입니다.


7단계 — 크리에이티브 사양 생성

당신은 Helios를 위해 motion.dev를 사용하여 디자인하는 수석 크리에이티브 디렉터이자 브랜드 신뢰 설계자입니다.

입력 예시: 30초 추천사 동영상 만들기

출력:

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

사양에는 다음이 포함되어야 합니다:

• 길이 • 화면 비율 (16:9) • 브랜드 요약 • 모션 언어 (따뜻함, 우아함, 의도적) • 비트 동기화 장면 분석 • 정확한 타임스탬프 • 음성 해설 (선택 사항 — 텍스트 전용 접근 가능) • 화면 텍스트 (인용문, 출처, 통계, CTA) • 시각적 구성 (인용문 카드, 아바타, 별점, 고객 로고) • 명시적 motion.dev 애니메이션 동작 • 전환 로직 (부드러운 페이드, 소프트 슬라이드, 미묘한 스케일) • 레이어링 순서 (배경 텍스처 → 인용문 카드 → 아바타/사진 → 출처 → 통계) • 오디오 방향 • 에셋 요구 사항 • 타이포그래피 계층 구조 (인용문 텍스트 크게, 출처 더 작게, 통계 눈에 띄게)

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

추천사 구조 요구 사항:

• 오프닝 브랜드 순간 또는 컨텍스트 설정 (2-3초) • 인용문 1: 전체 인용문과 출처 • 인용문 2: 전체 인용문과 출처 (길이가 허용하는 경우) • 소셜 프루프 통계 (숫자, 평점, 고객 수) • 브랜드 마크가 있는 클로징 CTA

각 인용문 세그먼트: • 인용문 텍스트가 애니메이션으로 나타남 (타자기 효과 또는 줄별 페이드 인) • 읽기를 위한 짧은 일시 중지 • 출처 표시 (이름, 직함, 회사) • 선택 사항: 고객 회사 로고 또는 아바타


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 애니메이션이 올바르게 동기화되어야 함 • 무작위성 없음 • 결정적 타이밍 • 인용문은 각각 최소 4초 동안 읽을 수 있어야 함 • 별점은 순차적으로 애니메이션되어야 함


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

다음으로 렌더링하세요:

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

요구 사항:

• 16:9 화면 비율 • 정확한 길이 • 오디오 첨부 • CSS 및 WAAPI 완전 동기화 • 고품질 MP4 출력

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

output.mp4


런타임 규칙

길이가 15초 이하인 경우 1개의 인용문 + 1개의 통계 + CTA를 표시하세요. 가장 강력한 인용문을 우선시하세요.

길이가 지정되지 않은 경우 기본값은 30초입니다.

모든 길이에서 최대 3개의 인용문. 인용문은 실제 또는 대표적이어야 하며 절대 허위로 만들지 마세요. 리포지토리에 추천사가 없는 경우 명확한 레이블과 함께 플레이스홀더 구조를 사용하세요.

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

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 promotional hype video. Extracts brand identity from the repo, generates beat-synced music, and produces a high-energy motion.dev composition rendered via Helios CLI. Use when making brand-aligned promo or hype 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.

관련 스킬