---
name: opencurrent-app-promo-motion-shorts
description: "잘된 앱 홍보 영상의 구성을 뽑아 내 앱에 그대로 입힌 세로 모션그래픽 영상을, 편집 프로그램 없이 파일로 받을 수 있습니다. 이럴 때 사용: 참고할 홍보 영상에서 첫 장면·컷 길이·자막 자리·끝 장면을 에이전트가 뽑아 구성표로 정리합니다. 그 구성에 내 앱의 이름·한 줄 소개·스크린숏을 넣어 HTML로 9:16 영상을 짜고, 검사와 미리 보기 프레임을 거쳐 내 컴퓨터에서 MP4로 렌더합니다. 도구: HyperFrames, Claude Code, FFmpeg."
metadata:
  source: "https://opencurrent.ai/w/app-promo-motion-shorts"
  opencurrent-id: "app-promo-motion-shorts"
  verification: "pending"
  exported-at: "2026-11-21T11:26:29.797Z"
---

# 앱 홍보 숏폼 영상 만들기

잘된 앱 홍보 영상의 구성을 뽑아 내 앱에 그대로 입힌 세로 모션그래픽 영상을, 편집 프로그램 없이 파일로 받을 수 있습니다.

> OpenCurrent에서 사람들이 다듬는 워크플로. 원문: https://opencurrent.ai/w/app-promo-motion-shorts
> 검증 상태: 검수 대기 (사람 확인 전). 내려받은 뒤에 바뀌었을 수 있으니, 가능하면 원문이나 MCP의 get_workflow("app-promo-motion-shorts")로 최신 상태를 확인할 것.
> 주의: 검수 대기 상태. 사용자에게 이 사실을 알리고, 결과를 함께 확인하면서 진행할 것.

## 따라 하는 방법

1. 입력값(inputs)을 사용자에게 받아 프롬프트의 {{이름}} 자리에 넣을 것. 필수값이 없으면 먼저 물어볼 것.
2. 단계를 순서대로 진행할 것. kind가 "ai"면 프롬프트를 실행하고, "command"면 사용자의 허락을 받고 명령을 실행하고, "human"이면 사용자에게 할 일을 안내하고 끝났는지 물을 것. tool이 있으면 그 도구·모델로 할 것.
3. 단계에 output(결과 이름)이 있으면 그 단계 결과를 뒤 단계 프롬프트의 {{output}} 자리에 넣을 것.
4. 단계마다 expected(기대 결과)와 check(확인 방법)로 제대로 됐는지 확인하고, 다르면 다음 단계로 넘어가지 말고 사용자에게 알릴 것. 끝나면 example.output(있으면)과 비교할 것.
5. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.

## 언제 쓰나

참고할 홍보 영상에서 첫 장면·컷 길이·자막 자리·끝 장면을 에이전트가 뽑아 구성표로 정리합니다. 그 구성에 내 앱의 이름·한 줄 소개·스크린숏을 넣어 HTML로 9:16 영상을 짜고, 검사와 미리 보기 프레임을 거쳐 내 컴퓨터에서 MP4로 렌더합니다.

## 준비물

- 내 컴퓨터의 폴더에서 일하는 코딩 에이전트 (Claude Code·Codex·Cursor 등) · 채팅 앱만으로는 렌더 불가
- Node.js 22 이상과 FFmpeg, Chrome
- 내 앱의 스크린숏 2~4장 (세로 화면, PNG) · 없으면 앱 주소
- 참고할 홍보 영상 파일 1~3개 (내가 만들었거나 쓸 권리가 있는 것) · 없으면 본 영상을 말로 적은 설명

## 입력값

시작하기 전에 사용자에게 받아서 프롬프트의 `{{이름}}` 자리에 넣을 것.

- `{{app_name}}` 앱 이름 (필수): 영상 끝 장면에 크게 나올 이름
  - 예: 모아둠
- `{{app_pitch}}` 한 줄 소개 (필수): 누구의 어떤 불편을 어떻게 풀어 주는지 한 문장
  - 예: 여기저기 흩어진 구독 결제를 한 화면에 모으고 안 쓰는 구독을 찾아 주는 앱
