릴스 스크립팅

Reels Scripting

Codex 및 Claude 런타임

• 이 스킬은 Codex 또는 Claude에서 현재 작업에 실제로 사용 가능한 도구를 사용합니다. AskUserQuestion 예제는 질문을 설명하는 것이지 필수 API가 아닙니다. 사용 가능한 질문 도구를 한도 내에서 사용하거나 채팅에서 질문하세요. 이미 제공된 답변과 소스 자료를 재사용하세요.
• 사용자가 선택한 프로젝트에서 작업하세요. 개인화 작업 전에 about-me.md, voice.md 및 관련 브랜드 파일을 읽으세요. 파일이 충돌하거나 기본값인 경우 의도된 작성자를 확인하세요. 누락된 정보가 있으면 질문하거나 voice-builder를 실행하세요. 관리자의 신원, 계정 또는 개인 파일을 상속하지 마세요.
• 이 스킬 폴더를 기준으로 번들된 references/를 해석하세요. 명시적으로 요청된 프로필 새로고침의 경우, 기존 about-me.md, voice.md 또는 newsletter-voice.md를 읽고 업데이트하고, 관련 없는 사용자 정보와 규칙은 보존하세요. 소비자는 해당 정식 파일을 다시 읽어야 합니다. 새로운 산출물은 관련 없는 기존 파일과 충돌할 경우에만 새 파일명을 사용하세요. 설치만으로는 인터뷰를 시작하거나 파일을 쓰지 않습니다. 요청되지 않은 영구 학습 내용을 기록하지 마세요.
• 먼저 제공된 증거를 사용하세요. 필요한 경우 검색/소스 도구를 통해 외부 주장을 검증하세요. 소스나 통합이 불가능한 경우, 누락된 기능을 명시하고 제공된 텍스트/내보내기 입력을 제안하세요. 사실, 1인칭 경험, 메트릭 또는 성공적인 도구 실행을 지어내지 마세요.
• 선택한 경로에 필요한 서비스만 사용자의 기존 계정을 통해 연결하세요. 자격 증명을 출력하거나 연결을 덮어쓰지 마세요. 초안 작성, 저장 및 검토는 게시, 메시지 전송 또는 계정 변경을 승인하지 않습니다.

중요: 로드 시 자동 시작

이 스킬이 트리거되면 바로 1단계로 이동하세요. 요약하지 마세요.

전제 조건

전체 Apify + Gemini 비디오 분석 경로에는 다음이 필요합니다:

• APIFY_API_TOKEN 환경 변수 (Instagram 스크래핑)
• GOOGLE_AI_API_KEY 환경 변수 (Gemini 2.5 Flash 비디오 분석)
• Node.js 18+ 및 apify-client와 @google/generative-ai 패키지

선택한 경로에 필요한 기능만 확인하세요. URL 추출 및 Gemini 비디오 분석의 경우, 사용자의 기존 자격 증명이 있는지 출력하지 않고 확인한 후, 제공자와 모델을 사용할 수 있는지 확인하세요. 누락된 자격 증명, 패키지, 비공개 비디오 또는 사용할 수 없는 모델은 해당 단계를 보류 상태로 둡니다. 무엇이 누락되었는지 설명하고, 계정 구성을 수정하거나 제공자를 조용히 대체하지 마세요.

제공된 비디오는 Apify를 건너뛸 수 있습니다. 제공된 대본/분석은 3단계와 4단계를 건너뛰고 5단계에서 레이블이 지정된 대본 기반 스크립트를 지원할 수 있지만, Gemini 비디오 분석 결과는 아닙니다. 설치된 패키지를 재사용하고, 도우미 스크립트를 생성하기 전에 현재 공식 SDK 및 액터 문서를 확인하고, 제공자 비용이 발생하기 전에 사용자의 승인을 받으세요.

1단계. 참조 가져오기

질문:

참조 릴스 URL 또는 Notion 링크를 붙여넣으세요. 이것은 포맷을 리버스 엔지니어링하려는 아웃라이어 Reel입니다.

URL을 기다리세요.

사용자가 Notion 링크를 붙여넣은 경우, 사용 가능한 승인된 Notion 커넥터를 통해 읽고, 페이지에서 Instagram Reel URL을 찾아 추출하세요. Notion 페이지에서 Reel URL을 찾을 수 없으면 사용자에게 Reel URL을 직접 붙여넣도록 요청하세요.

2단계. 뉴스레터 주제 가져오기

