Communitygithub.com

ericrisco/rsc-harness

세로형 쇼츠 영상이 촬영되거나 스크립트가 완성되었을 때, 업로드 폼에 들어갈 카피와 피드를 장악할 커버를 제작합니다. 아이디어를 만드는 것이 아니라, 기존 영상의 포장을 담당합니다.

rsc-harness란 무엇인가요?

이 스킬은 쇼츠 영상의 '포장'을 전문적으로 담당합니다. 영상 자체의 아이디어나 편집이 아닌, 업로드 시 필요한 훅 라인, 첫 프레임 자막, 캡션, 해시태그, 커버 프레임과 같은 복사본을 생성하여 시청자의 이탈을 막고 공유를 유도하는 것이 핵심입니다. 이 스킬의 차별점은 계정의 과거 성과 데이터(02-DOCS 로그)를 기반으로 최적화한다는 점에 있습니다. 막연한 추측이 아닌, 실제로 높은 시청 유지율과 공유율을 기록했던 요소들을 분석하여 더 나은 포장재를 만듭니다. TikTok, Instagram Reels, YouTube Shorts 등 세로형 쇼츠 플랫폼에서 작동하며, 각 플랫폼의 검색 알고리즘과 시청 행태(음소거 시청 60%)에 맞춰 세부 전략을 조정합니다. 출력물은 항상 2-3개의 테스트용 변형 세트로 제공되며, 테스트 결과는 다시 02-DOCS에 기록되어 지속적으로 학습합니다.

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

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

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

문서

숏폼 패키징

당신은 완성되었거나 스크립트가 있는 세로형 쇼츠를 감싸는 글과 프레임을 작성하여, 해당 콘텐츠가 피드에서 살아남도록 만듭니다. 클립은 이미 존재합니다 — 당신의 업무는 업로드 폼에 들어갈 카피와, 스크롤러가 멈출지, 끝까지 볼지, 친구에게 보낼지를 결정하는 커버입니다. 당신은 아이디어도, 스크립트도, 편집도, 스케줄도 아닙니다. 훌륭한 클립도 약한 포장재로 죽습니다; 검증된 포장재는 좋은 클립을 배가시킵니다.

당신은 계정 자체의 02-DOCS 로그에서 가져온 측정된 시청 유지율과 공유율에 대해 최적화합니다 — 직감이나 최신 '바이럴 훅' 게시물에 근거하지 않습니다.

당신이 생산하는 것

매번 다섯 가지 결과물과 하나의 피드백 항목:

  1. 훅 라인 — 말하거나 쓰는 오프너, 4-7단어로, 3초를 넘겨야 합니다.
  2. 첫 프레임 온스크린 텍스트 세트 — 음소거 상태의 스크롤러가 오디오를 재생하기 전에 읽는 화면 내 텍스트; 테스트할 2-3개 변형, 각 7단어 이하.
  3. 캡션 — 검색 중심, 앞부분에 키워드를 배치한 첫 문장.
  4. 해시태그 세트 — 3-5개의 주제 신호 태그, 절대 발견형 덤프가 아닙니다.
  5. 커버 프레임 + 오버레이 — 그리드/Shorts 선반의 광고판이 될 프레임과 3-6단어의 오버레이.
  6. 02-DOCS 피드백 항목 — 무엇이 출시되었는지, 어떤 지표가 움직였는지, 무엇이 이겼는지.

전제 조건 (건너뛰지 마세요). 영상이 촬영되었거나 스크립트가 있어야 하며, 아이디어/앵글이 결정되어 있어야 합니다. 스크립트가 없으면 video-shorts로 라우팅하세요. 확정된 아이디어가 없으면 shortform-ideation으로 라우팅하세요. 여기서 어느 쪽도 발명하지 마세요 — 결정되지 않은 쇼츠를 포장하는 것은 훅, 키워드, 시청자를 동시에 추측하는 것을 의미합니다.

규칙 제로: 시드 테스트와 전송을 위한 패키징

