Communitygithub.com

Firepanda415/연구-및-과학-라이브러리-스킬

연구 논문, 코드 저장소 또는 과학적 방법에 대한 나레이션과 자막이 포함된 설명 동영상을 기획, 스크립트 작성, 애니메이션 제작 및 검토합니다. 논문 설명 동영상, 애니메이션 요약, Manim과 같은 프로그래밍 기반 애니메이션 및 해당 동영상의 수정에 사용됩니다. 단일 정적 그림이나 다이어그램에는 figure-designer를 사용합니다.

연구-및-과학-라이브러리-스킬란 무엇인가요?

이 스킬은 연구 결과를 설명하는 짧은 나레이션 동영상을 제작하는 포괄적인 파이프라인을 제공합니다. 과학적 소양을 갖춘 시청자가 해당 연구를 직접 읽지 않았어도 이해할 수 있도록, 동영상 자체를 하나의 출판물처럼 취급합니다. 스킬은 소스(논문, 코드 저장소)를 읽고 주장 지도를 작성한 후, 스크립트를 구성하고 애니메이션을 제작하며 최종 검토까지 수행하는 전 과정을 안내합니다. 모든 주장, 숫자, 방정식 및 플롯된 곡선은 원본 출처로 추적 가능해야 하며, 렌더링된 동영상은 전달 전에 반드시 검사되어야 합니다. 이 스킬은 Claude Code, Cursor 및 Codex와 같은 AI 에이전트 플랫폼에서 작동하도록 설계되었으며, 기존 애니메이션 파이프라인과 스타일 모듈을 재사용하여 일관된 비주얼을 유지하는 것을 강조합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Firepanda415/research-and-scientific-lib-skills/tree/HEAD/plugins/research-skills/skills/research-explainer-animation

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

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

문서

연구 설명 애니메이션

한 가지 연구를 과학적 소양을 갖춘 시청자(해당 연구를 읽지 않은 사람)에게 설명하는 짧은 나레이션 동영상을 제작합니다. 동영상을 해당 연구에 대한 하나의 출판물처럼 취급합니다. 모든 주장, 숫자, 방정식 및 플롯된 곡선은 원본 출처로 추적 가능해야 하며, 렌더링된 동영상은 전달 전에 반드시 검사되어야 합니다.

소스에서 준비하기

  1. 전체 소스를 읽습니다. 논문의 경우 인용할 숫자 뒤에 있는 표, 그림 캡션 및 부록을 포함합니다. 논문이 없는 저장소의 경우 README, 문서, 예제 및 테스트를 읽고, 코드가 지원하는 동작만 설명합니다.
  2. 스크립트를 작성하기 전에 주장 지도를 작성합니다. 문제, 문제가 어려운 이유, 핵심 아이디어, 인용된 선행 연구 대비 새로운 점, 방법이 블록별로 작동하는 방식, 조건을 포함한 결과, 그리고 명시된 한계를 다룹니다. 각 숫자 뒤에 있는 표, 섹션 또는 파일을 기록하고, 두 표 항목에서 계산된 백분율과 같은 파생된 숫자는 파생됨으로 표시합니다.
  3. 실제 데이터를 플롯합니다. 논문에 명명된 저장소와 사용자의 로컬 복사본을 포함하여 저자의 데이터와 코드를 찾습니다. 플롯된 양을 사용하기 전에 해당 데이터로 추적하고, 해당 데이터로부터 파생된 값이나 피팅을 다시 계산합니다. 추적하거나 다시 계산한 값과 보고된 값을 비교합니다. 비용이 많이 드는 시뮬레이션이나 실험은 사용자의 승인을 받은 후에만 다시 실행합니다. 개략적인 입력은 설명용으로 표시합니다.
  4. 대상 프로젝트의 기존 애니메이션 파이프라인과 스타일 모듈을 찾아 재사용하여 새 동영상이 이전 동영상과 일치하도록 합니다. 기존 파이프라인이 없으면 프로덕션 파이프라인의 아키텍처를 따라 구축하고, 해당 함수 이름은 제안사항으로 간주합니다. 프로젝트에 경로, 환경 및 빌드 명령어, 동영상이 페이지에 연결되는 방식에 대한 지침이 있으면 이를 따릅니다. 프로젝트가 선언한 환경을 사용합니다. 선언된 환경이 없으면 파이프라인의 요구 사항을 충족하는 설치된 도구를 사용하고, 해당 경로와 버전을 동영상의 소스와 함께 기록하며, 아직 설치해야 할 항목(음성 합성 가중치의 첫 사용 다운로드 포함)을 사용자에게 알립니다.