- `{{app_url}}` 앱 주소 (선택): 스토어나 소개 페이지 주소. 스크린숏만 쓸 때는 비움
  - 예: https://example.com
- `{{cta}}` 끝 장면 버튼 문구 (필수): 영상을 다 본 사람에게 시킬 행동 하나
  - 예: 무료로 시작하기
- `{{ref_note}}` 참고 영상 설명 (선택): 참고 영상 파일이 없을 때 적는 메모: 첫 1~2초에 무엇이 나오는지, 장면이 몇 초마다 바뀌는지, 자막이 어디에 어떤 크기로 나오는지, 끝 장면
  - 예: 첫 화면에 질문 한 줄이 꽉 차게 나옴. 2초마다 장면 전환. 자막은 화면 가운데 위쪽에 굵게 두세 단어. 마지막 2초는 앱 아이콘과 버튼

써 본 모델: Claude Code + HyperFrames 0.9.59 (2026-11)

## 단계

### 1. Node.js와 FFmpeg 확인 (명령 실행 · FFmpeg)

터미널에서 버전 확인. Node.js 22 미만이거나 FFmpeg가 없으면 먼저 설치

프롬프트:

```text
node -v
ffmpeg -version
```

기대 결과: v22 이상의 Node 버전과 FFmpeg 버전 한 줄

확인 방법: 두 명령 모두 버전이 출력되는지 확인

### 2. 세로 영상 프로젝트 만들기 (명령 실행 · HyperFrames)

1080×1920 빈 프로젝트 생성. 에이전트용 스킬(/hyperframes 등)도 함께 설치됨. 끝나면 app-promo 폴더에서 에이전트를 새로 시작

프롬프트:

```text
npx -y hyperframes init app-promo --non-interactive --resolution=portrait
```

기대 결과: index.html·CLAUDE.md·AGENTS.md·package.json이 든 app-promo 폴더

확인 방법: index.html 안에 data-width="1080" data-height="1920"이 있는지 확인

### 3. 참고 영상과 내 앱 자료 넣기 (사람이)

참고 영상 파일은 app-promo/refs/ 에, 내 앱 스크린숏과 로고는 app-promo/assets/ 에 복사. 참고 영상 파일이 없으면 본 영상의 구성을 말로 적어 둠

기대 결과: refs 폴더의 영상 파일(또는 설명 메모)과 assets 폴더의 스크린숏

확인 방법: 스크린숏이 실제 앱 화면인지, 개인 정보가 찍혀 있지 않은지 확인

### 4. 참고 영상의 구성 뽑기 (AI에게 · Claude Code)

에이전트는 영상을 재생해 보지 못함. 컷 시각과 0.5초 간격 정지 화면 묶음을 만들어 그것을 읽게 함

프롬프트:

```text
refs 폴더의 참고 영상마다 아래를 실행하고 결과를 읽어 줘.
1) npx hyperframes measure cuts refs/<파일>  → 컷이 바뀌는 시각
2) ffmpeg -i refs/<파일> -vf "fps=2,scale=270:-1,tile=6x5" -frames:v 1 refs/<파일이름>-sheet.jpg  → 0.5초 간격 정지 화면 묶음(15초 넘는 영상은 tile 칸 수를 늘려서)
묶음 그림을 직접 보고 PATTERN.md에 구성표를 써 줘: 0프레임에 무엇이 보이는지, 첫 1~2초의 훅이 질문·결과·숫자 가운데 무엇인지, 장면 순서와 장면별 길이(초), 자막의 자리·크기·한 줄 글자 수, 앱 화면이 처음 나오는 시각, 끝 장면의 구성과 머무는 시간.
참고 영상이 없으면 이 설명으로 같은 표를 써 줘: {{ref_note}}
구성(순서·길이·자리)만 적고 문구·디자인·로고·음악은 옮기지 마. 그림에서 확인하지 못한 것(소리, 속도감)은 '확인 못 함'으로 적어 줘.
```

