Community라이팅 & 에디팅github.com

roteirista

포르투갈어로 쇼트폼 영상(Reels, TikTok, Shorts) 및 튜토리얼 대본을 작성하는 스킬입니다. 후크, 자연스러운 합성음 대사, 씬별 스토리보드, 제목, 썸네일 텍스트, 게시글 캡션을 한 번에 생성합니다.

roteirista란 무엇인가요?

이 스킬은 포르투갈어를 기반으로 하는 AI 에이전트가 짧은 동영상(Reels, TikTok, Shorts)과 튜토리얼의 대본을 완전히 작성할 수 있도록 설계되었습니다. 사용자가 '대본 써줘', '영상 아이디어', '후크', '제목', '캡션' 또는 'X에 대한 영상 만들어줘'라고 요청할 때 활성화됩니다. 핵심은 **듣고 보기 위한** 대본을 작성한다는 점으로, 문장은 짧고(최대 15단어) 각 씬마다 강력한 시각적 이미지가 동반되어야 합니다. 스킬은 크게 7단계로 구성됩니다: (1) 주제, 목표, 대상, 형식(45-75초 또는 3-5분), 내레이터, 마무리 멘트, 제약사항을 묻고 명확히 합니다. (2) 질문 형태의 강력한 후크(2초 이내)를 선택합니다. (3) 호기심 유발형(~50초, 6씬), 판매/스토리형(~40-60초), 튜토리얼형(3-5분) 중 적합한 구조를 적용합니다. (4) 합성음에 최적화된 대사 규칙(초당 2.4~3.2단어, 쉼표로 호흡, 약어 금지, 숫자 읽기 등)을 따릅니다. (5) 각 대사에 시각적 설명, 큰 텍스트(최대 4단어), 단어별 트리거를 포함한 스토리보드를 작성합니다. (6) 사실 확인, 시뮬레이션 라벨링, 고객 데이터 미사용 등 진실성과 보안을 유지합니다. (7) 최종 산출물로 `roteiro.py`(파일), 스토리보드 테이블, 제목/썸네일/캡션, 예상 길이, 확인할 사실 목록을 제공하며, 사용자 승인 후에만 비디오 생성 스킬로 넘어갑니다. 또한, `pesquisa-viral` 스킬로 유행 패턴을 참고하거나 `CREATIVE_INTELLIGENCE_BRIEF.md`가 있을 경우 기존 브리프의 기술과 후크를 활용하되, 다른 제작자의 대본·제목·구조를 직접 복사하지 말라는 윤리적 규칙이 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/scamposgabriel/gerador-de-videos/tree/HEAD/.claude/skills/roteirista

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

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

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

문서

roteirista은(는) 무엇을 하나요?

포르투갈어로 응답하세요. 대본은 듣고 보기 위한 것입니다. 읽기 위한 것이 아닙니다: 짧은 문장, 씬마다 강력한 이미지 하나.

1. 요청 이해하기 (부족한 것만 물어보세요)

  • 주제와 목표: 호기심 가르치기, 판매, 사용법 가르치기.
  • 대상 (누구인지, 이미 아는 수준)과 형식: 4575초 Reels/Shorts (기본) 또는 35분 튜토리얼.
  • 내레이터/캐릭터 (예: 채널 캐릭터)와 마무리 멘트(있을 경우).
  • 마무리 행동 유도: 댓글, 팔로우, 시뮬레이션 요청…
  • 제약사항: 브랜드, 업계 규칙 (예: 컨소시엄은 기간을 약속할 수 없음), 화면에 나올 수 없는 것.

사용자가 어떤 것이 잘 통하는지 알고 싶어하면, 먼저 pesquisa-viral 스킬을 사용하여 발견된 패턴을 기반으로 작업하세요. CREATIVE_INTELLIGENCE_BRIEF.md (스킬 engenharia-reversa)가 있다면, 그 안의 전이 가능한 기술과 3개의 원본 후크를 사용하고, "복사하지 말 것" 목록을 준수하며, 가설은 가설로만 취급하세요 (확정된 사실이 아님). 절대 다른 제작자의 대본, 제목, 또는 씬별 구조를 복사하지 마세요. 대신, 고유한 콘텐츠, 각도, 캐릭터로 패턴(질문 유형, 리듬)을 사용하세요.

2. 각도 선택 (후크)

즉각적인 답이 없어 보이는 명확한 질문. 구체적인 세부 사항이 포함되어야 함:

  • "왜 [놀라운 사실]이 [예상했던 것]인가?" — 왜 당신의 개가 바로 앞에서 빨간 공을 놓칠까요?
  • "무슨 일이 일어날까…?", "눈치채셨나요…?", "이미 [강력한 결과]가…" 후크는 말하기 2초 이내에 들어가야 하며, 첫 이미지는 이미 미스터리가 펼쳐지는 모습을 보여줘야 합니다.

3. 효과가 있었던 구조

호기심 유발 (약 50초, 6씬) — 모델 videos/exemplo-bolinha-vermelha:

  1. 미스터리 (0~5초): 장면이 진행됨 + 질문.
  2. 반전: "[당신이 생각하는 것]이 아닙니다. [진짜 원인]입니다."
  3. 설명: 하나의 메커니즘, 양쪽 비교 (우리 vs 그들, 이전 vs 이후).
  4. 시각적 시연: 영상의 보상 — 시청자가 현상을 봅니다.
  5. 적용: 이걸로 무엇을 할지 (해결책), 정직한 주의사항 포함.
  6. 마무리: 한 문장으로 된 교훈 + 마무리 멘트 + 댓글 유도 질문.