질문:

이 Reel로 리퍼포즈하려는 뉴스레터의 주제는 무엇인가요? 관련 뉴스레터 섹션을 붙여넣거나, 핵심 아이디어를 한 문장으로 입력하세요.

주제를 기다리세요. 프로젝트에 newsletter-voice.md, voice.md, about-me.md가 있으면 읽어서 스크립트가 사용자의 음성과 일치하도록 하세요.

3단계. Reel 스크래핑 및 다운로드

선택한 프로젝트에 새 outputs/reels/<slug>/ 폴더를 사용하세요. 기존에 적합한 도우미가 있으면 재사용하고, 그렇지 않으면 해당 폴더에 소규모 작업별 Node.js 스크립트를 작성하세요:

1. apify-client와 기존 apify/instagram-reel-scraper 경로를 사용하되, 먼저 현재 문서화된 스키마를 확인하여 단일 요청된 Reel에 대해 사용하세요. deepScrape 또는 numComments를 포함한 댓글, 답글 또는 댓글 스레드를 절대 스크래핑하지 마세요. 호출하기 전에 제공자가 게시물/비디오 전용 수집을 지원하는지 확인하고, 그렇지 않으면 비디오 업로드를 요청하세요. 추측성 액터 입력을 사용하지 마세요.
2. 반환된 항목에서 videoUrl을 추출합니다.
3. 비디오를 outputs/reels/<slug>/downloads/{username}_{shortCode}.mp4로 다운로드합니다.
4. 원시 스크래핑 데이터를 outputs/reels/<slug>/reel_data_{shortCode}.json에 저장합니다.

스크립트를 실행하세요. 계속 진행하기 전에 파일 크기와 메타데이터(조회수, 좋아요, 사용 가능한 경우 집계 댓글 수, 캡션 처음 200자)를 확인하세요.

단일 Reel은 참조 자료이지, 검증된 아웃라이어가 아닙니다. 제공되거나 명시적으로 요청된 비교 데이터가 동일한 크리에이터의 최근 게시물 대비 성능을 입증하는 경우에만 아웃라이어라고 부르세요. 샘플, 기간 및 복수 항목을 인용하세요. 해당 기준을 지어내지 마세요.

4단계. Gemini 2.5 Flash로 분석

Node 스크립트를 확장(또는 두 번째 패스 실행)하여 다음을 수행합니다:

1. 다운로드된 .mp4를 base64로 읽습니다.
2. genAI.getGenerativeModel({ model: 'gemini-2.5-flash' })를 호출합니다.
3. 다음 정확한 프롬프트와 함께 비디오를 전송합니다:

이 Reel을 연구하여 [about-me.md의 청중]을 위해 비슷한 스타일의 스크립트를 작성하려고 합니다.

## 전체 대본
- 모든 단어를 타임스탬프와 함께 전사

## 후크
- 정확히 처음 말한 단어
- 후크의 단어 수
- 스크롤을 멈추게 하는 요소는 무엇인가요?

## 언어 패턴
- 평균 문장 길이
- you/your 대 I/me 비율
- 포인트 사이의 전환
- 'just' 최소화 장치는 어디에 있나요?

## 구조
- 총 길이
- 타이밍이 포함된 섹션 구분
- 전환점은 무엇인가요?
- CTA는 무엇인가요?

## 하나의 핵심 인사이트
- 이 Reel에서 배울 수 있는 가장 중요한 단일 기법

분석을 outputs/reels/<slug>/analysis_reference_{shortCode}.md에 저장합니다.

5단계. 새 Reel 스크립트 작성

4단계의 분석, 2단계의 뉴스레터 주제, 사용자의 음성 파일을 사용하여 새 Reel 스크립트를 outputs/reels/<slug>/reel-[slug].md에 작성하세요.

다음 규칙을 적용합니다(협상 불가):

후크

• 절대 "나는"으로 시작하지 마세요. "이것", "당신", 사실 또는 이름을 사용하세요.
• 입증된 형식: "이것은... 영원히 바꿨다" / 부정 전환 ("X는 쓸모없다... 하지 않으면") / 능력 진술.
• 후크는 3초 이내에 호기심 또는 패턴 인터럽트를 만듭니다.
• 참조 분석에서 후크의 단어 수와 구조를 미러링하세요.

본문

