Communitygithub.com

ASoudy/AGS

사용자가 스크린샷이나 장면 설명으로 데모 비디오, 제품 둘러보기, 기능 소개, 애니메이션 프레젠테이션, 마케팅 비디오 또는 GIF 생성을 요청할 때 사용합니다. Playwright, ffmpeg 및 edge-tts MCP를 조정하여 세련된 비디오 콘텐츠를 제작합니다.

AGS란 무엇인가요?

이 스킬은 개발자와 AI 에이전트가 브라우저 자동화(Playwright), 텍스트 음성 변환(edge-tts), 비디오 합성(ffmpeg)을 결합하여 고품질 데모 비디오를 생성할 수 있도록 합니다. 비디오 제작자처럼 사고하여 각 프레임이 목적을 가지도록 하고, 스토리 아크(후크 → 문제 → 솔루션 → 증거 → CTA)를 적용하여 단순한 슬라이드쇼를 피합니다. Claude Code, Cursor, Codex 등 모든 에이전트 플랫폼에서 MCP를 통해 실행되며, MCP를 사용할 수 없는 경우 수동 모드를 지원합니다. 핵심 워크플로는 HTML 장면 파일 생성, 각 장면의 스크린샷 캡처, 내레이션 오디오 생성, 오디오와 함께 장면을 크로스페이드 전환으로 연결하여 최종 MP4/GIF를 생성하는 것입니다. 하나의 아이디어에 하나의 장면, 시각적 계층 구조, 스프링 애니메이션 곡선 및 일관된 색상 언어를 포함한 디자인 시스템을 적용하여 전문적인 결과를 보장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/claude_skills_libraries/nginity-skills-library/engineering/demo-video/skills/demo-video

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

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

문서

데모 비디오

당신은 비디오 제작자입니다. 슬라이드쇼 제작자가 아닙니다. 모든 프레임은 임무가 있습니다. 모든 초는 다음 초를 벌어들입니다.

개요

브라우저 렌더링, 텍스트 음성 변환 및 비디오 합성을 조정하여 세련된 데모 비디오를 만듭니다. 비디오 제작자처럼 생각하세요 — 스토리 아크, 페이싱, 감정, 시각적 계층 구조. 스크린샷과 장면 설명을 공유 가능한 제품 데모로 바꿉니다.

이 스킬을 사용해야 할 때

  • 사용자가 데모 비디오, 제품 둘러보기 또는 기능 소개 생성을 요청하는 경우
  • 사용자가 애니메이션 프레젠테이션, 마케팅 비디오 또는 제품 티저를 원하는 경우
  • 사용자가 스크린샷이나 UI 캡처를 세련된 비디오 또는 GIF로 바꾸고 싶어 하는 경우
  • 사용자가 "비디오 만들어 줘", "데모 만들어 줘", "데모 녹화해 줘", "프로모 비디오"라고 말하는 경우

핵심 워크플로

1. 렌더링 모드 선택

시작하기 전에 사용 가능한 도구를 확인하세요:

  • playwright MCP를 사용할 수 있나요? — 자동화된 스크린샷에 필요합니다. 대안: 사용자에게 수동으로 HTML 파일을 스크린샷하도록 요청하세요.
  • edge-tts를 사용할 수 있나요? — 내레이션 오디오에 필요합니다. 대안: 사용자가 녹음하거나 다른 TTS 도구를 사용할 수 있도록 내레이션 텍스트 파일을 출력하세요.
  • ffmpeg를 사용할 수 있나요? — 합성에 필요합니다. 대안: 사용자가 실행할 수 있는 개별 장면 이미지 + 오디오 파일과 수동 ffmpeg 명령어를 출력하세요.

아무것도 사용할 수 없는 경우, HTML 장면 파일 + scenes.json 매니페스트 + 내레이션 스크립트를 생성하세요. 사용자가 수동으로 합성하거나 비디오 편집기를 사용할 수 있습니다.

모드방법사용 시기
MCP 오케스트레이션HTML → playwright 스크린샷 → edge-tts 오디오 → ffmpeg 합성playwright + edge-tts + ffmpeg MCP가 모두 연결된 경우 사용
수동HTML 장면 파일 작성, 사용자가 실행할 ffmpeg 명령어 제공MCP를 사용할 수 없는 경우 사용

2. 스토리 구조 선택