아래의 모든 선택은 정확히 두 가지 결과를 위한 것입니다. 이를 명심하세요:

  • 시드 테스트가 전부입니다. TikTok과 Shorts는 각 업로드를 먼저 작은 시드 시청자에게 푸시합니다; 약한 인트로 시청 유지율과 높은 스와이프 이탈은 분포가 퍼지기 전에 배포를 죽입니다. 인트로 시청 유지율 (3초를 넘긴 비율) 70%+ 가 기준이며, 처음 약 3초가 클립이 끝까지 완주되는지 여부에 가장 큰 영향을 미칩니다. 따라서 훅 + 첫 프레임 텍스트 + 커버는 전체 게시물에서 가장 영향력이 큰 카피입니다.
  • 전송과 저장이 좋아요보다 더 중요한 화폐입니다. Instagram의 명시된 Reels 순위 요소는 시청 시간, 도달 대비 좋아요, 그리고 **도달 대비 전송(DM 공유)**입니다; Mosseri는 전송과 저장이 좋아요보다 더 많은 의도를 신호한다고 반복해서 말했으므로, 이를 좋아요보다 중요하게 취급하십시오. 허영심 좋아요가 아닌 "이걸 누군가에게 보내야 해"를 위해 패키징하세요.

먼저 기반을 다지세요

한 단어를 쓰기 전에 계정을 읽으세요. 이를 건너뛰면 낯선 사람의 목소리로 이미 승리한 것과 모순되는 일반적인 카피가 생성됩니다.

  1. 브랜드 보이스와 이전 패키지를 위해 02-DOCS/wiki/shortform/을 읽으세요.
  2. 성과 피드백 로그를 읽으세요 — 어떤 훅, 커버, 해시태그가 이미 인트로 시청 유지율과 전송을 높였는지 확인하세요. 승리자의 형태를 앞으로 가져가세요.
  3. shortform-ideation 출력물에서 결정된 아이디어/앵글을 가져오세요(존재하는 경우).
  4. 스크립트가 없거나 앵글이 확정되지 않았나요? 밖으로 라우팅하세요 (핸드오프 참조). 절대 여기서 발명하지 마세요.

패키지를 02-DOCS/wiki/shortform/ 아래에, 원시 테스트 결과는 02-DOCS/raw/shortform/ 아래에 보관하십시오. shortform/ 위키 트리는 tiktok-api 및 shortform-strategy 형제와 공유되는 OKF v0.1 번들입니다: 각 보관된 패키지 .md 파일은 비어 있지 않은 type: shortform-package(및 권장 title/tags/timestamp)를 포함하는 YAML 머리말로 시작하며, 모든 상호 참조는 [[wikilinks]]가 아닌 표준 마크다운 링크를 사용합니다. 02-DOCS/raw/shortform/ 아래의 원시 피드백 로그는 raw/이며 wiki/가 아닙니다 — 머리말이 필요하지 않습니다. 전체 머리말 및 패턴 깊이는 references/package-templates.md에 있습니다.

2초의 결정

스크롤러는 두 가지 상태 중 하나로 당신의 쇼츠를 만나며, 당신은 둘 모두를 위해 설계합니다:

  • 피드/FYP에서: 프레임 1이 음소거로 재생됩니다. 약 60%가 음소거로 시청하므로, 첫 프레임 온스크린 텍스트가 훅을 전달합니다 — 오디오 재생 여부가 결정되기 전에 읽힙니다.
  • 프로필 그리드 또는 Shorts 선반에서: 커버 프레임을 먼저 보게 되며, 잘리고 무음입니다.

따라서 세 가지 결과물(말하는 훅, 첫 프레임 온스크린 텍스트(그것의 무음 쌍둥이), 커버 오버레이)은 동일한 단어로 동일한 약속을 말해야 합니다. 함께 설계하십시오; 절대 그들이 멀어지게 두지 마십시오.

훅 라인 + 온스크린 텍스트

배포를 결정하는 3초. 각각 이유가 있는 규칙:

  • 4-7단어. 더 길면 음소거 스크롤러가 읽기를 끝내기 전에 스와이프합니다.
  • 설정이 아닌 약속이나 긴장감으로 시작하세요. 결과물이나 걸린 것이 먼저 옵니다; 맥락은 캡션을 기다릴 수 있습니다.
  • 온스크린 텍스트는 말하는 훅의 무음 쌍둥이입니다 — 말하는 훅을 화면 내 텍스트로 다시 진술하여 음소거 상태의 대다수가 이해할 수 있게 하십시오. 안전 구역(상단 상태 표시줄과 하단 UI: 캡션, 버튼, 프로필 탭 대상 영역에서 떨어진 곳) 내에 유지하십시오.
  • 절대 하나가 아닌 2-3개 변형의 SET을 출력하십시오. 당신은 방어할 추측이 아니라 시드 시청자에게 측정할 가설을 배송하는 것입니다.
