Communitygithub.com

앱 프로모션 릴스

자신의 iOS 앱과 웹사이트를 위한 짧은 세로형 프로모션 릴스(인스타그램 릴스, 틱톡, 유튜브 쇼츠)를 실제 화면 녹화본으로 제작합니다. 보통 주간 배치로 작업하며, 새로운 기능 각도를 반복 없이 기획하고, iOS 시뮬레이터를 녹화하고, Remotion 템플릿으로 13-17초 분량의 참여도 중심 릴스를 편집, 렌더링, 검수한 후 게시 준비가 완료된 캡션과 게시 일정을 작성합니다.

앱 프로모션 릴스란 무엇인가요?

이 스킬은 실제 앱 화면 녹화본을 활용하여 짧은 세로형 프로모션 비디오(릴스, 쇼츠, 틱톡)를 제작하는 완전 자동화된 파이프라인입니다. 사용자가 단순히 "이번 주 프로모션 영상을 만들어줘"라고 요청하면, 각도 기획부터 녹화, 편집, 렌더링, 캡션 작성, 게시 일정까지 모든 단계를 처리합니다. Claude Code, Cursor, Codex 등 AI 에이전트 환경에서 작동하며, Remotion 기반 템플릿을 사용하여 13-17초 길이의 참여도 최적화 릴스를 생성합니다. 주요 특징으로는 각 제품마다 중복되지 않는 새로운 기능 각도를 기획하고(PRODUCTS.md/ANGLES.md 관리), iOS 시뮬레이터에서 실제 앱 화면을 녹화하며, 2-3초 간격으로 빠르게 컷 편집하고, 모든 캡션에 행동 유도 문구와 해시태그를 포함합니다. 녹화 시 실제 인물이나 비즈니스 정보가 화면에 노출되지 않도록 안전 규칙을 적용하며, 최종 출력물은 파일과 캡션 텍스트로만 제공되고 절대 직접 게시하지 않습니다. 주간 배치 작업을 염두에 두고 설계되어 반복 가능한 앱 마케팅 비디오 파이프라인을 구축할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/micahmckittrick/claude-skills/tree/HEAD/skills/app-promo-reels

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

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

문서

앱 프로모션 릴스은(는) 무엇을 하나요?

이 스킬은 실제 앱 화면을 짧은 세로형 프로모션 비디오로 변환합니다. 제품당 하나의 릴스로, 보통 매주 배치로 제작합니다. 실제 앱 화면은 목업보다 효과적이며, 제품을 정직하게 보여주고 제작 비용도 저렴합니다.

파이프라인:

각도 기획 -> 데모 데이터 준비 -> 녹화 -> 비트 편집 -> 렌더링 -> 검수 -> 캡션 -> 인계

시작 전: 프로젝트 찾기 또는 설정

먼저 기존 릴스 프로젝트(src/Reel.tsx, src/weeks/, render-all.sh가 포함된 폴더)와 사용자의 제품 관련 노트를 찾습니다. 없다면:

  1. assets/remotion-starter/를 사용자가 선택한 폴더에 복사한 후 npm install을 실행합니다. Remotion은 자체 라이선스가 있으며, 개인 및 소규모 회사는 무료, 대규모 회사는 유료입니다. 설정 시 한 번만 언급합니다.
  2. 해당 프로젝트에 assets/PRODUCTS.template.md와 assets/ANGLES.template.md를 기반으로 PRODUCTS.md와 ANGLES.md를 생성합니다. 사용자에게 직접 알아낼 수 없는 정보(제품 목록, 앱 스토어 또는 사이트 링크, 각 앱을 데모 데이터로 실행하는 방법, 게시 순서, 엔드 카드에 포함해야 할 문구)를 물어봅니다.

PRODUCTS.md는 매주 동일하게 유지되는 정보를 담고 있습니다. ANGLES.md는 이미 사용된 각도를 기록하여 기능이 중복되지 않도록 합니다. 매 배치 시작 시 두 파일을 모두 읽고, 배치 종료 시 ANGLES.md를 업데이트합니다.

주간 워크플로우

1. 제품당 하나의 각도 기획

  • 아직 보여주지 않은 기능이나 결과를 선택합니다. ANGLES.md의 "사용되지 않음" 목록을 우선 사용하고, 앱을 더 탐색하여 추가 각도를 찾습니다.
  • 각 릴스를 미니 스토리로 구성합니다: 문제점 또는 혜택으로 시작, 2~3개의 증명 비트, 결과.
  • 릴스당 짧은 샷 리스트를 작성합니다: 후크 라인, 각 비트의 캡션, 녹화할 내용. 사용자에게 계획을 몇 줄로 보여주고, 사용자가 방향을 바꾸지 않으면 계속 진행합니다.

2. 데모 데이터 준비

앱에 데모 또는 샘플 데이터 실행 옵션이 있으면 사용합니다. 없으면 수동으로 데이터를 입력합니다. 화면에 표시되는 모든 것은 가상의 데이터여야 합니다: 실제 인물, 실제 비즈니스, 실제 계정 이름은 사용할 수 없습니다. 녹화 전에 references/on-camera-safety.md를 읽습니다. 화면에 표시해서는 안 되는 것과 그를 피하는 방법이 설명되어 있습니다.