판매 / 스토리 (약 40~60초): 후크 (인지 가능한 고민) → 구체적인 문제를 가진 캐릭터 → 제품 발견 → 시연 → 명확한 초대. 판매는 스토리 안에서 자연스럽게 발생해야 합니다. 예쁜 이미지와 장점 목록은 아무도 붙잡지 못합니다. 규제 광고: 기간, 결과, 수익을 약속하지 마세요. 화면에 짧은 법적 고지문; 가상 캐릭터임을 표시.

튜토리얼 (3~5분): 대상과 달성할 결과 → 열기 위치 → 요약 → 사용 순서대로 세부 설명 → 유지 관리 방법 → 문의할 곳 → 3단계 마무리.

4. 대사 규칙 (합성음)

  • 문장은 최대 ~15단어, 한 문장에 한 가지 아이디어; 목록은 최대 3개 항목. 쉼표는 숨 쉬는 곳.
  • 리듬: 영상은 초당 2.4~3.2단어로 나갑니다. 예상 길이 ≈ 단어 수 ÷ 2.8.
  • 약어: 풀네임으로 바꾸거나, 한 단어로 발음되는 대로 쓰세요. 대사에 괄호, 슬래시, 줄임말 금지.
  • 간단한 숫자는 철자로 ("três tipos" - 세 가지 유형); 단위가 있는 값은 발음하는 대로 ("dois por cento" - 2%).
  • 시청자에게 말하세요 ("você", "seu cachorro" - 당신, 당신의 개); 동사는 현재형; 2~3씬마다 한 번씩 질문이 주의를 잡아둡니다.

5. 스토리보드: 각 대사가 하나의 씬

각 대사에 대해 다음을 설명하세요:

  • 시각: 무엇이 나타나고 움직이는지 (큰 물체, 카메라 접근, 캐릭터의 포즈).
  • 큰 화면 텍스트: 최대 4단어 (예: "ELE NÃO VIU?!" - 그가 못 봤다고?!, "NÃO É INVISÍVEL!" - 보이지 않는 게 아니야!).
  • 트리거: 대사의 어떤 단어가 무엇을 실행하는지 (예: "vermelha"에서 → 공 주위에 링; "azul"에서 → 공이 파란색으로 변함). 이것이 생성기가 동기화하는 데 사용하는 것입니다 (quando(cena, "palavra")).

6. 진실성과 안전

  • 모든 사실을 확인하세요. 확실하지 않으면 신뢰할 수 있는 출처에서 검색하고 결과에 인용하세요; 필요시 "pode", "geralmente" (~할 수 있다, 일반적으로)를 사용하세요. 숫자를 지어내지 마세요. 시뮬레이션은 "simulação aproximada" (근사 시뮬레이션)라고 표시해야 합니다.
  • 대사에 고객 데이터나 실제 인물 데이터를 넣지 마세요 (외부 음성 서비스로 전송됩니다).
  • 라이선스 없이 타인의 음악, 클립, 이미지를 사용하지 마세요.

7. 최종 산출물

  1. roteiro.py: 영상 폴더에 저장할 준비 완료 (모델의 CONFIG 복사; id, cena, fala가 있는 FALAS).
  2. 스토리보드 표: 씬 · 예상 시간 · 대사 · 시각 · 화면 텍스트 · 트리거.
  3. 게시글 제목 (최대 60자), 썸네일 텍스트 (최대 5단어, 작게 읽을 수 있음), 게시글 캡션 (짧게, 마지막에 질문, 해시태그 3~5개). 바이럴을 약속하지 마세요.
  4. 예상 길이와 각 대사의 리듬 (단어/초).
  5. 확인할 사실 목록, 각각의 출처 포함.

사용자에게 보여주고 승인을 기다린 후 gerador-de-video 스킬로 넘어가세요.

예시 (모델 요약)

씬대사시각화면 텍스트
미스터리"왜 당신의 개는 가끔 빨간 공을 놓칠까요? 바로 코앞에서요!"개가 공 지나쳐 달림, 돌아옴, 냄새 맡음, "?"그가 못 봤다고?!
반전"집중력 문제가 아닐 수 있어요. 문제는 개가 구별할 수 있는 색깔에 있을 거예요."돋보기로 개의 눈 확대산만함 아님 / 색깔 때문!
설명"사람은 색을 보는 세 가지 세포가 있어요. 개는 두 가지만 있죠…"인간 3 vs 개 2색 세포
시연"이 공을 우리 눈으로 봐보세요. 이제, 개의 눈으로…"같은 장면, 개의 시야로 전환보이지 않는 게 아니야!
해결책"이제 파란 공으로 바꿔보세요. 훨씬 찾기 쉬워져요!…"빨간 공이 파란색으로 변함; 개가 찾음색깔을 바꿔봐!
마무리"…아마 개에게 다른 색이 필요했던 것 같아요. 저는 루미예요. 설명 끝!"캐릭터 + 개설명 끝!

Individual skills in this repo

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

관련 스킬