나쁨좋음이유
"안녕하세요 여러분, 오늘은 제가 이야기하고 싶었던 것은...""할 일 앱을 삭제했습니다. 그 이유는요."약속을 먼저; 3초를 넘깁니다.
"끝까지 봐주세요!""아무도 안 하는 마지막 단계"구걸이 아닌 구체적인 이해 관계가 있는 열린 루프.
온스크린: (없음 — 오디오에 의존)온스크린: "Notion을 대체한 3개의 앱"음소거 60%를 위해 훅을 전달합니다.
훅은 X라고 말하고, 온스크린 텍스트는 Y라고 말함훅과 온스크린 텍스트가 동일한 5단어를 말함쌍둥이 약속, 표류 없음.

전체 패턴 라이브러리 (열린 루프 · 숫자 · 반대 의견 · 이해 관계 · 관점 · 전후)와 나쁨→좋음 재작성은 references/package-templates.md에 있습니다.

캡션

캡션은 이제 검색 순위 필드이며, 던져놓는 한 줄이 아닙니다. Mosseri는 캡션을 Reels 순위 요소로 나열합니다; TikTok과 Instagram 검색은 페이지 카피처럼 캡션 언어를 읽습니다. 규칙:

  • 첫 문장을 시청자가 실제로 검색할 키워드 구문으로 시작하세요 — 티저나 질문이 아닙니다. 키워드로 시작하는 첫 줄이 인앱 검색과 '관련' 레일에서 클립을 표면화하는 것입니다; 티저 줄은 아무 데도 표면화되지 않습니다.
  • '더보기' 전에 처음 약 100-150자만 표시됩니다. 키워드, 가치, 코드/링크를 거기에 두십시오. 나머지는 결코 보이지 않을 수 있습니다.
  • 맥락과 참여를 위해 약 150-300자가 적합합니다; 의도적으로 교육적/SEO 게시물의 경우에만 500자 이상으로 가십시오. 하드 한도(TikTok 4,000자, Reels 2,200자)는 무관합니다 — 첫 줄이 일을 합니다.
  • 저장/전송할 가치가 있는 결과물과 하나의 소프트 CTA로 끝내세요. "좋아요와 팔로우 부탁드립니다"보다 "이게 필요한 친구에게 보내주세요"가 낫습니다.

질문에 따라 캡션 형태를 선택하세요:

목표가...캡션 형태
인앱 검색에서 순위 (에버그린, 방법)키워드 구문 먼저 → 가치 → 소프트 CTA. 200-400자로 유지.
시의적절/재미있는 클립에 대한 참여간결한 결과물 라인 + 전송 프롬프트. 약 150자 유지.
나쁨좋음
"기다려보세요 👀 믿기지 않을 거예요""제 할 일 앱을 대체한 3개의 Notion 템플릿 (무료 링크 아래에)"
"새 영상입니다!! 확인해보세요 🔥🔥""한 오후에 일주일치 쇼츠를 배치하는 방법 — 정확한 워크플로우"

해시태그

규칙이 바뀌었습니다; 예전의 30개 태그 덤프는 이제 약점입니다.

  • 3-5개의 해시태그. 절대 그 이상 하지 마세요. Instagram은 이제 게시물/릴스를 5개로 하드 제한합니다 (Mosseri, 2026년으로 롤링 중) 해시태그는 "알고리즘을 위해 콘텐츠를 분류"한다고 명시합니다 — 도달을 높이지 않습니다. TikTok 모범 사례 또한 3-5개입니다 (CapCut, ByteDance 자체 편집기); 10개 이상은 스팸 신호를 보내고 알고리즘에 혼합 신호를 줍니다.
  • 발견형이 아닌 주제 신호. 비디오가 무엇인지를 나타내는 특정 태그를 선택하세요, #fyp #viral #foryou 같은 광범위한 도달 미끼가 아닙니다.
  • 플랫폼별로 조정하세요. 동일한 클립이지만 각 플랫폼의 검색 시청자에 맞추세요 — TikTok에서 순위가 높은 태그는 Reels에서 노이즈일 수 있습니다.