3. 녹화

각 릴스의 전체 흐름을 iOS 시뮬레이터에서 한 번에 녹화하며, 상태 표시줄은 9:41로 설정합니다. scripts/record.sh를 사용하여 시작하고 중지합니다. 웹사이트는 시뮬레이터 Safari에서 녹화하여 폰 프레임이 앱 릴스와 일치하도록 합니다. 자세한 내용, 명령어 및 주의사항은 references/recording-ios-simulator.md를 참조하세요.

녹화 후, 콘택트 시트를 생성합니다(swift scripts/contact_sheet.swift <비디오> <출력.png> 1). 각 순간이 발생하는 정확한 초를 찾기 위함입니다. 클립 시간은 메모리가 아닌 시트에서 가져옵니다.

4. 비트 편집

주 파일(src/weeks/<월요일>.ts)을 추가하고 src/reels.ts에 등록합니다. 각 릴스는 비트 목록으로 구성되며, 각 비트는 캡션, 하나 이상의 클립({src, from, to, rate?}(초 단위)), 선택적 확대(zoom)를 포함합니다. references/format-and-captions.md의 형식 규칙을 따릅니다:

  • 문제점이나 혜택으로 열고, 비트 1에 확대 줌을 적용합니다.
  • 후크는 프레임 0에서 읽을 수 있어야 합니다. 프레임 0이 커버로 사용되기 때문입니다.
  • 2-3초 간격으로 컷하여 총 13-17초가 되도록 합니다.
  • endFrames: 54를 사용하여 빠르게 종료 카드를 표시하고 루프가 빠르게 재시작되도록 합니다.
  • 캡션에서 결과를 강조할 단어는 *별표*로 감싸 강조 색상을 적용합니다.

템플릿의 작동 방식과 적용 방법: references/remotion-template.md

5. 렌더링

./render-all.sh <월요일>을 실행하거나, 특정 릴스만 렌더링하려면 릴스 ID를 추가합니다. 각 릴스는 1-2분 정도 소요됩니다. 출력은 out/<월요일>/<ReelId>.mp4에 1080x1920, 30fps, H.264, 무음 오디오 트랙으로 저장됩니다.

6. 인계 전 모든 릴스 검수

렌더링된 각 파일의 콘택트 시트를 만든 후 다음을 확인합니다:

  • 프레임 0에 전체 후크가 표시되고, 폰 크기에서 읽을 수 있어야 합니다.
  • 길이가 13-17초이고, 어떤 비트도 3초를 크게 넘지 않아야 합니다.
  • 모든 캡션이 해당 순간의 화면 내용과 일치해야 합니다.
  • references/on-camera-safety.md의 내용(배경 목록 포함)이 나타나지 않아야 합니다.
  • 시스템 대화상자, 알림 배너, 디버그 오버레이가 없어야 합니다.
  • 엔드 카드의 이름, 행동 유도 문구, 필수 바닥글이 올바르게 표시되어야 합니다.
  • 각도가 이 제품의 이전 모든 릴스와 달라야 합니다.

실패한 항목은 수정하고 다시 렌더링합니다. 확인하지 않은 릴스는 인계하지 않습니다.

7. 캡션 및 일정 작성

posts.md에 주를 추가하고(가장 최근 주가 먼저), 릴스당 하나의 게시 준비 완료 블록을 작성합니다: 후크 라인, 키워드가 포함된 본문, 명시적 행동 유도(댓글, 저장, 공유 또는 태그), 가용성 라인, 3-5개의 해시태그. 요일, 릴스, 파일이 포함된 일정 테이블을 추가합니다. 공식과 예시는 references/format-and-captions.md를 참조하세요. 사용자가 요청하지 않는 한, 화면 스크립트가 아닌 설명만 작성합니다.

8. 마무리

  • 이번 주 각도를 ANGLES.md에 업데이트하고, 발견한 새로운 사용되지 않은 아이디어를 추가합니다.
  • 사용자에게 파일 위치, 일정, 게시 전 앱에서 수행해야 할 작업(라이선스 사운드 추가, 커버를 프레임 0으로 설정 등)을 알려줍니다.

경계

  • 절대 소셜 플랫폼에 게시, 예약 또는 업로드하지 않으며, 누구에게도 메시지를 보내지 않습니다. 출력물은 파일과 게시 준비 완료된 텍스트입니다.
  • 사용자가 소유하거나 홍보 권한이 있는 제품만 표시합니다.
  • 가짜 리뷰, 가짜 숫자, 존재하지 않는 기능을 조작하지 않습니다. 캡션의 주장에 증거가 필요한 경우 (예: "주 2시간 절약"), 해당 부분을 삭제하거나 출처를 요청합니다.
  • 렌더링된 비디오에는 무음 오디오 트랙이 포함됩니다. 음악은 플랫폼 앱의 라이선스 라이브러리에서 추가됩니다. 상업용 음악을 번들로 제공하지 마세요.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