Communitygithub.com

SaaS 데모 비디오 (mertz1999/luma-assistant)

시네마틱한 SaaS 데모 비디오 페이지와 화면 녹화 가능한 제품 프레젠테이션을 제작합니다. Codex가 /demo 라우트, 애니메이션 제품 둘러보기, SaaS 홍보 프레젠테이션, 화면 녹화 페이지, 내레이션 제품 데모, 커서 기반 UI 스토리, 또는 앱/웹사이트용 재사용 가능한 데모 비디오 시스템을 구축하도록 요청받을 때 사용하세요.

luma-assistant)란 무엇인가요?

이 스킬은 전체 화면, 자동 이동 데모 페이지를 구축하여 세련된 SaaS 제품 비디오로 녹화할 수 있도록 설계되었습니다. 기능 둘러보기보다는 짧은 고객 스토리(문제 연결, 제품 액션, 고객 순간, 결과 공개, 비즈니스 성과, 최종 CTA)를 우선시합니다. Next.js, React 등 기존 스택을 활용하며, Framer Motion을 사용한 장면 전환, 부드러운 커서 움직임, 리얼 앱 UI 모형(브라우저/폰 프레임 내부), 오버레이 캡션, 리절트 리빌(reveal) 애니메이션을 지원합니다. 현재 시간 기반 타임라인을 사용하여 개발 중 핫 리로드에도 재생이 리셋되지 않으며, 생성된 오디오 타임스탬프와 동기화할 수 있습니다. 제품의 실제 동작을 정확히 반영하고, 가짜 기능을 만들어내지 않습니다.

지원 대상~Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/mertz1999/luma-assistant/tree/HEAD/skills/saas-demo-video

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

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

문서

SaaS 데모 비디오

결과물

전체 화면, 자동 이동 데모 페이지를 구축하여 세련된 SaaS 제품 비디오로 녹화할 수 있도록 합니다. 기능 둘러보기보다는 짧은 고객 스토리를 선호합니다: 문제 연결, 제품 액션, 고객 순간, 결과 공개, 비즈니스 성과, 최종 CTA.

이 스킬을 사용하여 /demo, /presentation, /video-demo 또는 이와 동등한 독립 HTML/React 페이지와 같은 라우트를 생성하거나 개선하세요.

필수 입력 사항

구현 전에 다음을 수집하거나 유추하세요. 차단 요소가 있는 경우에만 질문하세요.

  • 제품명, 도메인, 대상 청중, 주요 약속.
  • 대상 길이 및 화면 비율 (보통 30-60초, 16:9).
  • 보여줄 기존 앱 라우트: 가입, 대시보드, 제품 생성, 링크 생성, 고객 페이지, 분석.
  • 브랜드 에셋: 로고, 색상, 글꼴, 제품 이미지, 고객 이미지, 스크린샷, 아이콘, 폰 프레임.
  • 실제 워크플로우 제약 조건: 앱이 실제로 하는 일, 수동 작업, 자동 작업, 사용 가능한 데이터.
  • 나레이션 스크립트 또는 타임라인. 사용자가 오디오를 생성했다면 정확한 타임스탬프를 사용하세요.
  • 최종 CTA 및 녹화 URL.

제품이 지원하지 않는 동작을 절대 만들어내지 마십시오. 상점에서 수동으로 링크를 복사한다면 앱이 자동으로 보낸다고 말하는 대신 그렇게 말하세요.

스토리보드

기본 30-50초 구조:

  1. 문제 연결: 현실적인 고객 질문이나 고통을 보여줍니다.
  2. 관리자 액션: 제품 추가, 비공개 링크 생성, 메시지 복사.
  3. 고객 순간: 고객이 링크를 받고, 열고, 이미지를 업로드하고, 생성 시작.
  4. 결과 공개: 이전/제품/결과를 깔끔한 공개 애니메이션과 함께 나란히 보여줍니다.
  5. 비즈니스 성과: 중요한 대시보드 지표.
  6. 최종 CTA: 짧은 제품 약속 및 도메인.

앱의 실제 도메인과 실제 제품 언어를 사용하세요. 소셜 커머스의 경우, 제품이 실제로 Instagram API와 통합하지 않는 한 시각적 스토리 장치로만 Instagram 스타일 DM UI를 표시하세요.

구현 패턴

앱의 기존 스택을 사용하세요. Next.js 앱의 경우 다음을 선호합니다:

  • src/app/demo/page.tsx와 같은 라우트.
  • 시간 제어 프레젠테이션용 클라이언트 컴포넌트.
  • 장면 전환, 커서 움직임, 공개 효과, 샤이머, 줌을 위한 Framer Motion.
  • 기존 UI 컴포넌트, 로고, 팔레트 및 에셋.
  • 쿼리 파라미터 장면 미리보기 (예: /demo?scene=resultReveal).

