Communitygithub.com

flutter-demo-reel

Flutter 앱을 소셜 미디어용 루핑 프로모 또는 데모 릴 비디오(16:9 및 9:16, 60fps)로 변환합니다. flutter_scene(Flutter GPU) 기반 3D, 2D 파티클 및 타이틀 키트, 사운드트랙에 맞춘 컷, ffmpeg를 통한 오프라인 H.264 및 ProRes 내보내기를 포함한 별도의 macOS Flutter 앱을 <app>/demo에 빌드합니다.

flutter-demo-reel란 무엇인가요?

이 스킬은 Flutter 앱을 전문적인 소셜 미디어 프로모 비디오(데모 릴, 트레일러, 티저, 런칭 비디오, 애니메이션 쇼케이스)로 변환하는 완전한 워크플로우를 제공합니다. 별도의 macOS Flutter 앱(`<flutter 앱>/demo`)으로 빌드하며, 앱의 실제 화면, 아트, 폰트, 콘텐츠를 재사용하여 일관된 브랜딩을 유지합니다. 3D 레이어(flutter_scene 및 Flutter GPU on Metal), 2D 파티클 및 타이틀 키트, 사운드트랙에 동기화된 컷을 지원하며, 최종 결과물은 60fps, 16:9(랜드스케이프) 및 9:16(포트레이트) 형식으로 H.264 및 ProRes로 내보내집니다. 주요 워크플로우는 사용자 인터뷰(길이, 음악, 메시지, 톤 결정), 앱 분석, 사운드트랙 분석(파이썬 스크립트), 스크립트 작성 및 승인, 스캐폴드 생성, 샷 구현(순수 함수 `t` 기반, 상태 비저장, 시드 기반 랜덤), 접촉 시트로 검토, 최종 내보내기 및 반복 개선으로 구성됩니다. Claude Code, Cursor, Codex 등 AI 에이전트에서 사용할 수 있으며, macOS만 지원하고 Flutter macOS 데스크톱, ffmpeg, Python 3(Pillow, numpy)가 필요합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/vlidholt/flutter-skills/tree/HEAD/skills/flutter-demo-reel

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

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

문서

Flutter 데모 릴

Flutter 앱의 짧은 루핑 프로모를 자체 macOS Flutter 앱으로 <flutter 앱>/demo 에 빌드하고, 오프라인으로 프레임별로 렌더링한 후 인코딩합니다. 이 릴은 앱의 실제 화면, 아트, 폰트, 콘텐츠, flutter_scene(Flutter GPU on Metal) 위의 3D 레이어, 2D 파티클 및 타이틀 키트, 음악에 맞춘 컷을 사용합니다.

아래 경로는 이 스킬이 있는 폴더(이 SKILL.md가 포함된 폴더)를 기준으로 합니다. Claude Code에서 그 폴더는 ${CLAUDE_SKILL_DIR} 입니다.

