Communitygithub.com

지식 비디오

하나의 주제를 사람들이 끝까지 시청하고 싶어하는 지식 설명 동영상으로 전환하세요. 연구, 대본, 이미지, 디자인, 렌더링의 검증된 워크플로우를 제공하며, 음악 편집, 비트 타이밍, 음향 효과, 자체 점검 도구를 포함합니다. 각 주제에 맞게 디자인을 자유롭게 구성할 수 있습니다.

지식 비디오란 무엇인가요?

이 스킬은 ‘지식 비디오’ 제작을 위한 완전한 워크플로우를 제공합니다. 하나의 주제를 연구에서부터 최종 렌더링까지 단계별로 안내하며, 각 단계는 독립적인 프롬프트와 자체 점검 체크리스트로 구성되어 있습니다. 사용자는 음악 길이에 따른 주제 분량 옵션 제안, 이미지 생성 프롬프트 작성, 시각적 방향 설정, 스토리보드 제작을 거쳐 HyperFrames로 최종 동영상을 렌더링합니다. 이 스킬은 Claude Desktop 환경에서 실행되며, Anthropic의 프롬프트 엔지니어링 가이드를 따라 역할, 과제, 스타일, 점검 항목을 분리된 XML 태그로 구성하여 명확성과 일반화 능력을 높입니다. 또한, 복잡한 단계는 서브 에이전트에 위임하여 컨텍스트를 깨끗하게 유지하고, 각 단계의 결과는 사용자에게 확인받은 후 다음 단계로 진행합니다. 사실 확인, 자산 라이선스, AI 얼굴 생성 금지 등 반드시 지켜야 할 원칙을 포함하여 높은 품질과 신뢰성을 보장합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Win-Hao/knowledge-video/tree/HEAD/skills/knowledge-video

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

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

문서

지식 비디오은(는) 무엇을 하나요?

하나의 주제를 사람들이 끝까지 시청하고 싶어하는 지식 비디오로 만드세요. 다음은 효과적인 경로이지 고정된 절차가 아닙니다: 단계를 병합, 생략 또는 재정렬하고, 이 주제에 맞게 글쓰기, 디자인 및 움직임을 직접 설계하세요.

사용자와 사용자의 언어로 대화하세요. 아래 파일 이름은 기본값입니다.

개략적인 경로

  1. 연구 → article.md: 출처를 찾고 출처가 있는 기사를 작성합니다. 먼저 주제의 형태(타임라인, 원인 체인, 개념, 비교, 신화, 하나의 이야기)를 파악한 다음 다룰 포인트를 결정합니다. 사용자가 분량을 결정합니다: 음악 길이를 기준으로 두세 가지 옵션을 제시하고 하나를 추천합니다.
  2. 대본 → script.md: 기사를 사람들이 스크롤하며 시청하는 동영상으로 다시 작성합니다.
  3. 이미지 → images.md 또는 image-prompts.md: 실제 이미지 또는 AI 일러스트레이션을 위한 프롬프트(이미지 API를 호출할 수 없다고 가정, 사용자가 자신의 도구를 실행합니다).
  4. 디자인 및 스토리보드 → looks/, storyboard.md: 사용자에게 몇 가지 방향을 보여준 다음 음악에 맞춰 스토리보드를 작성합니다.
  5. 렌더링 → opening-preview.mp4 → final.mp4: 먼저 짧은 오프닝을 만들고, 확인 후 전체 동영상을 렌더링합니다.

기본적으로 각 단계의 결과를 다음 단계로 넘어가기 전에 사용자에게 보여줍니다: 잘못된 방향은 렌더링 후에 가장 비용이 많이 듭니다. 사용자가 "끝까지 가세요"라고 말하면 계속 진행하고 storyboard.md에서 선택한 내용과 이유를 기록합니다.

각 단계: 프롬프트를 채운 다음 따르기

Anthropic의 프롬프팅 가이드에 따라 배경, 요구 사항 및 점검 사항을 별도의 XML 태그에 유지하고, 각 줄에 이유를 포함합니다: 분리된 부분은 서로 흐릿해지지 않으며, 이유를 알면 모델이 작성되지 않은 내용까지 일반화할 수 있습니다. 이 주제와 사용자가 말한 내용을 바탕으로 태그를 직접 채웁니다.

  • 브리프 prompts/brief.md: 처음에 한 번 채우고 각 단계 후에 업데이트합니다. 하나의 <context>만 포함: 주제, 시청자, 핵심 메시지, 길이, 방향, 음악, 사용자가 좋아하는 것과 싫어하는 것, 이전 단계에서 결정된 사항, 파일 위치.

  • 이번 단계의 프롬프트 prompts/<step>.md, 네 가지 태그:

    • <role>: 이 단계가 수행하는 역할과 해당 역할이 가장 중요하게 생각하는 것은 무엇인지. 역할은 단계마다 다릅니다. 이 단계에 맞는 역할을 선택합니다. 예: 연구는 지식 편집자(출처를 가장 중요시), 대본은 시나리오 작가(시청자가 스와이프할지 여부를 가장 중요시), 이미지는 사진 편집자 또는 일러스트레이터, 디자인은 아트 디렉터, 스토리보드는 스토리보드 아티스트, 구성은 모션 디자이너(각 움직임이 설명하는 내용을 가장 중요시).
    • <task>: 이 단계에서 생성할 결과물과 그 위치.
    • <style>: 권장 접근 방식, 각각의 이유와 함께; 권장 사항이지 규칙이 아닙니다: references/의 예시에서 선택하거나 이 주제에 맞게 새로 디자인하세요. 사용자가 원하는 것을 말한 경우 따르고, 원하지 않는 것도 여기에 기록합니다.
    • <check>: 단계가 완료된 것으로 간주되기 전에 항목별로 확인해야 할 사항; "반드시 지켜야 할 사항"을 포함합니다.

    매 단계마다 <role>, <task> 및 <check>를 작성하고, <style>은 필요하지 않은 경우(일반적으로 연구 및 렌더링) 생략합니다. 사용자가 말하지 않은 내용은 주제에서 유추하고, 확실하지 않은 내용은 보고서에서 물어보세요. 작성된 프롬프트를 단계의 결과물과 함께 표시합니다. 사용자가 편집하는 경우 편집된 버전으로 단계를 다시 수행합니다.

