Communitygithub.com

Pedrovbm1/guion

설명용 짧은 영상(릴스, 틱톡, 쇼츠 또는 3D 애니메이션 설명 영상)의 대본을 작성합니다. 출처가 명시된 조사 데이터를 바탕으로 일상 대화체로 한 문장에 하나의 아이디어를 담고, 음성이나 애니메이션 비용이 발생하기 전에 A(유지율), B(데이터), C(명확성) 세 가지 검토자를 거쳐 임계값을 통과해야 합니다. '대본', '영상 텍스트 써줘', 'X를 영상으로 설명해줘' 같은 요청이나 '설명자' 스킬의 첫 단계로 사용됩니다. 또한 바이럴 영상 링크를 주고 '똑같이 만들어줘'라고 할 때는 주제와 효과적인 요소만 참고하고 절대 원본 대본은 사용하지 않습니다.

guion란 무엇인가요?

이 스킬은 설명용 짧은 영상(릴스, 틱톡, 쇼츠, 3D 애니메이션)의 대본을 체계적으로 작성하는 전문 도구입니다. 출처가 있는 데이터 기반 조사, 일상 대화체의 한 문장-한 아이디어 원칙, 그리고 본격적인 제작 전에 세 명의 가상 검토자(A-시청자 유지율, B-데이터 정확성, C-명확성)가 각각 10점 만점으로 평가하고 구체적인 수정안을 제시하는 '라운드 0' 검토 과정이 핵심입니다. 검토 결과 A와 C는 9점 이상, B는 높은 수준의 문제가 없어야 하며 최대 2라운드까지 진행합니다. 최종 단계는 'GUION LISTO'로, 사용자에게 평문 대본, 예상 길이, 검토 결과, 출처 데이터를 보여주고 승인을 받기 전에는 음성이나 애니메이션 작업에 들어가지 않습니다. 16자/초의 음성 속도 기준, 3초 이내 후크, 5-8초마다 마이크로 후크, 시작으로 돌아오는 결말 등 과학적인 영상 제작 원칙을 따릅니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Pedrovbm1/explicadores-3d/tree/main/skills/guion

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

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

문서

설명 영상 대본

대본은 고치기에 가장 싸고, 잘못된 걸 발견하기에 가장 비싼 요소입니다. 영상이 이미 만들어진 후에 대본을 다시 쓰는 데는 몇 시간이 걸리지만, 텍스트로 읽는 데는 1분이면 됩니다. 따라서 이 스킬은 항상 GUION LISTO에서 멈춥니다.

출력: 프로젝트 폴더 안에 voz/frases.txt(한 줄에 한 문장), MAPA.md(시각적 대본 + 출처 포함 데이터) 및 DECISIONES.md. explicador 스킬과 함께 사용되는 경우, 프로젝트는 이미 nuevo.py가 생성했으며 MAPA는 escena/CONTRATO.md의 초안입니다.

1. 아이디어 수신

  • 비디오 링크가 들어오면 ver-video 스킬로 분석합니다. 타인의 영상에서는 주제와 효과를 내는 요소(후크, 리듬, 구조)만 가져옵니다. 대본, 문장, 이미지, 음악은 절대 가져오지 않습니다.
  • 모르는 내용은 한 묶음으로(최대 4개 질문) 물어봅니다: 대상, 길이, 단독 영상인지 시리즈의 일부인지, 톤. 사용자가 결정한 내용은 날짜와 함께 DECISIONES.md에 기록합니다(컨텍스트를 압축한 후 다시 읽습니다).

2. 출처 조사

  • 모든 숫자, 날짜, 검증 가능한 주장에는 출처(링크 + 내용)를 붙입니다. 진지한 출처가 없으면 넣지 않습니다. 출처가 일치하지 않으면 뉘앙스를 줘서 표현합니다("10에서 15 사이", "추정됨").
  • 이론이나 가설인 "왜"에 대한 설명은 그렇게 표현합니다("제기됨", "한 가지 생각은").
  • 지어낸 "예를 들어"는 예시임을 밝힙니다("8cm라고 가정해 봅시다").
  • 검색은 웹 검색이 가능한 하위 에이전트에 high 노력으로 위임할 수 있지만(잘못된 데이터 하나가 신뢰를 떨어뜨림), 핵심 출처는 직접 검토합니다.
  • 모든 내용을 MAPA.md → "검증된 데이터" 섹션에 기록합니다: 데이터 · 출처 · 짧은 인용문.

