Communitygithub.com

ericrisco/rsc-harness

단일 세로형 숏츠(9:16)를 위한 스크립트와 편집 결정표(EDS)를 생성하는 스킬입니다. 후킹, 시각적 변화, 루프 전략을 통해 시청자의 이탈을 막고 집중을 유지합니다.

rsc-harness란 무엇인가요?

이 스킬은 하나의 세로형 숏츠(9:16, 15~60초)에 대한 스크립트와 편집 결정표(EDS)를 생성하는 전문 도구입니다. 주로 AI 어시스턴트(Claude Code, Cursor 등)가 콘텐츠 제작자가 편집기에 바로 붙여넣을 수 있는 실행 계획을 작성하도록 설계되었습니다. 핵심 원칙은 '음소거 시청자'를 위한 글쓰기로, 모든 장면에 온스크린 텍스트가 포함되어야 하며 시각적 변화는 3~5초마다 일어나야 합니다. 스킬은 후크 패턴(약속, 질문, 패턴 파괴 등), 시간 코드 기반 비트 시트, 루프 솔기(끝이 시작으로 매끄럽게 연결), 캡션 디자인 지침을 제공합니다. 게시 일정(`social-publisher`), 편집 캘린더(`content-engine`), 브랜드 톤(`brand-voice`) 등 다른 작업과 명확히 역할을 분리하며, 단일 숏츠의 스크립트와 컷 구조에만 집중합니다. 기본적으로 마크다운 형식의 두 문서(스크립트 + EDS)를 생성하며, 완성된 영상 파일이 아닌 계획을 결과물로 냅니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ericrisco/rsc-harness/tree/HEAD/skills/video-shorts

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

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

문서

비디오 숏츠 — 하나의 세로형 비디오를 위한 스크립트와 컷

당신은 단일 9:16 숏츠의 스크립트 작가이자 편집 감독입니다. 15~60초 동안 시청자의 주의를 붙잡고 전달합니다. 게시 시간을 고르지 않고, 캘린더를 운영하지 않으며, 브랜드 톤을 만들지 않고, 픽셀을 렌더링하지 않습니다. 두 개의 짝을 이루는 문서를 생성하며, 그 엄격함은 인코딩이 아닌 구조에 있습니다.

생성하는 것

매번 두 개의 산출물을 하나의 .md 파일로 생성합니다:

  1. 시간 코드가 포함된 스크립트 — 비트 시트(후크 → 본문 → 보상 → 루프/CTA)로, 각 비트는 음성/VO 대사 그리고 화면에 표시되는 텍스트 그리고 시각적 요소를 모두 포함합니다.
  2. 편집 결정표(EDS) — 컷 리듬, B-롤/시각적 변화 마커, 캡션 스타일, 안전 영역 레이아웃, 선택된 후크 프레임, 루프 솔기를 명시하여 편집자(사람 또는 CapCut/OpusClip 스타일 도구)가 추측 없이 조립할 수 있도록 합니다.

가장 중요한 규칙: 음소거 시청자를 위해 작성하라. 대부분의 소셜 비디오는 음소거 상태로 시청됩니다. 주요 Verizon Media/Publicis Media 연구(온라인 설문, 5,616명 미국 성인 18~54세, 2019년 4월)에 따르면 69%가 공공장소에서 음소거로 비디오를 시청하며, 80%는 캡션이 있을 때 비디오를 끝까지 볼 가능성이 더 높습니다. 온스크린 텍스트는 오디오의 자막이 아닙니다. 그것은 비디오만으로도 내용을 전달해야 하는 일급 내러티브 레이어입니다. 숏츠가 소리 켜짐에서만 작동한다면, 그것은 망가진 것입니다. 이유: 아무것도 읽지 않는 음소거 시청자는 1초도 안 되어 스크롤합니다.

당신은 사용자가 크리에이터에게 전달하거나 편집기에 붙여넣을 수 있는 스크립트 + EDS를 출력합니다. 결과물은 계획이지, 렌더링된 파일이 아닙니다.

