Community라이팅 & 에디팅github.com

Livin21/스크립팅-설명-숏츠

60초 미만의 교육용 짧은 영상에서 내레이션을 작성하거나 사실 확인할 때, 훅(hook)을 선택하거나 검증할 때, 출처가 열리지 않거나 모순될 때, 또는 화면 레이블, 설명, 웹 카피에 에피소드 사실을 기재할 때 사용합니다.

스크립팅-설명-숏츠란 무엇인가요?

이 스킬은 60초 미만의 교육용 숏츠 영상에서 사실 기반 내레이션을 작성하고 검증하는 프로세스를 제공합니다. 가장 중요한 원칙은 모든 주장에 대해 실제로 열어본 출처를 인용해야 하며, 특히 훅(hook)이 가장 검증이 필요하다는 점을 강조합니다. 출처는 표준 기관, 제조사 문서, 정부 기관, 대학 자료 등의 우선순위에 따라 선택하며, 위키피디아 미러나 콘텐츠 팜은 피합니다. 내레이션은 훅-공개-세 가지 비트-트위스트-시그니처 오프 형식을 따르고, 목소리 속도에 맞춰 단어 수를 제한하며, 모든 화면 숫자와 주장을 `sources.md`에 기록합니다. 이 스킬은 Cursor, Claude Code, Codex 등 AI 어시스턴트에서 사용할 수 있으며, 출처가 열리지 않거나 모순될 때의 처리 방법까지 상세히 안내합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Livin21/behind-the-things-skills/tree/HEAD/skills/scripting-explainer-shorts

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

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

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

문서

스크립팅 설명 숏츠

개요

설명 영상은 가장 약한 주장만큼만 신뢰할 수 있습니다. 모든 사실 문장과 모든 화면 숫자는 실제로 열어본 출처가 필요합니다. 멋져 보이는 훅(hook)은 보통 초고에서 가장 덜 사실적인 문장이므로, 먼저 검증하고 실패하면 다시 작성하세요.

프로세스

  1. 훅을 먼저 검증하세요. 이를 명시하는 일차 출처(표준 기관, 제조사, 정부 기관, 대학 또는 공개된 소스 코드)를 찾으세요. 그런 다음:

    • 실패한 경우: 출처가 말하는 대로 다시 작성하세요. "줄무늬는 숫자가 아니다"는 "바코드는 가격을 모른다"로 바뀌었고; "방사성 금속 조각"은 "방사성 물질"이 되었습니다(너무 작아서 볼 수 없는 산화물입니다).
    • 미묘한 차이가 있지만 유지되는 경우: 유지하되, 출처에 맞게 단어를 조정하고 그 미묘한 차이를 비트(beat)에 담으세요. ("안에서 밖으로 조리되지 않는다" → 전파는 약 1인치까지 가열합니다).
    • 일부 경우에만 증명 가능한 경우: 일반적으로 유지하고, 각 특정 숫자는 해당 출처에 귀속시키며("Android 기본…", "Windows…"), 그 차이는 부분 검증됨으로 기록하세요.
  2. 비트를 조사하세요. 검색 스니펫을 신뢰하지 말고 각 출처를 열고, 지지하는 줄을 인용하세요. 주장을 명시하는 가장 강력한 출처를 선택하세요:

    순위출처예시
    1표준 기관, 사양서, 공개된 소스 코드EMVCo, ISO/IEC 카탈로그 페이지, NFC Forum, GS1, AOSP
    2정부 기관, 규제 기관, 중앙은행NRC, EPA, FDA, USDA, Federal Reserve, ECB
    3제조사의 자체 문서Visa, Mastercard, NXP 데이터시트, Microsoft Learn
    4대학, 교과서, 동료 심사 논문대학 강의 노트, 학술 대회 논문
    5신뢰할 수 있는 설명자와 언론1~4순위에 명시되지 않은 경우에만

    미러나 재호스팅(IPFS 또는 기타 Wikipedia 사본, PDF 재업로드), 콘텐츠 팜, SEO 블로그, 또는 벤더 마케팅 자료는 인용하지 마세요. 미러만 열리는 경우, 원본 페이지나 보관된 사본을 찾으세요. Wikipedia(또는 그 사본)는 출처로 이끌 수 있습니다: 문서의 참조를 따라가서 열고, 그것을 인용하세요.

    • 페이지가 열리지 않는 경우: 다른 페처(fetcher)를 시도한 다음, 보관된 사본을 시도하세요. 아카이브를 사용하면 표시하세요. 아무것도 로드되지 않으면, 그 문장을 애매하게 표현하거나 잘라내세요.
    • 출처가 스스로 모순되거나 물리 법칙에 어긋나는 경우: 정확한 수치를 명확히 말하고("약 5인치"), sources.md에 계산 과정을 보여주세요. 출처 자체의 수치는 "의도적으로 단순화함" 아래에 기록하세요. 예: c ÷ 2450 MHz = 12.2 cm ≈ 5 in, USDA의 반올림된 "4 in"이 아닙니다.
    • 추론(논리적으로는 참이지만 어떤 출처도 한 줄로 명시하지 않은 경우): sources.md에 추론이라고 표시하세요.
  3. 내레이션을 작성하세요(아래 형식 참조).

  4. 예산에 맞추세요. 상한선은 54 × (음성의 초당 단어 수)이며, 프로젝트의 CHANNEL.md에서 가져옵니다; 초당 2.6 단어 음성의 경우 약 140단어입니다. 음성 시그니처 오프도 포함됩니다. wc -w로 세고, 하이픈으로 연결된 단어는 하나로 셉니다.

  5. 장면 표와 패키징(템플릿은 templates.md 참조).

  6. sources.md를 작성하세요 템플릿을 사용하여: 주장당 한 행, 태그나 판독기에서 화면에 표시된 모든 숫자를 포함하고, 그 다음 "의도적으로 단순화함"과 "부분 검증됨"을 포함하세요.

