{"id":"product-reels","kind":"workflow","testedWith":[{"model":"Claude Code (Fable 5.2) + Remotion 4.0.544","at":"2026-11"},{"model":"macOS say (Yuna) · FFmpeg","at":"2026-11"}],"durationMin":30,"url":"https://opencurrent.ai/w/product-reels","title":"내 제품 알리는 릴스 만들기","summary":"만들어도 아무도 모르는 내 제품을, 사람들이 이미 궁금해하는 질문에 답하는 릴스로 알려 찾아오게 만들 수 있습니다.","category":"글쓰기","categoryId":"writing","domain":"marketing","domainLabel":"마케팅","capabilities":[{"id":"video","label":"영상 생성"},{"id":"audio","label":"음성·전사"},{"id":"code","label":"코드 작성"}],"topics":[{"id":"writing","label":"글쓰기"}],"tools":["Claude Code","Remotion","FFmpeg"],"whenToUse":"제품 자랑 대신 고객이 계속 묻는 질문을 골라, 답을 그냥 알려 주는 릴스를 만듭니다. Claude Code에 프롬프트 두 개를 붙여 넣어 한 번 세팅하면, 그 뒤로는 /reel 뒤에 질문을 적고 대본과 장면 설명을 승인하는 것만으로 음성·자막·애니메이션이 들어간 세로 영상이 나옵니다.","prerequisites":["맥(음성 합성에 macOS의 say 사용). 윈도우는 음성 단계가 달라 이 글의 범위 밖","Claude Code 데스크톱 앱과 Claude 유료 요금제","빈 폴더 하나와 저장 공간 약 1GB","Node.js 20.19 이상과 FFmpeg. 없으면 세팅 중 Homebrew 설치 안내","Remotion 무료 조건 확인: 개인과 3명 이하 회사는 무료, 그보다 큰 회사는 만드는 사람 1명당 월 25달러"],"inputs":[{"name":"brand_color","label":"강조색","description":"영상에서 하나만 쓰는 색. 내 브랜드 색의 색상 코드","example":"#006A84","required":true},{"name":"business","label":"내 제품·서비스","description":"무엇을 누구에게 파는지 한두 문장","example":"동네 로스터리 카페. 직접 볶은 원두와 디저트를 판매","required":true},{"name":"question","label":"영상으로 답할 질문","description":"고객이 계속 묻는 질문 하나. 4단계에서 고른 것","example":"AI로 만든 상세페이지는 왜 티가 날까?","required":true}],"howToFollow":"1. 입력값(inputs)을 사용자에게 받아 프롬프트의 {{이름}} 자리에 넣을 것. 필수값이 없으면 먼저 물어볼 것.\n2. 단계를 순서대로 진행할 것. kind가 \"ai\"면 프롬프트를 실행하고, \"command\"면 사용자의 허락을 받고 명령을 실행하고, \"human\"이면 사용자에게 할 일을 안내하고 끝났는지 물을 것. tool이 있으면 그 도구·모델로 할 것.\n3. 단계에 output(결과 이름)이 있으면 그 단계 결과를 뒤 단계 프롬프트의 {{output}} 자리에 넣을 것.\n4. 단계마다 expected(기대 결과)와 check(확인 방법)로 제대로 됐는지 확인하고, 다르면 다음 단계로 넘어가지 말고 사용자에게 알릴 것. 끝나면 example.output(있으면)과 비교할 것.\n5. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.","steps":[{"n":1,"kind":"human","title":"빈 폴더를 Claude Code로 열기","body":"Claude Code 데스크톱 앱에서 새 폴더를 만들어 엽니다. 이 폴더가 영상 작업실이 되고, 앞으로 만드는 릴스는 모두 이 안에 저장됩니다.","expected":"빈 폴더가 열린 새 대화","check":"폴더 안에 다른 파일이 없는지 확인","tool":"Claude Code"},{"n":2,"kind":"ai","title":"영상 작업실 세팅","body":"아래 프롬프트를 그대로 붙여 넣으세요. 설치 명령마다 권한을 묻는 창이 뜨면 허용합니다. 처음 한 번만 하는 단계이고 5분쯤 걸립니다.","prompt":"이 폴더를 세로 숏폼 영상(릴스)을 코드로 만드는 작업실로 세팅해 줘. 맥 기준이야. 끝까지 스스로 진행하고 유료 서비스나 API 키는 쓰지 마.\n\n1. 확인: macOS인지, node가 20.19 이상인지, ffmpeg가 있는지. 없는 것이 있으면 설치 명령(Homebrew)을 보여 주고 내 허락을 받은 뒤 설치. 설치와 첫 렌더에서 약 1GB를 내려받는다는 것을 시작 전에 알려 줘.\n\n2. Remotion 프로젝트: `npx create-video@latest --yes --blank --no-tailwind .` 다음에 `npx remotion add @remotion/fonts`. Remotion API는 기억으로 쓰지 말고 node_modules의 타입과 remotion.dev 문서로 확인하고, 코드를 쓴 뒤 `npx tsc`로 검사.\n\n3. 글꼴: `npm i pretendard` 뒤 패키지 안의 PretendardVariable.woff2를 public/fonts에 복사하고 @remotion/fonts의 loadFont로 불러오기. 굵기는 400~600만 사용.\n\n4. `scripts/build-voice.mjs` 작성. `node scripts/build-voice.mjs <이름>`으로 실행하면 work/<이름>.txt(한 줄 = 한 문장)를 읽어서:\n- 문장마다 `say -v Yuna -r 185`로 따로 합성하고 ffmpeg로 48kHz wav로 바꿔 public/voice/<이름>/sN.wav에 저장\n- 문장 길이는 ffprobe로 측정. 문장 안의 쉼은 ffmpeg silencedetect(noise=-40dB:d=0.08)에서 0.18초 이상인 것만 쉼으로 보고, 쉼표 수와 같으면 쉼표 자리에, 다르면 가장 가까운 단어 경계에 맞춤\n- 단어 길이: 단어 사이에 `[[slnc 400]]`을 넣어 한 번 더 합성하고, 0.28초 이상인 무음 사이의 길이를 재서 그 비율로 쉼과 쉼 사이 구절을 단어별로 나눔. 마지막 단어는 파일 끝 기준. 무음 수가 단어 수와 안 맞으면 글자 수 비율로 나눔\n- 결과를 src/voice/<이름>.ts에 저장: 문장별 file, text, durationMs, speechEndMs와 단어별 text, startMs, endMs\n- 음성 이름과 속도는 환경변수 VOICE, RATE로 바꿀 수 있게\n\n5. 뼈대 코드. 파일과 이름은 아래 그대로:\n- src/theme.ts: 색, 그림 자리 STAGE(x 60, y 480, 폭 960, 높이 1160. 화면 아래 280px은 릴스 버튼 자리라 비움), 음성 데이터를 받아 문장 시작 프레임 STARTS와 단어 시작 프레임 cue(문장 번호, 단어 번호), 전체 길이를 돌려주는 함수. 문장 사이 여백 6프레임, 마지막 말이 끝난 뒤 30프레임. 장면의 시점은 모두 STARTS와 cue에서 얻음\n- src/Captions.tsx: 화면 위쪽(y 150~430) 가운데 정렬 자막, 글자 64px, 두 줄까지(넘는 문장은 쉼에서 나눠 차례로). 지금 말하는 단어는 강조색, 지난 단어는 글자색, 남은 단어는 회색. `word-break: keep-all`, 단어마다 inline-block, `text-wrap: balance`. 문장이 바뀔 때 빈 프레임이 없게 3프레임 앞당겨 등장\n- src/Base.tsx의 ReelFrame: 배경 + 자막 + 문장별 음성(STARTS에 맞춰 재생)을 깔고 children을 STAGE 위에 그림. 릴스마다 이것으로 감쌈\n- 영상은 1080x1920, 30fps\n- 배경: 밝은 회색(#F7F9FA)에 SVG 선으로 그린 옅은 격자. 글자색 #14181A. 강조색은 하나만: {{brand_color}}. 색 그라데이션, 이모지, 진한 그림자는 쓰지 않음\n\n6. `scripts/sheet.sh` 작성: `bash scripts/sheet.sh <mp4>`로 0.5초 간격 정지 화면을 뽑아 8장씩 가로로 붙인 out/<이름>-sheet-01.jpg, 02… 를 만듦(가로 2400px 안쪽, 글자는 쓰지 않음).\n\n7. 시험: work/setup-test.txt에 \"세팅 확인용 영상입니다. 자막이 말과 맞는지 봅니다.\" 두 문장을 넣고 음성을 만든 뒤, STAGE 안에서 도형 몇 개가 움직이는 컴포지션 SetupTest를 `npx remotion render SetupTest out/setup-test.mp4 --is-production=false`로 렌더. ffprobe로 영상과 오디오 트랙이 둘 다 있는지 확인하고, sheet.sh로 만든 그림을 직접 열어 한글 깨짐과 글자 넘침이 없는지 확인.\n\n끝나면 설치한 것, 만든 파일, 시험 영상 경로, 막힌 곳을 짧게 보고해 줘.","expected":"out/setup-test.mp4(약 5초, 소리 있음)와 설치·파일 목록 보고","check":"시험 영상을 열어 한글 자막이 깨지지 않고 소리가 나는지 확인","tool":"Claude Code"},{"n":3,"kind":"ai","title":"/reel 명령 저장","body":"같은 대화에 아래 프롬프트를 이어서 붙여 넣으세요. 대본 쓰는 법, 장면 규칙, 확인 방법이 /reel 명령 하나에 담깁니다.","prompt":"이 폴더에 `.claude/skills/reel/SKILL.md`를 만들어서 `/reel <질문>`으로 부를 수 있게 해 줘. frontmatter는 name: reel 과 description 한 줄. 본문에는 아래 절차와 규칙을 빠짐없이 담고, 이 폴더의 뼈대 파일 이름(src/theme.ts, src/Captions.tsx, src/Base.tsx의 ReelFrame, scripts/build-voice.mjs, scripts/sheet.sh)과 쓰는 법도 적어 줘.\n\n절차\n1. 대본: 질문에 쓸모 있는 답 한 가지를 주는 6~8문장, 영상 길이 20~28초. 첫 문장은 질문 그대로. 사실만 쓰고 수치·비율·후기는 지어내지 않음. 홍보와 댓글 유도 없음. 마지막 문장은 짧은 정리. 나에게 보여 주고 승인받을 때까지 멈춤.\n2. 장면 설명: 문장마다 장면 하나. 장면마다 무엇을 그리는지, 요소가 몇 개인지, 어떻게 움직이는지, 앞 장면의 어떤 물체가 이어지는지를 한두 줄로. 승인받을 때까지 멈춤.\n3. 음성: 영문 소문자 이름을 정해 대본을 work/<이름>.txt에 한 줄 한 문장으로 쓰고 `node scripts/build-voice.mjs <이름>`.\n4. 장면 코드: src/reels/<이름>/ 에 쓰고 ReelFrame으로 감싸 컴포지션으로 등록(id는 이름의 PascalCase). `npx tsc`로 검사.\n5. 렌더: `npx remotion render <id> out/<이름>.mp4 --is-production=false`.\n6. 확인을 두 바퀴 이상: `bash scripts/sheet.sh out/<이름>.mp4`로 만든 그림을 전부 직접 열어 보고, `ffmpeg -i out/<이름>.mp4 -vf \"crop=1080:1160:0:480,freezedetect=n=0.0005:d=0.6\" -an -f null -`로 그림 자리에서 멈춘 구간을 찾음. 문제를 고치고 다시 렌더.\n7. 보고: 파일 경로, 길이, 남은 문제. 소리는 직접 듣지 못했다는 사실도 함께.\n\n장면 규칙\n- 그림은 STAGE의 폭과 높이를 끝까지 사용. 가운데에 카드 하나만 놓는 장면 금지. 아래 절반이 1초 넘게 비는 장면 금지\n- 양으로 말하기: \"전부 비슷하다\"는 한 장이 아니라 수십 장으로. 장면마다 요소 수를 먼저 정함. 글자가 든 카드는 3열 8줄까지, 글자 없는 도형은 6열 6줄까지\n- 문장마다 그 문장의 뜻을 그리는 장면. \"소리 없이 그림만 봐도 이 문장인가\"를 확인\n- 그림 재료를 바꿔 가며 쓰기: 격자, 겹치는 카드, 메모지, 긴 페이지, 큰 숫자, 입력창, 아이콘. 흰 카드에 글자만 놓은 장면은 연속 두 번까지\n- 화면 안의 글자는 회색 줄이 아니라 실제 글자로, 36px 이상. 지어낸 예시에는 \"예시\" 표시를 장면마다 한 번, 글자를 가리지 않는 자리에\n- 0.6초 넘게 멈춘 구간 없음. 기다리는 구간에는 한두 요소에만 되풀이되는 작은 움직임을 두고, 화면 전체를 흔들지 않음\n- 장면 전환은 앞 장면의 주된 물체가 다음 장면의 물체가 되게. 화면을 슬라이드나 페이드로 통째로 바꾸지 않음. 이어지지 않는 작은 요소는 줄어들며 사라져도 됨\n- 등장은 spring과 시차(stagger). 큰 이동은 튀지 않게(damping 200). 회전, 튀는 효과, 블러는 쓰지 않음\n- 모든 시점은 STARTS와 cue에서. 그림은 말보다 4프레임 먼저 움직임\n- 마지막 장면은 정리 한 줄을 크게 보여 주고, 말이 끝난 뒤 1초 머묾. 큰 글자와 다른 요소가 겹치지 않게\n- 한글이 단어 중간에서 줄바꿈되지 않게\n\n다 만들면 SKILL.md의 경로와 `/reel` 사용 예 한 줄을 알려 줘.","expected":".claude/skills/reel/SKILL.md 파일과 사용 예 한 줄","check":"새 대화에서 /를 쳤을 때 reel이 목록에 보이는지 확인","tool":"Claude Code"},{"n":4,"kind":"ai","title":"고객이 계속 묻는 질문 적기","body":"아직 아무도 내 제품을 검색하지 않으니, 제품을 소개하는 릴스는 볼 사람이 없습니다. 대신 제품이 풀어 주는 문제에 대해 사람들이 계속 묻는 질문을 적으세요. 질문 열 개면 릴스 열 편입니다. 이미 아는 질문이 있으면 그대로 쓰고, 떠오르지 않으면 아래 프롬프트로 후보를 받으세요.","prompt":"내 제품·서비스: {{business}}\n\n이 제품이 풀어 주는 문제에 대해 사람들이 계속 묻는 질문 10개를 뽑아 줘. 기준:\n- 내 제품 이름이 없어도 성립하는 질문(검색할 만한 말)\n- 한 가지 쓸모 있는 답을 20초 안에 줄 수 있는 것\n- 사실로 답할 수 있는 것(효능 장담, 수치가 필요한 것은 제외)\n질문마다 답의 방향을 한 줄씩 붙이고, 영상으로 만들기 쉬운 순서로 정렬해 줘.","expected":"질문 10개와 답의 방향 한 줄씩","check":"내가 실제로 들어 본 질문인지, 답이 사실인지 확인 후 하나 선택","tool":"Claude Code","output":"question_list"},{"n":5,"kind":"ai","title":"/reel로 대본 받기","body":"새 대화에서 /reel 뒤에 질문을 적어 보냅니다. 대본은 쓸모 있는 답 한 가지를 그냥 알려 주는 내용이고, 제품 홍보 문장은 들어가지 않습니다. 사실과 다르거나 내 말투와 다른 문장은 고쳐 달라고 한 뒤 승인하세요.","prompt":"/reel {{question}}","expected":"질문으로 시작하는 6~8문장 대본, 승인 대기","check":"수치·후기가 지어낸 것이 아닌지, 홍보 문장이 없는지 확인","tool":"Claude Code"},{"n":6,"kind":"human","title":"장면 설명 승인","body":"문장마다 무엇을 그릴지 한두 줄씩 보여 줍니다. 글자 카드만 이어지는 장면이나 뜻이 안 보이는 장면은 바꿔 달라고 하세요. 승인하면 음성 합성, 장면 코드, 렌더, 프레임 확인까지 이어서 진행되고 6~10분쯤 걸립니다.","expected":"out/ 폴더의 mp4(20~28초)와 남은 문제 보고","check":"보고에 적힌 남은 문제 확인","tool":"Claude Code"},{"n":7,"kind":"ai","title":"영상 보고 고칠 곳 요청","body":"영상을 소리와 함께 재생해 보세요. 에이전트는 소리를 듣지 못하므로, 자막과 말이 맞는지와 어색한 발음은 직접 확인해야 합니다. 고칠 곳은 몇 초인지와 함께 말로 요청하면 됩니다.","prompt":"방금 영상에서 고칠 곳:\n- (몇 초) (무엇이 어떻게 보이는지) → (어떻게 바꿀지)\n- 발음이 어색한 낱말: (낱말) → 대본에서 (바꿀 말)로\n고친 뒤 다시 렌더하고 프레임 시트를 직접 확인해 줘.","expected":"고친 mp4와 다시 확인한 결과","check":"요청한 곳이 실제로 바뀌었는지 재생해서 확인","tool":"Claude Code"},{"n":8,"kind":"human","title":"목소리 정하고 올리기","body":"맥 기본 음성은 기계음이라, 올릴 영상에는 직접 녹음한 목소리를 권합니다. 대본을 문장별로 녹음해서 주고 음성만 바꿔 달라고 하세요. 장면 길이는 음성 길이를 따라갑니다. 올리기 전에 휴대폰에서 글자가 읽히는지, 아래 버튼 자리에 가려지는 것이 없는지 확인하세요.","expected":"올릴 수 있는 세로 영상 파일","check":"휴대폰에서 소리를 켜고 끝까지 재생"}],"pitfalls":["맥 기본 음성은 기계음. 올릴 영상은 직접 녹음한 목소리로 교체","녹음으로 바꾼 뒤에는 \"녹음에 맞춰 자막 시각을 다시 계산해 줘\"라고 요청","AI는 소리를 듣지 못함. 자막과 말이 맞는지, 영문과 줄임말의 발음은 직접 재생해 확인","대본에 수치와 후기를 넣지 않기. 사실 확인은 직접","처음 나온 영상은 초안. 글자 카드만 이어지면 장면 설명 단계에서 그림 재료를 바꿔 달라고 요청","세팅이 중간에 멈추면 오류 글을 그대로 붙여 넣고 이어서 진행해 달라고 요청","첫 실행 때 약 1GB를 내려받음. 와이파이에서 진행","배경음과 효과음은 들어가지 않음. 필요하면 올리는 앱에서 추가","4명 이상 회사에서 쓰면 Remotion 유료(만드는 사람 1명당 월 25달러)"],"sources":[{"title":"Remotion 공식 에이전트 스킬 (GitHub)","url":"https://github.com/remotion-dev/skills"},{"title":"Remotion 문서: AI 에이전트 스킬","url":"https://www.remotion.dev/docs/ai/skills"},{"title":"Remotion 요금과 무료 조건","url":"https://www.remotion.dev/docs/license/pricing"}],"verification":{"status":"pending","label":"검수 대기","detail":"사람 확인 전","verifiedBy":0,"lastVerifiedAt":null},"quality":{"score":32,"components":{"result":0.5,"trust":0,"freshness":0.4},"explanation":"확인 없음 · 검수 대기"},"workedFor":0,"trials":{"summary":"","lastAt":null,"total":0,"worked":0,"partial":0,"failed":0,"recent":[]},"asOf":{"date":"2026-11-18T01:40:00+00:00","basis":"updated"},"updatedAt":"2026-11-18T01:40:00+00:00","goals":[{"id":"writing","title":"글쓰기"}],"uses":23,"likes":0,"evidence":{"outcome":"질문 한 줄로 1080×1920 세로 영상 두 편(23.6초, 26.6초)이 음성·단어 자막과 함께 나옴. 빈 폴더에서 세팅부터 13분","basis":"shown","basisLabel":"결과물로 확인","result":{"type":"images","images":[{"src":"/results/product-reels/frames.jpg","alt":"첫 영상의 네 장면: 같은 모양의 상세페이지 36장, 한 장으로 겹친 카드, 제품의 사실을 적는 메모, 섹션마다 한 줄만 남는 긴 페이지","label":"첫 영상의 네 장면"},{"src":"/results/product-reels/rerun.jpg","alt":"다른 질문으로 만든 영상의 네 장면: 같은 홍보 문구 24장, 입력창에 넣은 내 글 세 개, 내 글과 챗GPT가 쓴 글의 비교, 정리 한 줄","label":"다른 질문으로 만든 영상"}]},"run":{"by":"OpenCurrent 편집 에이전트 (Claude Code)","input":"질문 둘(상세페이지가 왜 티가 나는지, 홍보 글이 왜 다 똑같은지)과 지어낸 예시 값. 둘째 영상은 빈 폴더에서 이 글의 프롬프트만으로 제작. 맥","mode":"sample","modeLabel":"샘플 데이터로 실행"},"toolRoles":[{"tool":"Claude Code","role":"대본과 장면 설명, 장면 코드, 프레임을 직접 열어 확인하고 수정"},{"tool":"Remotion","role":"코드로 짠 장면을 세로 영상으로 렌더"},{"tool":"FFmpeg","role":"음성 변환과 쉼 측정, 프레임 시트, 멈춘 구간 찾기"}]}}