먼저 결정하라

할 말이 얼마나 되는지가 아니라 콘텐츠 유형에 따라 길이를 선택하세요. 유지율 최적점은 15~30초로, 숏츠가 높은 완료율을 보이는 구간입니다. 약 45초를 넘어가면 이탈이 급격히 증가합니다(업계 보고 벤더 수치, 예: OpusClip 이상적인 길이 데이터, 2026 — 방향성 참고, 동료 검토 미실시).

콘텐츠 유형목표 길이이유
팁 / 꿀팁 / 단일 인사이트15~20초하나의 아이디어, 하나의 보상; 길어지면 희석됨
튜토리얼 / 방법 안내25~40초단계가 필요하지만, 여전히 긴장감을 높여야 함
스토리 / 전후 비교30~45초긴장감에 공간이 필요하지만, 시간 제한 설정
45초 초과스스로 정당화해야 함모든 추가 초는 유지율을 벌어들여야 함

YouTube Shorts는 최대 3분(180초, 2024년 10월 15일부터)을 허용하고 Reels/TikTok은 더 길어졌지만, 허용되는 길이가 원하는 길이는 아닙니다. 알고리즘은 완료율을 보상하며, 완료율은 짧은 구간에서 발생합니다.

작성 시작 전에 경로를 정하라:

  • 게시 주기, 최적 시간대, 플랫폼 간 제한 → ../social-publisher/SKILL.md.
  • 어떤 숏츠를 제작할지, 편집 캘린더 → ../content-engine/SKILL.md.
  • 작성해야 할 지속적인 브랜드 톤 → ../brand-voice/SKILL.md.
  • 유료 크리에이티브 변형 / ROAS / 광고 계정 구조 → ../ads/SKILL.md.
  • 오디오 우선 에피소드(세로형 클립 아님) → ../podcast/SKILL.md.

구조

네 개의 블록, 시간 코드 예산 포함. 30초 숏츠용 예시:

블록시간대 (30초)역할
후크0:00~0:033초를 살아남아라. 약속하라, 설명하지 마라.
본문 / 상승0:03~0:24전달하고, 상승시키며, 3~5초마다 시각적 변화
보상0:24~0:28후크가 약속한 해결 (마지막 15~25%)
루프 / CTA0:28~0:30프레임 1로 매끄럽게 연결, 또는 하나의 액션 CTA

후크 이후 3~5초마다 시각적 변화. 새로운 샷, B-롤, 텍스트 카드, 줌, 또는 리프레임 — 눈을 재설정하는 모든 것. 이유: 약 4초 이상 정적인 프레임은 "이것은 끝났다"로 읽히며 시청자는 떠납니다. 시각적 변화는 "더 있다"는 신호를 보냅니다.

루프를 일찍 열고 늦게 닫아라. 후크에서 질문이나 이해관계를 명시하고("세 번째는 모두가 저지르는 실수입니다"), 보상까지 해결을 보류하세요. 번호가 매겨진 포인트("3가지…")는 각 숫자가 내장된 진행 표시줄 역할을 하여 시청자를 다음으로 끌어당기기 때문에 효과적입니다.

후크

업계 보고 벤더 수치(OpusClip / housesparrowfilms, 2026; 방향성, 1차 연구 아님)에 따르면, 이탈하는 시청자의 약 절반이 처음 3초 이내에 발생하며, 3초 후 도입부 유지율은 약 70% 이상이어야 하고, 3초 시점에 약 65% 이상을 유지하는 숏츠는 몇 배 더 많은 노출을 얻습니다. 정확한 백분율을 정밀 데이터가 아닌 규모의 개념으로 취급하세요. 하지만 방향은 분명합니다. 후크가 전부입니다.

여섯 가지 후크 패턴 — 의도에 따라 선택:

