Stitch to Remotion 워크스루 비디오
당신은 앱 디자인에서 매력적인 워크스루 비디오를 제작하는 데 특화된 비디오 제작 전문가입니다. Stitch의 스크린 검색 기능과 Remotion의 프로그래밍 방식 비디오 생성을 결합하여 부드럽고 전문적인 프레젠테이션을 제작합니다.
개요
이 스킬은 전문적인 전환 효과, 확대/축소 효과 및 상황에 맞는 텍스트 오버레이를 통해 앱 스크린을 보여주는 워크스루 비디오를 생성할 수 있게 해줍니다. 워크플로는 Stitch 프로젝트에서 스크린을 검색하여 Remotion 비디오 컴포지션으로 구성합니다.
전제 조건
필수:
- Stitch MCP 서버에 대한 접근
- Remotion MCP 서버 (또는 Remotion CLI)에 대한 접근
- Node.js 및 npm 설치
- 설계된 스크린이 포함된 Stitch 프로젝트
권장:
- Remotion의 비디오 기능에 대한 familiarity
- React 컴포넌트에 대한 이해 (Remotion은 React 사용)
검색 및 네트워킹
1단계: 사용 가능한 MCP 서버 탐색
list_tools를 실행하여 사용 가능한 MCP 서버와 해당 접두사를 식별합니다:
- Stitch MCP:
stitch:또는mcp_stitch:접두사 확인 - Remotion MCP:
remotion:또는mcp_remotion:접두사 확인
2단계: Stitch 프로젝트 정보 검색
-
프로젝트 조회 (프로젝트 ID가 제공되지 않은 경우):
[stitch_접두사]:list_projects호출 시filter: "view=owned"사용- 제목으로 대상 프로젝트 식별 (예: "계산기 앱")
name필드에서 프로젝트 ID 추출 (예:projects/13534454087919359824)
-
스크린 검색:
- 프로젝트 ID(숫자만)로
[stitch_접두사]:list_screens호출 - 스크린 제목을 검토하여 워크스루에 사용할 모든 스크린 식별
- 각 스크린의
name필드에서 스크린 ID 추출
- 프로젝트 ID(숫자만)로
-
스크린 메타데이터 가져오기: 각 스크린에 대해:
projectId및screenId와 함께[stitch_접두사]:get_screen호출- 다음 정보 검색:
screenshot.downloadUrl— 비디오용 시각 에셋htmlCode.downloadUrl— 선택 사항: 텍스트/콘텐츠 추출용width,height— 적절한 스케일링을 위한 스크린 치수- 텍스트 오버레이용 스크린 제목 및 설명
-
에셋 다운로드:
web_fetch또는curl이 포함된Bash를 사용하여 스크린샷 다운로드- 스테이징 디렉토리에 저장:
assets/screens/{screen-name}.png - 의도된 워크스루 흐름 순서대로 에셋 구성
3단계: Remotion 프로젝트 설정
-
기존 Remotion 프로젝트 확인:
remotion.config.ts또는 Remotion 종속성이 포함된package.json확인- 존재하는 경우 기존 프로젝트 구조 사용
-
새 Remotion 프로젝트 생성 (필요한 경우):
npm create video@latest -- --blank- TypeScript 템플릿 선택
- 전용
video/디렉토리에 설정
-
종속성 설치:
cd video npm install @remotion/transitions @remotion/animated-emoji
비디오 구성 전략
아키텍처
다음 컴포넌트로 모듈식 Remotion 컴포지션 생성:
-
ScreenSlide.tsx— 개별 스크린 표시 컴포넌트- Props:
imageSrc,title,description,width,height - 기능: 확대 애니메이션, 페이드 전환
- 지속 시간: 구성 가능 (기본 스크린당 3-5초)
- Props:
-
WalkthroughComposition.tsx— 메인 비디오 컴포지션- 여러
ScreenSlide컴포넌트를 시퀀스로 배치 - 스크린 간 전환 처리
- 텍스트 오버레이 및 주석 추가
- 여러
-
config.ts— 비디오 구성- 프레임 속도 (기본값: 30fps)
- 비디오 치수 (Stitch 스크린 치수에 맞추거나 적절히 스케일링)
- 총 지속 시간 계산
전환 효과
전문적인 효과를 위해 Remotion의 @remotion/transitions 사용:
-
페이드: 스크린 간 부드러운 크로스페이드
import {fade} from '@remotion/transitions/fade'; -
슬라이드: 방향성 슬라이드 전환
import {slide} from '@remotion/transitions/slide'; -
줌: 강조를 위한 확대/축소 효과
- 부드러운 줌을 위해
spring()애니메이션 사용 - 중요한 UI 요소에 적용
- 부드러운 줌을 위해
텍스트 오버레이
Remotion의 텍스트 렌더링을 사용하여 상황 정보 추가:
- 스크린 제목: 각 프레임 상단 또는 하단에 표시
- 기능 콜아웃: 애니메이션 포인터로 특정 UI 요소 강조
- 설명: 각 스크린에 대한 설명 텍스트 페이드 인
- 진행 표시기: 워크스루에서 현재 스크린 위치 표시
실행 단계
1단계: 스크린 에셋 수집
- 대상 Stitch 프로젝트 식별
- 프로젝트의 모든 스크린 나열
- 각 스크린의 스크린샷 다운로드
- 워크스루 흐름 순서대로 구성
- 매니페스트 파일 (
screens.json) 생성:
{
"projectName": "계산기 앱",
"screens": [
{
"id": "1",
"title": "홈 화면",
"description": "숫자 패드가 있는 메인 계산기 인터페이스",
"imagePath": "assets/screens/home.png",
"width": 1200,
"height": 800,
"duration": 4
},
{
"id": "2",
"title": "기록 보기",
"description": "이전 계산 기록 보기",
"imagePath": "assets/screens/history.png",
"width": 1200,
"height": 800,
"duration": 3
}
]
}
2단계: Remotion 컴포넌트 생성
Remotion 모범 사례에 따라 비디오 컴포넌트 생성:
-
ScreenSlide.tsx생성:- 애니메이션에
useCurrentFrame()및spring()사용 - 줌 및 페이드 효과 구현
- 적절한 타이밍으로 텍스트 오버레이 추가
- 애니메이션에
-
WalkthroughComposition.tsx생성:- 스크린 매니페스트 가져오기
<Sequence>컴포넌트로 스크린 시퀀스 배치- 스크린 간 전환 적용
- 적절한 타이밍 및 오프셋 계산
-
remotion.config.ts업데이트:- 컴포지션 ID 설정
- 비디오 치수 구성
- 프레임 속도 및 지속 시간 설정
참조 리소스:
- 시작점으로
resources/screen-slide-template.tsx사용 - 완벽성을 위해
resources/composition-checklist.md따르기 examples/walkthrough/디렉토리의 예제 검토
3단계: 미리보기 및 개선
-
Remotion Studio 시작:
npm run dev- 브라우저 기반 미리보기 열기
- 실시간 편집 및 개선 가능
-
타이밍 조정:
- 각 스크린이 적절한 표시 시간을 갖도록 보장
- 전환이 부드러운지 확인
- 텍스트 오버레이 타이밍 확인
-
애니메이션 미세 조정:
- 줌 효과를 위한 스프링 구성 조정
- 전환을 위한 이징 함수 수정
- 텍스트가 항상 읽을 수 있는지 확인
4단계: 비디오 렌더링
-
Remotion CLI를 사용한 렌더링:
npx remotion render WalkthroughComposition output.mp4 -
대안: Remotion MCP 사용 (가능한 경우):
- 컴포지션 세부 정보로
[remotion_접두사]:render호출 - 출력 형식 지정 (MP4, WebM 등)
- 컴포지션 세부 정보로
-
최적화 옵션:
- 품질 수준 설정 (
--quality) - 코덱 구성 (
--codec h264또는h265) - 병렬 렌더링 활성화 (
--concurrency)
- 품질 수준 설정 (
고급 기능
인터랙티브 핫스팟
클릭 가능한 요소 또는 중요한 기능 강조:
import {interpolate, useCurrentFrame} from 'remotion';
const Hotspot = ({x, y, label}) => {
const frame = useCurrentFrame();
const scale = spring({
frame,
fps: 30,
config: {damping: 10, stiffness: 100}
});
return (
<div style={{
position: 'absolute',
left: x,
top: y,
transform: `scale(${scale})`
}}>
<div className="pulse-ring" />
<span>{label}</span>
</div>
);
};
나레이션 통합
워크스루에 내레이션 추가:
- 스크린 설명에서 나레이션 대본 생성
- 텍스트 음성 변환 사용 또는 오디오 녹음
<Audio>컴포넌트로 오디오를 Remotion에 가져오기- 스크린 타이밍을 나레이션 속도와 동기화
동적 텍스트 추출
자동 주석을 위해 Stitch HTML 코드에서 텍스트 추출:
- 각 스크린에 대해
htmlCode.downloadUrl다운로드 - HTML을 파싱하여 주요 텍스트 요소(제목, 버튼, 레이블) 추출
- 중요한 UI 요소에 대한 자동 콜아웃 생성
- 시간이 지정된 텍스트 오버레이로 컴포지션에 추가
파일 구조
project/
├── video/ # Remotion 프로젝트 디렉토리
│ ├── src/
│ │ ├── WalkthroughComposition.tsx
│ │ ├── ScreenSlide.tsx
│ │ ├── components/
│ │ │ ├── Hotspot.tsx
│ │ │ └── TextOverlay.tsx
│ │ └── Root.tsx
│ ├── public/
│ │ └── assets/
│ │ └── screens/ # 다운로드된 Stitch 스크린샷
│ │ ├── home.png
│ │ └── history.png
│ ├── remotion.config.ts
│ └── package.json
├── screens.json # 스크린 매니페스트
└── output.mp4 # 렌더링된 비디오
Remotion 스킬과의 통합
Remotion은 모범 사례를 정의하는 자체 Agent Skills를 유지 관리합니다. 고급 기술은 다음을 참조하세요:
- 저장소: https://github.com/remotion-dev/remotion/tree/main/packages/skills
- 설치:
npx skills add remotion-dev/skills
활용할 주요 Remotion 스킬:
- 애니메이션 타이밍 및 이징
- 컴포지션 아키텍처 패턴
- 성능 최적화
- 오디오 동기화
일반적인 패턴
패턴 1: 간단한 슬라이드 쇼
페이드 전환이 있는 기본 워크스루:
- 스크린당 3-5초
- 크로스페이드 전환
- 하단 텍스트 오버레이(스크린 제목)
- 상단 진행 표시줄
패턴 2: 기능 하이라이트
특정 UI 요소에 초점:
- 특정 영역으로 확대
- 기능을 가리키는 애니메이션 원/화살표
- 주요 상호작용에 대한 슬로우 모션 강조
- 전후 비교 나란히 표시
패턴 3: 사용자 흐름
단계별 사용자 여정 표시:
- 방향성 슬라이드가 있는 순차적 스크린 흐름
- 번호가 매겨진 단계 오버레이
- 사용자 작업 강조 (클릭, 탭)
- 애니메이션 경로로 스크린 연결
문제 해결
| 문제 | 해결 방법 |
|---|---|
| 흐릿한 스크린샷 | 다운로드한 이미지가 전체 해상도인지 확인; screenshot.downloadUrl 품질 설정 확인 |
| 텍스트 정렬 불량 | 스크린 치수가 컴포지션 크기와 일치하는지 확인; 실제 스크린 크기에 따라 텍스트 위치 조정 |
| 끊기는 애니메이션 | 프레임 속도를 60fps로 증가; 적절한 댐핑으로 올바른 스프링 구성 사용 |
| Remotion 빌드 실패 | Node 버전 호환성 확인; 모든 종속성이 설치되었는지 확인; Remotion 문서 검토 |
| 타이밍 어색함 | 매니페스트에서 스크린당 지속 시간 조정; Remotion Studio에서 미리보기; 실제 사용자로 테스트 |
모범 사례
- 종횡비 유지: 실제 Stitch 스크린 치수 사용 또는 비례적으로 스케일링
- 일관된 타이밍: 특정 스크린을 강조하지 않는 한 스크린 표시 시간 일관되게 유지
- 읽기 쉬운 텍스트: 충분한 대비 보장; 적절한 글꼴 크기 사용; 복잡한 오버레이 피하기
- 부드러운 전환: 자연스러운 움직임을 위해 스프링 애니메이션 사용; 거친 컷 피하기
- 철저한 미리보기: 최종 렌더링 전에 항상 Remotion Studio에서 미리보기
- 에셋 최적화: 이미지를 적절히 압축; 효율적인 형식 사용 (UI용 PNG, 사진용 JPG)
사용 예시
사용자 프롬프트:
내 Stitch 프로젝트 "계산기 앱"의 스크린을 조회하고 스크린 워크스루를 보여주는
remotion 비디오를 빌드해 줘.
Agent 워크플로:
- Stitch 프로젝트 나열 → "계산기 앱" 찾기 → 프로젝트 ID 추출
- 프로젝트의 스크린 나열 → 모든 스크린 식별 (홈, 기록, 설정)
- 각 스크린의 스크린샷 다운로드 →
assets/screens/에 저장 - 스크린 메타데이터로
screens.json매니페스트 생성 - Remotion 컴포넌트 생성 (
ScreenSlide.tsx,WalkthroughComposition.tsx) - Remotion Studio에서 미리보기 → 타이밍 및 전환 개선
- 최종 비디오 렌더링 →
calculator-walkthrough.mp4 - 비디오 미리보기 링크와 함께 완료 보고
성공을 위한 팁
- 간단하게 시작: 복잡한 애니메이션을 추가하기 전에 기본 페이드 전환부터 시작
- Remotion 패턴 따르기: Remotion의 공식 스킬 및 문서 활용
- 매니페스트 파일 사용: 쉬운 업데이트를 위해 스크린 데이터를 JSON으로 구성
- 자주 미리보기: Remotion Studio를 사용하여 초기에 문제 발견
- 접근성 고려: 자막 추가; 텍스트가 읽기 쉬운지 확인; 명확한 시각 자료 사용
- 플랫폼에 최적화: 대상 플랫폼(YouTube, 소셜 미디어 등)에 맞게 비디오 치수 조정
참조
- Stitch 문서: https://stitch.withgoogle.com/docs/
- Remotion 문서: https://www.remotion.dev/docs/
- Remotion 스킬: https://www.remotion.dev/docs/ai/skills
- Remotion MCP: https://www.remotion.dev/docs/ai/mcp
- Remotion 전환: https://www.remotion.dev/docs/transitions
사용 시기
위에 설명된 주요 도메인 또는 기능과 관련된 작업을 처리할 때 이 스킬을 사용하세요.
연결
- 도메인: [[디자인 및 창의성]]
- 카테고리: [[UI 및 UX 디자인]]
- 탐색: [[스킬 개요]], [[홈]]