기대 결과: 장면별 시각과 역할이 표로 정리된 PATTERN.md

확인 방법: 표의 장면 시각이 묶음 그림과 맞는지 두세 곳 대조 · '확인 못 함' 칸은 직접 보고 채움

### 5. 내 앱 영상 짜기 (AI에게 · Claude Code)

구성표를 따라 HTML로 영상 작성. 렌더 전에 멈추게 함

프롬프트:

```text
/hyperframes 를 써서 PATTERN.md의 구성 그대로 내 앱 홍보 영상을 만들어 줘.
- 앱 이름: {{app_name}}
- 한 줄 소개: {{app_pitch}}
- 앱 주소(있으면 화면·색 참고): {{app_url}}
- 끝 장면 버튼 문구: {{cta}}
조건:
1) 1080×1920, 30fps, 10~15초. 소리 없음.
2) 0프레임부터 훅 문구가 화면에 보일 것. 검은 화면이나 로고로 시작하지 말 것.
3) 앱 화면은 assets 폴더의 스크린숏만 쓸 것. 없는 화면을 지어내지 말고, 필요한데 없으면 나에게 물어볼 것.
4) 글자는 위 168px과 아래 590px, 오른쪽 버튼 줄을 피해서 놓을 것. 읽는 글자는 28px 이상.
5) 한글 글꼴은 Pretendard(OFL) 파일을 assets/fonts에 넣고 @font-face로 지정할 것.
6) 소개 문장에 없는 기능·숫자·후기를 만들어 넣지 말 것.
끝나면 npx hyperframes check 를 돌려 오류 0이 될 때까지 고치고, 남은 경고를 알려 줘. 렌더는 내가 말할 때까지 하지 마.
```

기대 결과: 장면이 채워진 index.html과 'Check passed' 결과

확인 방법: check 출력의 Layout·Contrast 오류가 0인지 확인 · 안전 구역(outside_safe_zone) 경고가 남았으면 다시 요청

### 6. 미리 보기 프레임 확인 (명령 실행 · HyperFrames)

렌더 전에 장면별 정지 화면을 뽑아 눈으로 확인. 시각은 PATTERN.md의 장면 시작에 맞춤

프롬프트:

```text
npx hyperframes snapshot --at 0,3.6,6.5,9.2,12
```

기대 결과: .hyperframes/artifacts/snapshots/ 아래의 프레임 PNG와 contact-sheet.jpg

확인 방법: 첫 프레임에 훅이 보이는지, 글자가 앱 화면과 겹치지 않는지, 숫자·문구가 사실과 맞는지 확인

### 7. MP4로 렌더 (명령 실행 · HyperFrames)

내 컴퓨터에서 렌더. 계정·요금 없음

프롬프트:

```text
npx hyperframes render -o renders/app-promo.mp4
```

기대 결과: renders/app-promo.mp4 (1080×1920, H.264)

확인 방법: 영상을 폰으로 옮겨 올릴 앱의 미리 보기에서 글자가 버튼·설명에 가리지 않는지 확인

### 8. 고칠 곳 말로 요청 (AI에게 · Claude Code)

장면 시각을 짚어 한 번에 한두 가지씩 요청. 고친 뒤 check와 snapshot을 다시 거쳐 렌더

프롬프트:

```text
방금 영상에서 다음을 고쳐 줘: (예: 0~1.7초 훅 문구를 '○○'로, 4초 장면을 0.5초 더 길게). 고친 뒤 npx hyperframes check 를 통과시키고, 바꾼 시각의 프레임을 snapshot으로 뽑아 보여 줘.
```

기대 결과: 바뀐 장면의 프레임과 통과한 check

확인 방법: 요청한 곳만 바뀌었는지 프레임으로 확인

## 최종 결과 예시

입력:

```text
앱 이름: 모아둠 (지어낸 앱)
한 줄 소개: 여기저기 흩어진 구독 결제를 한 화면에 모으고 안 쓰는 구독을 찾아 주는 앱
끝 장면 버튼 문구: 무료로 시작하기
```