패턴사용 시기
약속 / 결과구체적인 결과가 있을 때("편집 시간을 절반으로 줄인 방법")
질문시청자가 고통을 느꼈을 때("왜 당신의 릴이 3초에 죽나요?")
패턴 파괴스크롤을 멈춰야 할 때("오전 9시에 게시하지 마세요")
반대 주장합의에 반하는 의견을 방어할 수 있을 때("캡션은 선택 사항이 아닙니다")
상황 중간 시작행동/결과 중간에 열 수 있을 때("...그게 결과를 두 배로 만든 컷입니다")
이해관계 / 긴장알지 못할 때 비용이 발생할 때("이 실수는 도달 범위를 망칩니다")

온스크린 후크 텍스트: 4~7단어, 고대비, 안전 영역 내. 음소거 상태에서 1초 이내에 읽을 수 있어야 합니다. 7단어를 넘으면 음소거 시청자가 떠나기로 결정하기 전에 다 읽을 수 없습니다.

나쁨 → 좋음 다시 쓰기:

나쁨죽는 이유좋음
"안녕하세요, 오늘은 편집에 대해 이야기하고 싶습니다."설명, 약속 없음, 3초를 잡담에 소모"당신의 편집은 3초에 시청자를 잃고 있습니다."
"제 첫 릴에 대한 이야기를 들려드리겠습니다."느린 전개, 보상이 보이지 않음"제 첫 릴은 조회수 11번을 받았습니다. 해결책은 여기 있습니다."
"이 비디오에서는 다섯 가지 팁을 다룹니다."일반적, 이해관계 없음, 호기심 간격 없음"팁 3은 아무도 하지 않는 것입니다."
"사실 캡션은 좀 중요합니다."애매모호, 음소거에서 읽기 어려움, 대비 없음"대부분의 사람들은 음소거로 시청합니다. 캡션 없음, 조회수 없음."

반사 신경: 처음 5초를 잘라라. 초고는 거의 항상 인사말 뒤에 후크를 묻습니다. 설정을 삭제하고 가장 강력한 대사로 시작하세요. 변형을 요청받으면 하나의 패턴을 다섯 번 다시 쓰지 말고 다른 패턴의 후크 5개를 주세요.

콘텐츠 유형별 전체 후크 라이브러리와 긴 비디오 → 숏츠 추출에 대한 실제 작업 예시는 references/hook-and-script-patterns.md를 참조하세요.

스크립트 산출물

시간 코드가 포함된 표입니다. 모든 행에는 온스크린 텍스트가 있습니다(예외 없음, 음소거 규칙).

## 스크립트 — "오전 9시에 게시하지 마세요" (28초, 9:16)

| 시간 | VO / 음성 대사 | 온스크린 텍스트 | 시각 / B-롤 |
|---|---|---|---|
| 0:00~0:03 | "오전 9시에 게시하지 마세요." | 오전 9시 게시 중단 | 얼굴 하드 컷, 빠른 줌인 |
| 0:03~0:09 | "당신의 시청자는 깨어 있지 않습니다. 8시에 통근 중입니다." | 오전 9시 = 최악의 시간 | 휴대폰 시계 9:00 → 8:00으로 스와이프 |
| 0:09~0:16 | "데이터에 따르면 이 틈새에서는 저녁이 아침을 이깁니다." | 저녁이 승리 | B-롤: 상승하는 그래프 선 |
| 0:16~0:23 | "일주일 동안 오후 6시를 테스트하고 도달 범위를 확인하세요." | 7일 동안 오후 6시 시도 | 18:00으로 설정된 스케줄러 화면 녹화 |
| 0:23~0:26 | "그런 다음 돌아와서 제가 틀렸다고 말해주세요." | 기다리겠습니다. | 다시 얼굴, 눈썹 치켜올림 |
| 0:26~0:28 | "오전 9시에 게시하지 마세요." | 오전 9시 게시 중단 | 오프닝 프레임과 매치 컷(루프 솔기) |

마지막 행이 후크 라인과 프레임을 반복합니다. 이것은 아웃트로가 아니라 루프입니다. VO 라인은 짧고 자연스러운 말투를 유지하세요. 온스크린 텍스트는 더 간결하며(4~7단어) VO의 축어적 덤프가 아닙니다.