3. 작성

스타일 규칙(유지율과 명확성을 가장 높이는 규칙):

  1. 한 문장에 하나의 아이디어. "그리고 또한", "비록", 또는 조건이 겹쳐진 문장은 나눕니다.
  2. 일상 대화체: 친구에게 말하듯이: 일상적인 단어, 가정이나 직장의 예시. 각 기술 용어는 처음 나올 때 설명하거나 사용하지 않습니다.
  3. 3초 이내 후크(늦어도 4.5초): 호기심을 자극하는 질문이나 시청자가 믿는 것과 반대되는 내용. 0번째 장면은 오디오 없이도 이해되어야 합니다: 선명한 이미지 + 쓰여진 질문.
  4. 약속과 이행: 후크가 약속한 내용은 반드시 이행되고, 보여지는 것으로 이행됩니다.
  5. 5-8초마다 마이크로 후크("근데 조심", "여기서 이상한 게 나옵니다").
  6. 시작으로 돌아오는 결말(루프)과 댓글을 유도하는 구체적인 질문.
  7. 길이: 음성 기준 초당 ~16자(≈ 초당 3단어). 단독 영상은 15-30초가 가장 좋고, 60초 이상은 이름과 번호가 있는 시리즈의 일부일 때만 사용합니다.
  8. 다른 제작자나 그들의 상투적인 문장을 절대 복사하지 않습니다.
  9. 3D 애니메이션의 경우: 눈처럼 보이는 요소나 동일한 원 쌍(고리가 있는 구체, 쌍둥이 창문, 위에 아치가 있는 원반)을 사용하지 않습니다. 물체가 둥글면 MAPA에 눈처럼 보이지 않게 그리는 방법을 명시합니다.

voz/frases.txt와 MAPA를 작성합니다: 각 문장, 키워드(장면 전환을 지시하는 단어), 그 단어에서 보이는 내용, 자막(있는 경우) 및 대략적인 초를 포함한 표.

4. MAPA에 대한 라운드 0(텍스트만, 음성 및 애니메이션 이전)

3명의 독립적인 검토자를 병렬로 실행합니다(하위 에이전트, Sonnet급 중간 모델, 노력 medium, B는 high). 각 검토자는 voz/frases.txt와 MAPA.md를 읽고, 다른 검토자의 내용은 읽지 않으며, revision/REV_<글자>_mapa_v<N>.md에 10점 만점 점수와 정확한 수정 사항(어떤 문장, 어떤 단어, 어떤 자막)을 제출합니다. 지침은 RONDA0.md에 있습니다.

  • A · 유지율: 오디오 없는 0번째 장면, 3초 미만 후크, 약속과 이행, 마이크로 후크, 5초 이상 변화 없는 구간, 루프, 마지막 질문, 길이.
  • B · 데이터: 각 숫자를 해당 출처와 대조(직접 확인), 화면에 표시되는 모든 숫자에 자막이 있는지, MAPA에 없는 내용이 화면에 없는지 확인.
  • C · 모르는 사람을 위한 명확성: 대본을 15세 청소년 입장에서 다시 말함; 설명되지 않은 단어, 이름, 약어, 숫자를 모두 나열; 두 가지 이상의 아이디어가 포함된 문장과 작은 글씨("일반적으로", "시나리오일 뿐 예측이 아님")를 표시; 각 문장의 재작성 버전을 제안하고 길이를 확정.

수정 사항을 적용하고 A ≥ 9, C ≥ 9, B에 높은 수준의 문제 없음이 될 때까지 반복하며 최대 2라운드까지 진행합니다. 두 번째 라운드에서도 통과하지 못하면 중단하고 노트와 함께 대본을 사용자에게 보냅니다: 제작하지 않음.

5. GUION LISTO(필수 정지)

사용자에게 하나의 메시지로, 채팅에(파일이 아닌) 보냅니다:

  • 평문 대본(10-12줄),
  • 예상 길이와 라운드 0 결과,
  • 출처가 포함된 데이터,
  • 최대 4개의 질문.

GUION LISTO로 턴을 종료합니다. 사용자가 응답할 때까지 음성을 생성하거나 애니메이터를 실행하지 않습니다. 사용자가 "계속 작업해"라고 해도 이 단계는 건너뛰지 않습니다. 조사와 구축에는 해당되지만 여기에는 해당되지 않습니다.

Individual skills in this repo

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

관련 스킬