누가 따르는가: 사용자와의 왕복이 필요한 단계(몇 개의 포인트, 어떤 디자인)는 직접 수행합니다. 크고 독립적인 단계(연구, 이미지 찾기 또는 이미지 프롬프트 작성, 구성 작성 및 렌더링)는 서브 에이전트에 위임합니다: 브리프, 이번 단계의 프롬프트 및 파일 경로만 제공하여 컨텍스트를 깨끗하게 유지하고 이 단계에 필요한 것만 포함하도록 합니다. 서브 에이전트는 사용자와 논의한 내용을 알지 못하므로 둘 다 완전해야 합니다. 작업이 완료되면 출력을 읽고 사용자에게 보여주기 전에 자체 점검을 실행합니다. 서브 에이전트가 없으면 프롬프트를 직접 따릅니다.

반드시 지켜야 할 사항

  • 사실은 출처가 있어야 함: 모든 연도, 이름, 숫자 및 인용문은 article.md에 링크된 신뢰할 수 있는 출처(논문, 기관, 기록 보관소, 해당 인물의 직접적인 말)로 추적 가능해야 합니다. 출처를 찾을 수 없는 것은 삭제하고, 추정치는 표시하며, 간접적인 주장이 누구의 설명인지 명시합니다. 화면의 모든 텍스트(오프닝 질문과 엔딩 포함)는 article.md와 일치해야 합니다.
  • 자산은 사용 가능해야 함: 이미지, 음악, 음향 효과 및 글꼴은 이 용도로 라이선스가 부여되어야 합니다(파일 페이지 확인). 크레딧은 credits.md에 기록합니다.
  • 실제 인물의 AI로 그려진 얼굴은 금지, 동영상이 AI 일러스트레이션을 사용하는 경우 플랫폼의 "AI 생성 콘텐츠" 라벨을 켭니다.
  • 화면은 시간에만 의존해야 함: 시드를 고정하여 프레임이 매번 동일하게 렌더링되도록 합니다(HyperFrames에 필요).
  • 전달하기 전에 전체를 직접 시청합니다: 텍스트가 제 시간에 보이고 읽을 수 있는지, 연도와 숫자가 기사와 일치하는지, 사운드와 화면이 동기화되는지 확인합니다.

사용 가능한 도구

화면을 위한 HyperFrames(npx hyperframes init / docs / check / snapshot / render); 해당 스킬이 설치되어 있으면 구성에 대해 따릅니다. scripts/의 작은 도구들, 사용 여부는 선택:

스크립트기능
beats.py음악의 템포, 비트, 마디선 및 마디별 음량 변화
music_loops.py, cut_music.py반복되거나 완벽하게 잘리는 마디를 찾고, 마디 목록에서 새 음악을 구성
timing.py대본의 각 화면을 비트 그리드에 배치하고, 주요 화면을 특정 마디에 고정
sfx.pyKenney의 CC0 효과음을 다운로드하고, 음향 효과 신호를 하나의 트랙에 혼합
qa.py모든 화면의 연락처 시트와 주요 비트 주변 프레임 생성

이전 동영상이 남긴 자료

참고 자료이지 규칙이 아닙니다. 먼저 이 주제에 맞게 디자인하세요. 확실하지 않거나 동일한 문제에 부딪혔을 때 여기를 참조하세요:

  • references/example-ai-history.md: 첫 번째 테스트 실행, 각 단계의 출력 및 타이밍
  • references/prompt-examples.md: 테스트된 동영상의 두 가지 채워진 프롬프트 예시, 상세 수준 확인용
  • references/notes.md: 대본 및 페이싱에 대한 관찰 사항
  • references/images.md: 라이선스 확인, 프롬프트 작성, 레이어별 생성
  • references/visuals.md: 밀집 콜라주, 타임라인 순간, 사진 카드, 생성된 화면에 UI 맞추기, 코드로 그릴 내용
  • references/sound.md: 음악 편집, 음향 효과, 음량
  • references/pitfalls.md: 렌더링 실패 또는 화면이 잘못되었을 때 먼저 확인

관련 스킬