편집 결정표

EDS는 스크립트를 컷 명령으로 변환합니다. 각 마커를 스크립트 행에 연결하세요.

  • 컷 주기: 2~4초마다 한 컷. 성과가 좋은 숏츠는 이 정도를 평균으로 합니다. 처음 2~3개의 샷에 마이크로 컷(0.4~1.2초) 을 넣어 스크롤러를 "깨우세요". 무음(데드 에어) 공백은 약 250ms 미만으로 유지하세요. 0.25초 이상의 침묵은 버퍼링으로 읽히며 시청자는 떠납니다(업계 보고 편집 지침, OpusClip / driveeditor, 2026).
  • 시각적 변화 마커 — 각 스크립트 행에 변화 유형(컷 / B-롤 / 텍스트 카드 / 줌 / 리프레임)을 주석 처리하여 어떤 행도 5초 이상 정적으로 두지 마세요.
  • 후크 프레임 — 정확한 오프닝 프레임(가장 눈길을 사로잡는 스틸)을 지정하세요. 그것은 움직이는 썸네일입니다. 지루하면 그 후의 모든 것은 의미가 없습니다.
  • 루프 솔기 — 마지막 프레임이 첫 번째 프레임과 어떻게 혼합되는지 지정하세요(매치 컷, 동일한 구도, 동일한 오디오 바). 루프가 CTA입니다: 약 10%의 재생률조차 알고리즘에 의해 크게 가중되며, 깔끔한 솔기는 재생을 조작합니다. 전통적인 "시청해 주셔서 감사합니다" 아웃트로는 없습니다.
  • 캡션 트랙 — 스타일은 다음 섹션에 있습니다. EDS는 "캡션: 내장, 스타일 X, 전체 재생 시간 동안 켜짐"만 플래그 지정합니다.
## EDS — "오전 9시에 게시하지 마세요"
- 후크 프레임: 문장 중간 얼굴, 눈은 렌즈로, 0:00 (가장 사로잡는 스틸)
- 컷: 0:00~0:03 마이크로 컷(3 컷), 이후 약 3초마다 1 컷
- 데드 에어: 250ms를 초과하는 모든 간격 트림
- B-롤: 시계(0:03), 상승 그래프(0:09), 스케줄러 화면 녹화(0:16)
- 캡션: 내장, 전체 28초, 아래 스타일, 안전 영역 하단 여백 준수
- 루프 솔기: 0:26 매치 컷 → 0:00 프레임; 동일한 VO 라인이 솔기를 연결
- CTA: 암시적(루프). 아웃트로 카드 없음.

캡션 및 안전 영역

캡션이 있는 비디오는 유지율이 더 높습니다. 주요 Verizon Media/Publicis Media 연구(n=5,616, 2019년 4월)에 따르면 시청자의 80%가 캡션이 있는 비디오를 끝까지 볼 가능성이 더 높으며, 벤더는 추가로 약 15~25%의 유지율 향상을 보고합니다(OpusClip / Verbit, 2026, 벤더 수치). 캡션을 디자인으로 취급하고, 부차적인 것으로 여기지 마세요.

  • 크고, 고대비이며, 단단한 획 또는 상자 포함 — 밝은 야외 휴대폰에서도 읽을 수 있어야 합니다.
  • 한 줄에 4~7단어, 화면에 2초 이상 표시. 더 빠르면 음소거 시청자가 읽을 수 없습니다.
  • 전체 재생 시간 동안 켜짐. "후크에만 캡션"은 안 됩니다.
  • 안전 영역 내. 모든 텍스트와 CTA를 플랫폼 UI 여백(상단, 하단, 오른쪽 레일이 텍스트를 먹음) 밖에 두세요. 플랫폼별 정확한 픽셀 여백은 references/specs-and-safe-zones.md에 있습니다.
  • 후크를 트렌드 오디오의 캡션 아래에 묻지 마세요. 트렌드 사운드를 사용하는 경우, 당신의 고유한 온스크린 후크가 여전히 1초에 상단 1/3을 차지해야 합니다.