내레이션 형식

  1. 훅 (0–3초): 놀라운 사실, 물체 위에 말하며, 첫 프레임에 완전히 그려집니다.
  2. 공개: 물체를 열고 내부를 보여주세요. "사물"이 추상적(아이콘, 신호)인 경우, 이를 생성하는 장치(예: Wi-Fi 막대의 경우 휴대폰 라디오)를 공개하세요. 그린 뷰를 선택하여 공개할 때 내부가 드러나도록 하고, 동사가 동작과 일치하도록 하세요("덮개를 들어 올리다").
  3. 세 가지 비트: 내부는 무엇인가 → 어떻게 작동하는가 → 아무도 예상하지 못한 것.
  4. 트위스트 라인: 사람들이 친구에게 반복해서 말하는 사실.
  5. 시그니처 오프: 채널의 고정된 문구.

귀로 듣기 좋게 작성하세요: 짧은 문장, 숫자는 말하는 대로 철자하세요. 위험한 단어에는 음성 노트를 추가하여 TTS 프롬프트에서 재철자가 되도록 하세요.

그 외 모든 텍스트

화면 태그, YouTube 설명, 자막, 사이트 페이지는 이미 sources.md에 있는 주장만 말할 수 있습니다. 복사본을 작성하면서 "작은" 사실을 추가하는 것은 오류가 유입되는 방식입니다.

일반적인 실수

실수수정 방법
"기본적으로 사실인" 멋진 훅을 유지하기출처가 말하는 대로 다시 작성하세요
출처의 반올림 오류를 반복하기물리학이나 두 번째 출처와 대조하고; 계산 과정을 보여주세요
출처 없는 숫자가 있는 태그화면에 표시된 모든 숫자에 대해 출처 행을 추가하세요
느린 음성에 148단어음성의 측정된 속도를 사용하고; 54 × 속도로 상한 설정하세요
열리지 않는 출처를 조용히 생략하기문장을 애매하게 표현하거나 잘라내고; 부분 검증됨으로 기록하세요
벤더 블로그나 위키피디아 미러 인용하기표 위로 올라가세요: 사양서, 규제 기관, 제조사

관련 스킬