기본 규칙

  • 앱을 절대 수정하지 마세요. 필요한 것(아트, 폰트, 스크린샷, 콘텐츠 데이터, 테마 색상)을 demo/ 로 복사하세요. 스캐폴드는 부모 패키지의 분석기 제외 목록에 demo/** 만 추가합니다.
  • 모든 프레임은 t 의 순수 함수여야 합니다. 프레임 간 상태, Random(), 시계, 시뮬레이션 금지: 폐쇄형 움직임, 시드 기반 랜덤. 이렇게 해야 스크러빙, 청크 단위 내보내기, 모션 블러, 완벽한 루프가 가능합니다. 샷을 작성하기 전에 references/kit.md 를 읽으세요.
  • 프로젝트의 음성 규칙을 따르세요(AGENTS.md, CLAUDE.md 또는 유사 파일): 앱이 절대 사용하지 않는 단어, 제품 이름을 부르는 방식, 톤.
  • 빌드 전에 동의를 구하세요. 사용자와 인터뷰한 후 승인받는 스크립트를 작성하세요.
  • macOS 전용. Flutter macOS 데스크톱, ffmpeg(brew install ffmpeg), Python 3(Pillow(접촉 시트) 및 numpy(오디오 분석))가 필요합니다.

워크플로우

1. 인터뷰

시작하기 전에 질문하고, 각 항목에 기본값을 제시하여 사용자가 빠르게 답변할 수 있도록 하세요.

  1. 길이 및 루프(기본값 30초, 완벽한 루프), 형식(랜드스케이프 1920x1080 및 포트레이트 1080x1920, 포트레이트는 Reels, TikTok, Shorts용으로 설계), 60fps.
  2. 사운드트랙: 파일(가사 포함?) 또는 없음, 권리 소유자.
  3. 메시지: 보여줄 3~5가지, 클릭 유도 문구(URL, 스토어 배지), 주장할 내용(무료? 평점? 카운트?).
  4. 디자인 및 톤: 과장된 정도, 앱의 브랜드, 참고 자료.
  5. 실제 화면: 어떤 화면, 앱을 실행하여 캡처해도 되는지(테스트 계정, 시드 데이터). 가상의 분위기 샷도?
  6. 화면 텍스트: 핵심 단어만(기본값) 또는 전체 자막, 제품 이름 철자, 피해야 할 단어.
  7. 특별한 사항: 이스터 에그, 캐릭터, 절대 보여주지 말아야 할 것.

2. 앱 연구

앱의 테마(색상, 폰트), 에셋(로고, 캐릭터, 아이콘), 콘텐츠(실제 이름, 숫자, 보여줄 데이터) 및 주요 화면을 읽으세요. 차별화되는 점을 기록하세요. 스크린샷을 계획하고 캡처하거나 사용자에게 요청하세요(references/craft.md 의 "실제 스크린샷" 참조).

3. 사운드트랙 분석

python3 scripts/analyze_audio.py <트랙>

템포, 비트 위상, 섹션, 보컬 라인을 references/audio-sync.md 에 나온 대로 명명된 큐로 변환합니다. 사운드트랙이 없어도 템포를 선택하고 그 그리드에 맞춰 컷을 만드세요.

4. 스크립트 작성

각 샷에 대해 음악 또는 가사, 랜드스케이프 사진, 포트레이트 사진, 화면 텍스트가 포함된 시간 표를 만드세요(템플릿은 references/craft.md 참조). 훅, 드롭, 엔드 카드, 루프 이음새를 표시하세요. 사용자의 승인을 받고, "가자"고 할 때까지 반복하세요.

5. 스캐폴드

zsh scripts/scaffold.sh <flutter 앱 디렉토리>

이 스킬의 scripts/ 폴더 전체 경로로 실행하세요. 어떤 디렉토리에서든 작동합니다. 다음을 수행합니다:

  • <app>/demo 를 flutter create --platforms macos 로 생성합니다.
  • flutter_scene, vector_math, audioplayers를 추가하고 flutter_scene:init 를 실행합니다.
  • Flutter GPU(FLTEnableFlutterGPU)를 활성화하고 앱 샌드박스를 비활성화합니다(내보내기 도구가 ffmpeg를 실행함).
  • assets/template/ 에서 스타터 키트를 복사하고, art/, art/screens/, audio/, fonts/ 를 생성하고, out/ 을 무시합니다.
  • 부모 패키지의 분석기에서 demo/** 를 제외합니다.

퍼브 워크스페이스 내에서 작동하며(데모는 독립형 패키지로 유지됨), 기존 폴더를 덮어쓰지 않습니다.

그런 다음 설정합니다:

  • lib/core/timeline.dart: kDuration, kBpm, kBeatPhase 및 Cue 목록.
  • lib/core/format.dart: 앱 테마의 Palette 및 Fonts(폰트 파일을 demo/fonts/ 로 복사하고 pubspec.yaml 에 선언).
  • 에셋: art/ (pubspec.yaml 에 하위 폴더 나열) 및 audio/track.wav (48kHz PCM).

한 번 빌드하고 예제의 스틸을 렌더링하여 설정이 작동하는지 확인하세요:

cd <app>/demo && flutter build macos --profile && tool/run.sh stills "0.3,2.3,9" both

6. 릴 빌드

lib/shots/example.dart 를 스크립트의 각 파트에 대한 섹션으로 교체하고, Director.sections 에 나열하고, Director._hits 에 카메라 히트를 설정하세요. 섹션별로 작업합니다:

  1. 키트(references/kit.md)와 flutter_scene(references/flutter-scene.md)를 사용하여 섹션(3D 프레임 및 그 아래/위의 2D 레이어)을 작성합니다.
  2. flutter build macos --profile 실행 후, 섹션의 주요 순간에 두 형식 모두 스틸을 렌더링합니다: tool/run.sh stills "t1,t2,..." both.
  3. 형식별로 하나의 접촉 시트를 만들어 검사하고, 세부 사항이 중요한 부분은 단일 스틸을 확대하여 검사합니다: python3 tool/sheet.py out/l.png 4 480 out/stills/landscape_*.png. 이미지를 볼 수 없으면 사용자에게 어떤 스틸을 확인해야 하고 무엇을 찾아야 하는지 알려주세요. 수정하고 반복합니다.

내보내기 전에 references/craft.md 의 리뷰 체크리스트를 전체 릴에 대해 실행하세요. 사용자는 미리보기 앱(open build/macos/Build/Products/Profile/*.app)에서 음악과 함께 시청할 수 있습니다. 스틸로는 타이밍을 보여줄 수 없습니다.

7. 내보내기

tool/export.sh draft both     # 1배, 모션 블러 없음: 빠른 전체 확인
tool/export.sh final both     # 2배 슈퍼샘플링, 4샘플 모션 블러

최종 내보내기는 30초 기준 형식당 약 10~15분이 소요됩니다. 환경이 허용하면 백그라운드에서 실행하고 폴링하지 마세요. 그 후 ffprobe 로 파일을 확인하세요: 프레임 수는 kDuration * kFps, 지속 시간은 정확해야 하며 오디오 스트림이 있어야 합니다. MP4에서 몇 개의 프레임(마지막 프레임과 프레임 0(루프 이음새) 포함)을 추출하세요.

8. 전달 및 반복

사용자에게 경로(demo/out/final/<format>.mp4 업로드용, <format>_master.mov ProRes 편집용), 파일 크기, 확인해야 할 사항을 알려주세요. 피드백을 기대하세요. 일반적인 피드백과 수정 방법은 references/craft.md 에 나와 있습니다: 너무 짧게 표시된 텍스트, 가려진 텍스트, 원치 않는 자막, 윤곽선 이음새, 하드 라이트 광선, 동일해 보이는 항목 세트, 포트레이트 문구. 모든 피드백을 한 라운드에 수정한 후 다시 렌더링하세요.

파일

  • references/kit.md: 스타터 키트의 아키텍처 및 API.
  • references/flutter-scene.md: flutter_scene 설정, 모양 및 오프라인 주의사항.
  • references/audio-sync.md: 트랙의 템포, 위상, 가사 및 큐.
  • references/craft.md: 스크립트 템플릿, 텍스트 규칙, 효과 레시피, 스크린샷, 리뷰 체크리스트.
  • scripts/scaffold.sh: 데모 앱을 생성합니다.
  • scripts/analyze_audio.py: 템포, 비트 위상, 마디당 음량, 온셋.
  • assets/template/: 스캐폴드가 복사하는 스타터 키트.

관련 스킬