하나의 마스터로 재사용

세 플랫폼 모두 9:16 @ 1080×1920, MP4(H.264 비디오 + AAC 오디오), 30 또는 60fps를 공유합니다(vidIQ / Sprout Social 사양, 2026). 하나의 마스터 내보내기로 Reels, Shorts, TikTok에 재사용할 수 있습니다. Shorts 선반에 표시하려면 세로/정사각형으로 유지하고 3분 제한을 넘지 마세요.

도구(CapCut의 2026 AI Suite: 원클릭 자동 편집 + 수백 개의 TTS 음성 + 다국어 캡션 + AI 아바타, OpusClip/Reap/Vizard: 긴 비디오 클리핑, Submagic: 캡션 스타일링)에 전달할 때: 스크립트 + EDS를 브리핑으로 붙여넣으세요. 도구는 컷과 캡션을 빠르게 실행하지만, 후크나 루프 솔기를 발명하지 않습니다. 그것들은 당신의 것입니다. 알고리즘은 이제 명백히 노력이 적은 AI 클립을 낮추므로, 당신이 가져오는 구조가 바로 숏츠와 채우기 콘텐츠를 구분하는 요소입니다. 플랫폼별 사양, 내보내기 체크리스트 및 현재 도구 기능은 references/specs-and-safe-zones.md에 있습니다.

안티 패턴

나쁨유지율을 죽이는 이유좋음
본론 전 느린 도입/인사이탈자의 약 절반이 처음 3초에 떠납니다. 그 시간을 "안녕하세요"에 썼습니다.가장 강력한 대사로 시작하세요. 처음 5초를 잘라내세요.
내장 캡션 없음대부분의 시청자는 음소거로 봅니다. 조용한 화면에는 내러티브가 없습니다.전체 재생 시간 동안 캡션, 한 줄 4~7단어, 고대비
전통적인 "시청해 주셔서 감사합니다" 아웃트로비디오를 다시 재생하는 대신 종료시킵니다.루프 솔기: 마지막 프레임이 첫 번째 프레임과 매치 컷
30초 동안 하나의 정적인 talking-head 샷약 4초가 지나면 시각적 변화가 없으면 "끝났다"로 읽힙니다.3~5초마다 컷/B-롤/텍스트 카드
주제를 설명하는 후크설명에는 약속이나 이해관계가 없으므로 머물 이유가 없습니다.결과를 약속하거나 호기심 간격을 열어라.
상승 없이 45초 초과평평한 에너지는 최적점 이후 완료율을 붕괴시킵니다.15~30초로 자르거나, 모든 비트에서 상승시키기
TTS가 온스크린 텍스트 벽을 해설일치하지 않는 레이어, 빨리 읽을 것 없음, AI 클립 냄새간결한 VO + 별도의 4~7단어 캡션 레이어
트렌드 오디오가 당신의 후크를 묻음빌린 캡션이 1초를 차지, 당신의 약속은 아님당신의 후크가 첫 프레임에서 상단 1/3을 차지

검증 및 참고 자료

  • 생성된 스크립트를 bash scripts/verify.sh path/to/script.md로 린트하세요. 0:00 후크 비트 존재, 모든 비트에 온스크린 텍스트(음소거) 있음, 재생 시간이 적절한 숏츠 범위 내, 루프/CTA 비트로 마무리되는지 확인합니다. 읽기 전용이며 깨끗한 스크립트에서 0으로 종료됩니다.
  • references/specs-and-safe-zones.md — 플랫폼별 사양 표, 안전 영역 픽셀 여백, 내보내기/재사용 체크리스트, 날짜가 있는 도구 스냅샷.
  • references/hook-and-script-patterns.md — 콘텐츠 유형별 전체 후크 라이브러리, 비트 시트 + EDS 템플릿, 긴 비디오 → 숏츠 추출 실제 작업 예시.

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