나쁨:   #fyp #foryou #viral #trending #productivity #notion #app #tech #life #2026 ... (22개 더)
좋음:  #notiontemplates #productivitytips #notionsetup

커버 프레임

커버는 그리드/검색/선반의 광고판입니다 — 다시 보기와 프로필 방문을 판매하며, 피드 내에서 재생되는 것이 아닙니다. 선택하고 사양을 정하세요:

  • 움직임이 많고, 대비가 높거나, 감정이 절정인 프레임을 선택하세요 — 표정이 살아있는 얼굴이나 시각적 결과물. 평평하거나 말하는 중간 프레임은 피하세요.
  • 크롭을 존중하세요. Reels 커버는 Reels 탭에서 전체 9:16(1080×1920)을 보여주지만, 프로필 그리드는 3:4(1080×1440)로 자릅니다 — Instagram은 2025년에 그리드를 3:4로 옮기면서 1080×1920 프레임의 상단 및 하단 약 240px을 제거했습니다(postfa.st "Instagram Reels Size", Buffer 2026). 피드는 다시 다르게 자릅니다(4:5, 1080×1350). 모든 크롭에서 살아남는 유일한 영역은 **1:1 중앙 정사각형(1080×1080)**입니다 — 따라서 모든 커버 텍스트를 그 중앙 정사각형 안에 유지하면 그리드, 피드, 탭에서 안전합니다.
  • 3-6단어의 오버레이를 추가하세요 — 훅과 동일한 단어, 높은 대비.

커버 체크리스트:

  • 프레임에 움직임/대비/얼굴이 있거나 결과물을 보여줌 (평평한 중간 프레임이 아님)
  • 오버레이는 3-6단어이며 훅 라인과 일치함
  • 오버레이 텍스트가 1:1 중앙 정사각형 안에 있음 (3:4 그리드 크롭, 4:5 피드 크롭, 9:16 탭에서 살아남는 유일한 영역)
  • 텍스트가 상단 상태 표시줄과 하단 UI를 벗어남

학습 루프 (02-DOCS)

이것이 스킬을 복리로 만드는 핵심입니다. 쓰기 전에 승리자를 읽고; 출시 후 결과를 추가하세요. 배포를 움직이는 지표에 로그를 기록하세요 — 좋아요가 아닙니다:

- shipped: "2026-06-02 / faceless productivity TikTok"
  hook: "I deleted my to-do app. Here's why."
  on_screen_text: "3 apps that replaced Notion"
  cover_overlay: "I deleted my to-do app"
  hashtags: ["#notiontemplates", "#productivitytips", "#notionsetup"]
  intro_retention: 0.74   # 3초를 넘김 — 기준은 0.70
  sends_per_reach: 0.018  # DM 공유, 공유 경제의 화폐
  saves: 312              # 좋아요보다 가중치 높음 (의도 신호)
  won: "숫자로 시작하는 온스크린 텍스트가 질문 변형보다 인트로 시청 유지율에서 우세함"

채워진 스키마와 플랫폼별 조정 예제는 references/package-templates.md에 있습니다. 다음 패키지를 작성할 때, 먼저 로그를 열고 승리한 형태를 반영하세요.

세트로 테스트하고, 세 가지 플랫폼에 출시하세요

사양은 공유됩니다 — 9:16, 1080×1920, MP4 H.264/AAC — 따라서 하나의 패키지가 TikTok, Reels, Shorts에서 재사용됩니다. 그러나 캡션 키워드와 해시태그는 각 플랫폼의 검색 시청자에 맞게 조정하고, 1:1 안전 정사각형을 Instagram에서 가장 중요하게 취급하십시오. 훅 + 온스크린 텍스트 + 커버의 2-3개 변형을 출시하고, 어떤 것이 인트로 시청 유지율과 전송을 높였는지 읽고, 기록하고, 반복하세요.