• 영국 영어. 짧은 문장. 줄표나 세미콜론은 사용하지 마세요.
• 대화식으로 "you"와 "just"를 사용하세요 ("you just drop in...").
• 세 개 이상의 단속적 조각을 병합하지 마세요. 하나의 흐르는 문장으로 결합하세요.
• 결론을 말하지 마세요. 사실이 스스로 말하게 하세요.
• 사용자에게 실제 전달 가능한 결과물과 확인된 자동화가 있는 경우에만 댓글 CTA를 사용하세요. 그렇지 않으면 전달 약속을 하지 않는 관련 다음 조치를 사용하세요.

댓글 트리거 (지원되는 경우에만)

• 대문자 단어 하나만 사용하세요 (SCRIPT, WIKI, PROMPTS, VIDEO).
• 약속되는 내용과 직접적으로 관련되어야 합니다.
• 따옴표, "아래" 또는 후행 구두점 없음.

CTA

• "Comment [WORD] and I'll send you [specific thing]"
• 짧게. "the link to my full" 패딩 없음.

길이 및 구조

• 총 30~45초.
• 최대 2개의 핵심 포인트, 3개가 아닙니다.
• 캡션은 스크립트를 미러링합니다. 둘을 함께 업데이트하세요.

스크립트 파일 구조

# Reel: [제목]

## 참조 분석
- URL: [reel url]
- 조회수: [number]
- 주요 기법: [Gemini 분석에서]

## 목표 길이
30-45초

## 후크 (0-3초)
[정확한 단어]

## 포인트 1 ([시작]-[끝]초)
[정확한 단어]

## 포인트 2 ([시작]-[끝]초)
[정확한 단어]

## CTA ([시작]-[끝]초)
[정확한 다음 조치, 전달이 확인된 경우에만 댓글 약속 포함]

---

## 캡션
[Instagram용으로 포맷된 스크립트 미러링]

## 댓글 트리거 (구성된 경우에만)
[WORD 또는 해당 없음]

## 전달물 (약속된 경우에만)
[실제 사용 가능한 리소스 또는 해당 없음]

---

## 시각적 노트
[컷, B-롤 아이디어, 텍스트 오버레이]

6단계. QA 루프

실행 중인 어시스턴트에서 검토: 소스 정확도(30점), 사용자 음성(25점), 후크 및 구조(20점), 음성 길이 및 명확성(15점), 캡션/CTA 일관성(10점). 각 점수에 대한 증거를 인용하세요. 실제 위반 사항을 수정하고 최대 3회까지 재점수화하세요. 통과 기준은 95/100점입니다. 해결되지 않은 경우 점수를 부풀리거나 준비되었다고 주장하지 말고 특정 차단 요인과 함께 초안을 보고하세요. 가능할 때 음성 낭독 시간을 측정하고, 그렇지 않으면 길이를 추정으로 표시하세요. Codex에서 이 검토에 Claude가 필요하지 않습니다.

확인해야 할 일반적인 위반 사항:

• "I"로 시작
• 세 개 이상의 단속적 조각
• 결론을 말함
• 여러 단어 또는 스타일화된 댓글 트리거
• 소리내어 읽을 때 45초 초과
• 2개 대신 3개 포인트
• 캡션이 스크립트를 미러링하지 않음

7단계. 스크립트 전달

검토된 스크립트와 일치하는 캡션을 프로젝트에 제공하고, 참조 출처, 분석 방법 및 해결되지 않은 검사 사항을 포함하세요. 사용자는 직접 녹음하거나 사용 가능한 자체 제작 워크플로우를 명시적으로 요청할 수 있습니다. 이 공개 스킬은 아바타, 편집 또는 게시 파이프라인을 제공하지 않습니다.

규칙

• 95/100 QA 게이트를 절대 건너뛰지 마세요.
• 작성 전에 항상 voice.md와 about-me.md를 읽으세요. 음성 일치는 협상 불가입니다.
• 참조 Reel에서 메트릭을 지어내지 마세요. 검증된 제공 또는 가져온 메타데이터만 사용하고, 누락된 메트릭은 사용 불가로 표시하세요.
• 영국 영어. 줄표 없음. 세미콜론 없음.
• 모든 스크립트는 일치하는 캡션을 포함합니다. 약속된 전달이 작동하는 경우에만 댓글 트리거를 포함하세요.
• 참조 접근이 실패하면 실패한 단계를 보고하고 제공된 비디오/대본 입력을 제안하세요. 비디오 분석을 조작하지 마세요.
• Gemini 2.5 Flash가 모델입니다. 사용자 승인 없이 대체하지 마세요.