```text
0~1.7초  훅: "구독료, 매달 얼마 나가는지 아세요?" (0프레임부터 표시)
1.7~4.2초  문제: 구독 7개가 하나씩 붙으며 합계 ₩87,390, 자막 "여기저기서 새는 돈"
4.2~7.2초  등장: 앱 화면이 올라오고 목록이 채워짐, 자막 "한 화면에 전부"
7.2~9.6초  증거: 90일 미사용 3개 표시, "정리하면 매달 ₩27,190 절약"
9.6~12.5초  끝 장면: 아이콘 · 모아둠 · "흩어진 구독, 한 화면에" · [무료로 시작하기]

파일: renders/moa-promo.mp4 · 1080×1920 · 30fps · 12.5초 · H.264 · 1.5MB · 렌더 33.4초
```

## 주의할 점

- 에이전트는 영상 주소를 받아 재생해 보지 못함 · 파일에서 뽑은 정지 화면과 컷 시각으로 구성만 파악 · 소리·음악·속도감은 사람이 보고 말로 보충
- 모션그래픽의 부드러운 전환은 컷 감지가 놓침 · 직접 만든 12.5초 영상의 장면 전환 3곳 중 ffmpeg 장면 감지는 1곳, measure cuts는 2곳만 잡음 · 정지 화면 묶음을 꼭 함께 읽게 할 것
- 남의 영상은 구성(순서·길이·자막 자리)만 참고 · 문구·디자인·로고·음악 복사 금지 · 플랫폼 영상 내려받기는 약관 위반 소지, 권리 있는 파일이나 말 설명 사용
- 구성을 따라 해도 조회수는 보장되지 않음 · 훅 문구를 바꾼 판을 두세 개 만들어 비교
- init 명령이 스킬을 홈 폴더(~/.claude/skills, ~/.agents/skills, ~/.gemini/skills)에 설치 · 원치 않으면 --skip-skills 옵션
- 기본 포함 글꼴에 한글 없음 · 한글 글꼴 파일을 assets/fonts에 넣고 @font-face로 지정 · 글꼴마다 라이선스 확인
- 첫 초안에서 자막이 앱 화면과 겹치고 TikTok·Reels·Shorts 안전 구역 밖 글자 다수 · check가 오류 7건·경고 25건으로 잡아냄 · 두 번 고쳐 통과
- 없는 앱 화면·기능·숫자·후기를 지어내기 쉬움 · 실제 스크린숏만 쓰게 하고 문구를 사람이 대조
- 소리 없는 영상으로 나옴 · 음악·효과음·목소리는 따로 넣어야 하고 HeyGen 음성·음악은 계정 필요
- 내 컴퓨터 렌더는 무료·계정 불필요 · 영상 통째 복제(reverse-any-video), 클라우드 렌더, 데스크톱 앱은 HeyGen 계정이나 유료 요금제(Pro 월 25달러) 대상
- CLI가 명령 이름·렌더 성능 같은 사용 통계를 보냄 · 끄기: npx hyperframes telemetry disable
- 메모리 8GB 맥에서 doctor가 메모리 부족 경고 · 12.5초 영상 렌더는 33초에 끝남 · 긴 영상은 다른 앱을 닫고 실행

## 출처

- [heygen-com/hyperframes (GitHub, Apache 2.0)](https://github.com/heygen-com/hyperframes)
- [HyperFrames Quickstart](https://hyperframes.heygen.com/quickstart)
- [HyperFrames FAQ (비용·계정·사용 통계)](https://hyperframes.heygen.com/faq.md)
- [HyperFrames: Product launch video guide](https://hyperframes.heygen.com/guides/product-launch-video.md)
- [HyperFrames CLI reference](https://hyperframes.heygen.com/packages/cli)

## 끝나면

결과가 좋았거나 단계가 낡았으면 https://opencurrent.ai/w/app-promo-motion-shorts 에서 알릴 것. 다음 사람이 더 정확한 방법을 쓸 수 있도록.