핸드오프

요청이 업로드 폼 카피와 커버를 벗어나는 순간 밖으로 라우팅하세요. 징후: 위의 다섯 가지 결과물 중 하나이면 여기서 처리하고, 그렇지 않으면 형제에게 보내십시오.

요청라우팅 대상
쇼츠의 아이디어/주제/앵글 발명shortform-ideation
계정 수준 계획: 틈새, 게시 빈도, 플랫폼, 성장shortform-strategy
말하는 스크립트 / 비트 시트 작성, 컷 지시video-shorts
편집 실행 — 캡션 화면 내 표시, B-롤, 사운드 동기화shortform-editing
완성된 쇼츠 예약/크로스포스트social-publisher
플랫폼 Graph/API를 통해 프로그래밍 방식으로 업로드tiktok-api / instagram-api
긴 형식 YouTube 동영상의 제목/설명/태그youtube-packaging
모든 콘텐츠에서 재사용되는 지속적인 브랜드 톤 정의brand-voice

video-shorts와의 명확한 경계: 그 형제는 내러티브의 일부로 모든 비트의 내부 온스크린 텍스트를 소유합니다. 당신은 패키징 계층 — 단일 첫 프레임 훅 오버레이, 캡션, 해시태그, 커버 — 을 소유하며, 스크립트의 존재를 전제 조건으로 취급합니다.

안티 패턴

안티 패턴대신 이렇게 하세요
캡션이 티저로 시작 ("기다려보세요 👀")첫 문장을 검색된 키워드 구문으로 시작하세요.
하나의 훅만 출시하고 세트로 출시하지 않음시드에서 테스트할 2-3개의 훅 + 온스크린 텍스트 변형을 출력하세요.
15-30개의 해시태그 덤프3-5개의 특정 주제 태그; IG는 5개로 하드 제한, TikTok 모범은 3-5개.
좋아요 미끼 CTA ("좋아요 폭파")저장/전송 결과물 — 전송과 저장이 좋아요보다 중요합니다.
1:1 중앙 정사각형 밖의 커버 텍스트오버레이를 중앙 정사각형 안에 유지 — 3:4 그리드, 4:5 피드, 9:16 탭 크롭에서 살아남는 밴드 — UI에서 떨어지게.
훅과 일치하지 않는 온스크린 텍스트온스크린 텍스트를 무음 쌍둥이로 만드세요 — 같은 단어.
맹목적으로 쓰고 02-DOCS 로그 무시먼저 이전 승리자를 읽고; 승리한 형태를 앞으로 가져가세요.
스크립트/아이디어가 있기 전에 패키징먼저 video-shorts / shortform-ideation으로 라우팅하세요.
동일한 캡션을 모든 플랫폼에 복사-붙여넣기각 플랫폼의 검색 시청자에 맞게 키워드와 해시태그를 조정하세요.
성공 지표로 좋아요 기록인트로 시청 유지율, 도달 대비 전송, 저장을 기록하세요.

검증

scripts/verify.sh <package-file>은 하나의 패키지 초안에 대한 읽기 전용, 네트워크 없는 린트입니다: 훅 세트에 ≥2개 변형이 있음; 온스크린 텍스트가 존재하고 한 줄에 ≤7단어임; 캡션의 첫 문장이 ≤약 150자이고 금지된 티저로 시작하지 않음; 해시태그 수가 3-5개임; 커버 프레임 + 오버레이가 존재함; intro_retention, sends_per_reach, saves가 포함된 02-DOCS 피드백 블록이 존재함. 깨끗하거나 빈 파일은 0으로 종료됩니다 — 절대 거짓 실패가 아닙니다. 케이스가 어떻게 실행되는지는 evals/README.md를 참조하세요.

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 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 when scripting or directing the edit of a single vertical short that has to hold attention from the first frame — turning a topic, a clip or a long video into a shot-by-shot script and an edit decision sheet, fixing a hook that dies in second three, generating hook variants to test, and planning cuts and on-screen text. NOT scheduling or cross-platform cadence (that is `social-publisher`), NOT running the editorial calendar (that is `content-engine`), NOT defining the durable brand tone (that is `brand-voice`).

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`).

관련 스킬