나레이션 스크립트 작성하기

  • 문제, 아이디어, 방법, 증거 및 범위를 전달하는 가장 짧은 동영상을 목표로 합니다. 전체 논문 설명 동영상은 일반적으로 3분에서 4분 30초, 약 450~600개의 영어 단어가 필요합니다. 애니메이션 요약이나 학회의 시간 제한은 더 짧은 목표를 설정합니다.
  • 주장 지도를 따릅니다: 문제, 장애물, 아이디어, 메커니즘, 증거, 비교 및 트레이드오프, 그리고 핵심 요점. 방법이 선행 연구를 기반으로 하는 경우 해당 연구를 인정하고, 논문 자체의 용어로 기여도를 명시합니다. 논문의 단서와 조건을 나레이션에 반영합니다.
  • 나레이션과 화면상의 텍스트는 내구성 있는 산문입니다. 합성 전에 research-writing-style(필수 검토 포함)을 적용합니다.
  • 스크립트를 1~4개의 문장으로 구성된 세그먼트로 나눕니다. 각 문장에는 자막 텍스트와, 필요에 따라 약어를 풀어 쓰거나 기호를 소리 내어 읽거나 발음을 재정의하는 별도의 음성 텍스트가 있습니다.
  • 사용자가 이전 동영상에서 선택한 음성을 사용합니다. 녹음된 선택 사항이 없으면 몇 가지 후보 음성으로 짧은 구절을 합성하고, 샘플을 오디오 파일로 작성한 후 사용자에게 해당 경로를 제공하고 사용자가 선택하도록 합니다. 선택 사항을 나레이션 구성 또는 프로젝트 노트에 기록하여 이후 동영상에서 재사용합니다.

합성, 타이밍, 렌더링, 자막 및 인코딩 아키텍처와 알려진 실패 모드는 프로덕션 파이프라인을 참조하세요. 기본 시각 및 오디오 스타일은 하우스 스타일을 참조하세요.

애니메이션 제작하기

  • 각 문장에 하나의 시각적 아이디어를 부여하고, 합성된 오디오에서 측정된 타이밍을 사용하여 해당 문장이 시작될 때 애니메이션을 시작합니다.
  • 색상 역할, 타이포그래피, 섹션 레이블, 타이틀 카드, 클로징 카드 및 자막 스트립을 동영상 간에 일관되게 유지합니다.
  • 수학 조판기를 사용하여 방정식을 조판하고 데이터에서 플롯을 그립니다. 단위, 통계와 함께 불확실성, 그리고 진짜 마이너스 기호를 표시합니다.
  • 썸네일 너비에서도 읽을 수 있도록 큰 요소로 구성된 별도의 포스터 스틸을 만듭니다.

전달 전 확인하기

다음 검사는 필수입니다. 나레이션 동영상은 성공적인 렌더링으로 드러나지 않는 방식으로 조용히 실패할 수 있습니다.

  • 전체 렌더링을 연속 사진(예: 4~5초마다 한 프레임)으로 검사하고, 밀도가 높은 프레임은 전체 크기로 검사합니다. 잘리거나 겹치는 텍스트, 축 위에 그려진 레이블, 누락된 분수 막대와 같은 불완전한 수식, 그리고 움직임 중에 표현하는 데이터로부터 분리되는 객체를 찾습니다.
  • 모든 자막 줄 아래에 나레이션이 있는지, 자막 시작이 음성 시작과 일치하는지 확인합니다.
  • 화면과 나레이션의 모든 숫자를 주장 지도와 비교합니다.
  • 동영상이 사이트에 포함된 경우 사이트를 빌드하고, 테스트를 실행하며, 호스트가 제공하는 브라우저 도구(예: 두 너비에서의 헤드리스 스크린샷)를 사용하여 데스크톱 및 휴대폰 너비에서 페이지와 플레이어를 확인합니다. 그러한 도구가 없으면 사용자에게 해당 너비를 확인하도록 요청합니다.
  • 호스트가 에이전트가 오디오를 들을 수 있도록 허용하지 않는 한, 사용자에게 발음과 페이싱을 듣도록 요청하고 가장 위험이 큰 단어를 명시합니다.

전달 및 수정하기

완성된 동영상을 경로와 길이와 함께 전달하고, 내용과 데이터 소스를 요약하며, 사용자가 귀나 눈으로 여전히 확인해야 할 사항을 나열합니다. 타임스탬프가 있는 의견의 경우 프레임을 찾고, 단일 프레임이 아닌 원인을 수정하며, 동일한 파이프라인으로 구축된 나머지 동영상 및 다른 동영상에서 동일한 결함을 검색합니다.

관련 스킬