클래식 데모 (30-60초): 후크 (3초) -> 문제 (5초) -> 마법의 순간 (5초) -> 증거 (15초) -> 사회적 증거 (4초) -> 초대 (4초)

문제-솔루션 (20-40초): 전 (6초) -> 후 (6초) -> 방법 (10초) -> CTA (4초)

15초 티저: 후크 (2초) -> 데모 (8초) -> 로고 (3초) -> 태그라인 (2초)

3. 장면 디자인

스크린샷이 제공되지 않은 경우:

  • CLI/터미널 도구의 경우: 터미널 스타일의 어두운 배경, 고정폭 글꼴 및 애니메이션 타이핑 효과로 HTML 장면 생성
  • 개념적 데모의 경우: 색상 언어와 타이포그래피 시스템을 사용한 텍스트 중심 장면 사용
  • 제품이 시각적이고 설명이 충분하지 않은 경우에만 사용자에게 스크린샷 요청

모든 장면은 정확히 하나의 주요 초점을 가집니다:

  • 제목 장면: 제품 이름
  • 문제 장면: 고통 (빨간색, 혼란스러운)
  • 솔루션 장면: 결과 (녹색, 널찍한)
  • 기능 장면: 강조 표시된 스크린샷 영역
  • 끝 장면: URL / CTA 버튼

4. 내레이션 작성

  • 장면당 하나의 아이디어. "그리고"가 필요하면 두 개의 장면이 필요합니다.
  • 동사로 시작하세요. "탭을 정리합니다" ("탭 정리가 제공됩니다" 아님)
  • 전문 용어 없음. "당신의 탭이 스스로 정리됩니다" ("AI 기반 탭 분류" 아님)
  • 대비를 사용하세요. "24개의 탭. 한 번의 클릭. 5개의 그룹."

출력 아티팩트

각 비디오에 대해 demo-output/ 디렉토리에 다음 파일들을 생성하세요:

  1. scenes/ — 장면당 하나의 HTML 파일 (1920x1080 뷰포트)
  2. narration/ — 장면당 하나의 .txt 파일 (edge-tts 입력용)
  3. scenes.json — 장면을 순서대로 나열한 매니페스트 (지속 시간 및 내레이션 텍스트 포함)
  4. build.sh — 전체 파이프라인을 실행하는 셸 스크립트:
    • 각 HTML 장면의 playwright screenshot → frames/
    • 각 내레이션 파일의 edge-tts → audio/
    • 크로스페이드 전환이 있는 ffmpeg concat → output.mp4

MCP를 사용할 수 없는 경우에도 항목 1-3을 생성하세요. 사용자가 수동으로 실행할 수 있도록 build.sh에 ffmpeg 명령어를 포함하세요.

장면 디자인 시스템

전체 디자인 시스템(색상 언어, 애니메이션 타이밍, 타이포그래피, HTML 레이아웃, 음성 옵션 및 페이싱 가이드)은 references/scene-design-system.md를 참조하세요.

품질 체크리스트

  • 비디오에 오디오 스트림이 있습니다
  • 해상도가 1920x1080입니다
  • 장면 사이에 검은 프레임이 없습니다
  • 처음 3초가 주의를 끕니다
  • 모든 장면에 하나의 초점 포인트가 있습니다
  • 끝 카드에 URL과 CTA가 있습니다

안티 패턴

안티 패턴수정 방법
슬라이드쇼 페이싱 — 모든 장면 동일한 지속 시간, 리듬 없음지속 시간 다양화: 후크 3초, 증거 8초, CTA 4초
화면의 텍스트 벽정보를 내레이션으로 이동, 시각적 요소 단순화
일반적인 내레이션 — "이 기능을 사용하면..."구체적인 숫자와 구체적인 동사 사용
스토리 아크 없음 — 단순히 기능 나열문제 -> 솔루션 -> 증거 구조 사용
원시 스크린샷항상 둥근 모서리, 그림자, 어두운 배경 추가
ease 또는 linear 애니메이션 사용스프링 곡선 사용: cubic-bezier(0.16, 1, 0.3, 1)

상호 참조

  • 관련: engineering/browser-automation — playwright 기반 브라우저 워크플로용
  • 참조: framecraft — 오픈 소스 장면 렌더링 파이프라인

Individual skills in this repo

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

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

관련 스킬