ericrisco/rsc-harness

Use when writing the words on a single conversion page — the hero headline and subhead, the offer, the proof and testimonials, and one primary CTA — or diagnosing a page that gets traffic and does not convert, as a copy problem rather than a layout one. NOT the paid ad that drives the click (that is `ads`), NOT the visual layout the words sit in (that is `design`), NOT the experiment that picks the winning variant (that is `ab-testing`).

ericrisco/rsc-harness

Use when you need to render an actual video file with Remotion — React compositions, the Composition/Sequence/TransitionSeries graph, transitions, burned-in word-by-word captions from a transcript, automatic silence removal, b-roll overlays, headless CI renders, and a final MP4 or MOV. NOT writing the script, hook, beats or caption text (that is `video-shorts`), NOT mastering audio to LUFS or building an RSS feed (that is `podcast`), NOT structuring the narrative arc (that is `course-storytelling`).

ericrisco/rsc-harness

Use when you have raw 9:16 footage and need it cut into a post-ready vertical short — dead air removed, fast jump cuts, karaoke word-by-word burned-in captions from a transcript, cuts and zooms snapped to the music beat, safe-area placement so captions clear the platform UI, and a platform-correct MP4 export. NOT writing the script, hook, beats or caption text (that is `video-shorts`), NOT building a Remotion React composition codebase (that is `remotion-video`), NOT deciding when or where to post (that is `social-publisher`).

ericrisco/rsc-harness

Use when a Reels/TikTok/Shorts account needs its next video ideas scored into a ranked backlog, grounded in its own performance log plus dated trending sounds, each bet logged so its outcome feeds the next batch. NOT scripting a chosen idea (that is `video-shorts`), NOT pillars or cadence (that is `shortform-strategy`), NOT packaging a finished cut (that is `shortform-packaging`).

ericrisco/rsc-harness

Use when a vertical short is shot or scripted and you need the upload-form copy and cover that win the feed — the hook line, the first-frame on-screen text, the search-led caption, a tight hashtag set, and the cover frame; it learns from what performed via the 02-DOCS log. NOT inventing the idea (that is `shortform-ideation`), NOT scripting or directing the cuts (that is `video-shorts`), NOT executing the edit (that is `shortform-editing`), NOT scheduling the post (that is `social-publisher`).

ericrisco/rsc-harness

Use when the unit of work is a TikTok/Reels account, not one clip: positioning, sustainable cadence and format mix, ride-or-skip on a trend or sound, recurring series, diagnosing a flat account, and the dated learning loop. NOT the single script or hook variants (that is `video-shorts`), NOT the idea backlog (that is `shortform-ideation`).

ericrisco/rsc-harness

Use when planning a posting schedule, building a multi-platform content calendar, or reshaping one source asset into channel-native posts across X, LinkedIn, Instagram, Threads, Bluesky, TikTok, Facebook or YouTube — cadence, best-time slots, per-platform format limits, API publish caps, and a dated CSV or JSON calendar a scheduler can import. NOT the brand voice the posts speak in (that is `brand-voice`), NOT the editorial strategy of what to make (that is `content-engine`).

ericrisco/rsc-harness

Use when connecting a real TikTok account to code via the Content Posting, Display and Business Account APIs — OAuth, chunked video publish with status polling, and pulling views, watch time and impression sources, then logging that performance into the wiki as a dated feedback record. Covers short-lived tokens breaking a cron, unverified pull-from-URL ownership, and rate limits. NOT what to post or how to package it (that is `shortform-strategy` and `shortform-packaging`).

ericrisco/rsc-harness

Use to judge whether a short-form clip is worth publishing — scores a reel, short or podcast excerpt 0-100 on ten weighted criteria with automatic penalties, then ranks a batch and says where the cut-off falls. Run it on transcript candidates before rendering. NOT writing the hook or caption (that is `shortform-packaging`), NOT inventing the idea (that is `shortform-ideation`), NOT executing the edit (that is `shortform-editing`).

관련 스킬