핵심 데모 컴포넌트 동작:

  • 장면을 데이터로 정의: id, title, caption, durationMs, cursor, 선택적 시각적 포커스/카메라 메타데이터.
  • durationMs에서 장면 시작 시간을 계산합니다.
  • 벽시계 타임라인을 사용하여 개발 핫 리로드나 리렌더링이 예기치 않게 재생을 재설정하지 않도록 합니다.
  • 사용자가 순수 녹화 페이지를 원하지 않는 한 재생, 일시 정지, 다시 시작, 이전, 다음 컨트롤을 추가합니다.
  • 생성된 오디오와 동기화하는 경우 장면 길이를 오디오 타임스탬프 범위와 정확히 일치시킵니다.
  • 중요한 UI 컨트롤에 data-demo-cursor-target 속성을 추가하고 getBoundingClientRect()에서 커서 위치를 계산합니다. 실제 대상이 있는 경우 하드코딩된 커서 좌표를 피하세요.
  • ResizeObserver와 requestAnimationFrame을 사용하여 뷰포트 크기 전반에 걸쳐 커서 대상의 정확성을 유지합니다.
  • 축소된 동작 설정을 존중합니다.

시각적 방향

현대적인 SaaS 런칭/데모 비디오처럼 느껴지도록 만듭니다:

  • 전체 화면 스테이지, 일반 문서 페이지가 아닙니다.
  • 중요한 클릭에 시네마틱 줌인.
  • 이전 커서 위치에서 계속되는 부드러운 커서 움직임.
  • 짧은 오버레이 캡션: "1. 제품 추가", "2. 링크 보내기", "3. 고객이 시도해 봄".
  • 브라우저/폰 프레임 내부의 실제 앱 스크린샷 또는 현실적인 UI 모형.
  • 플래시, 와이프, 흐림에서 선명으로, 또는 나란히 비교하는 결과 공개 순간.
  • 2-4개의 높은 신호 지표가 있는 깔끔한 대시보드 결과 샷.
  • 빽빽한 단락, 개발자 로그, 가짜 기술 용어 없음.

모바일 고객 흐름의 경우 폰 프레임을 사용하세요. 데스크탑 및 모바일 녹화 뷰포트에서 내부 콘텐츠가 읽기 쉬운지 확인하세요.

나레이션 및 타이밍

사용자에게 나레이션이 필요하면 음성 모델에 대한 프롬프트를 제공하세요:

  • 톤: 자신감, 따뜻함, 프리미엄, 명확함, 로봇 같지 않음.
  • 속도: 대상 길이와 일치.
  • 제품명 발음 참고 사항.
  • 장면별 타임스탬프 스크립트.

사용자가 생성된 오디오 타임스탬프를 제공하면 장면 길이를 해당 정확한 범위로 업데이트하고 총 길이를 확인하세요.

재사용 가능한 타이밍 및 나레이션 템플릿은 references/storyboard-and-voiceover.md를 참조하세요.

검증

완료 전:

  • 앱을 로컬에서 실행하거나 기존 개발/프로덕션 서버를 확인합니다.
  • 관련 검사 실행: 타입체크, 린트, 빌드 또는 프레임워크 동등 검사.
  • 데스크탑 및 모바일 크기에서 Playwright/브라우저 검사를 사용합니다.
  • 수평 오버플로우가 없는지 확인합니다.
  • 폰 프레임 콘텐츠가 보이는지 확인합니다.
  • DOM 대상 측정을 사용하여 커서가 의도한 버튼에 도달하는지 확인합니다.
  • 구현된 경우 각 미리보기 장면이 쿼리 파라미터를 통해 작동하는지 확인합니다.
  • 최종 공개 URL 또는 로컬 URL이 200 OK를 반환하는지 확인합니다.
  • 비디오 iframe이 임베드된 경우 iframe이 렌더링된 HTML에 있는지 확인합니다.

공개 IP 개발 서버의 Next HMR WebSocket 실패와 같은 알려진 개발 전용 경고는 별도로 보고하세요.

전달 결과물

다음을 반환하세요:

  • 데모 페이지 URL.
  • 추가되거나 변경된 라우트/파일.
  • 장면 길이 테이블.
  • 요청 시 나레이션 프롬프트.
  • 검증 명령어/결과.
  • 녹화 참고 사항 (예: 권장 뷰포트 크기 및 컨트롤 숨김 여부).

관련 스킬