Communitygithub.com

threejs-quality-kit

Three.js 코드 비디오(Remotion + React Three Fiber)를 위한 품질 키트: 수준을 높여준 모든 리소스(GitHub 저장소, 설치된 스킬, 에셋 라이브러리, 측정 도구, 오디오 서비스)의 인벤토리, 전반적인 작업 방법(참조 → 스킬 → 코드 연구 → 워크숍 → 렌더링/검토/수정 → 검증), 체크리스트, 학생에게 전달할 패키지.

threejs-quality-kit란 무엇인가요?

이 스킬은 Three.js 코드 비디오(특히 Remotion + React Three Fiber)의 품질을 획기적으로 향상시키기 위해 설계된 종합 키트입니다. '단순한 기본 형태'에서 '리깅된 캐릭터, 실제 도시, 깔끔한 연출을 갖춘 영화' 수준으로 점프하는 데 필요한 모든 것을 제공합니다. 주요 내용으로는 GitHub 저장소, 설치된 스킬, 에셋 라이브러리(Polyfork 등), 측정 도구(MediaPipe 기반 얼굴 랜드마크), 오디오 서비스(ElevenLabs, Suno) 등 모든 리소스의 상세 인벤토리, 참조 분석→스킬 활용→코드 연구→워크숍→렌더링/검토/수정→검증으로 이어지는 단계별 작업 방법, 그리고 설치부터 최종 검토까지 놓치지 말아야 할 체크리스트가 포함되어 있습니다. 또한 학생이나 동료에게 전체 키트를 쉽게 전달할 수 있도록 설계되었으며, 공개 스킬과 템플릿 프로젝트를 자동으로 설치하는 스크립트를 제공합니다. 이 스킬은 Claude Code, Cursor, Codex 등 AI 에이전트와 함께 사용하도록 최적화되어 있으며, Three.js, Remotion, React Three Fiber를 사용하는 개발자에게 필수적인 품질 관리 도구입니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Alex-sia99/threejs-quality-kit/tree/HEAD/skills/threejs-quality-kit

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

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

문서

Three.js 품질 키트 — 리소스, 방법, 체크리스트

이 스킬은 한 가지 질문에 답합니다: 우리의 Three.js 비디오를 '쌓인 기본 도형'에서 '리깅된 캐릭터, 실제 도시, 깔끔한 연출을 갖춘 영화'로 만든 것은 무엇일까요? 세 가지입니다: 시간이 지나면서 추가된 리소스, 작업 방법, 그리고 체계적인 검토. 자매 스킬 threejs-code-video에는 기술적 세부 사항(파이프라인, 캐릭터, 카메라, 루프, 함정)이 포함되어 있습니다. 이 스킬은 전체 개요와 시작 키트입니다.

내용

파일용도
references/ressources.md전체 인벤토리: 저장소, 스킬, 사이트, 도구, 서비스 — 각 항목이 제공하는 것, 설치 방법, 라이선스
references/methode.md작업 방식, 단계별 설명, 실제로 품질을 높인 6가지 레버
references/checklist.md체크리스트: 설치, 코딩 전, 코딩 중, 전송 전
scripts/install-kit.js프로젝트에 키트의 공개 스킬 설치 (복제 + 복사, 종속성 없음)
scripts/planche.js비디오 → 콘택트 시트 (1프레임/초) 전체 렌더 검토용
scripts/polyfork-fetch.jsPolyfork 모델 검색 및 다운로드 (매개변수화 가능한 .mjs 모듈)
scripts/face-landmarks.py, scripts/face-measure.py사진 속 얼굴 측정 (MediaPipe) — 눈짐작 대신

1분 요약 리소스

필요리소스당사 상태
최신 Three.js (r186), R3F, 셰이더, 조명…13개의 threejs-* 스킬 — CloudAI-X/threejs-skills설치됨, 각 구성 시 참조
프레임별 비디오 렌더링8개의 Remotion 스킬 — remotion-dev/skills설치됨
코드 비디오 방법 + 템플릿스킬 threejs-code-video + 저장소 Alex-sia99/threejs-code-video직접 작성, 공개
객체, 장면, 로우폴리 캐릭터Polyfork (polyfork.dev, 인덱스 lucas-martinic/polyfork-catalog)v3 영화에서 사용 — .mjs 모듈, 재배포 금지
애니메이션 바디Mixamo 스켈레톤 및 클립v3 영화의 리깅된 바디
사진 기반 유사성img2threejs/img2threejs + MediaPipe Face Landmarker'측정, 추정 금지' 방식 채택
모델링 전 참조 이미지Kie.ai nano-banana-2-lite비율 및 장면에 사용
음성, 효과, 음악ElevenLabs, Suno, FFmpeg전체 파이프라인 완료
코드 기반 2D 드로잉 (다른 스타일)alexgreensh/anidoodle, html-anime설치됨, Three.js 외부

자세한 내용, 링크 및 주의 사항: references/ressources.md.

10줄 요약 방법

  1. 무엇보다 먼저 참조: 스타일 비디오를 콘택트 시트로 분석, 참조 이미지, 측정된 사진.
  2. 코드 전에 스킬: 관련 threejs-* 또는 remotion-* 스킬을 로드하고, API를 절대 기억에 의존해 작성하지 않음.
  3. 좋은 코드를 연구한 후 다시 작성: 잘 만들어진 모듈을 읽고, 방법을 기록한 후 자신의 코드를 작성.
  4. 모든 것은 프레임 번호의 순수 함수: 고정 시드, 거리 기반 이동, 누적 상태 없음.
  5. 스크립트 → 음성 → 타임라인: 연출은 대사(at("l14"))에 맞춰 조정되며, 절대 하드코딩된 초 단위가 아님.
  6. 문제당 하나의 워크숍: 얼굴용 Lab 구성, 바디용 RigLab, 의심스러운 부분에 대한 실험 행렬.
  7. 렌더링, 검토, 수정: 정지 이미지 → 장면별 콘택트 시트 → 1프레임/초로 검토된 최종 비디오.
  8. 새로운 시각의 엄격한 감사: 모든 재설계 전에.
  9. 일찍 인간 검증: 긴 렌더링 전에 캐릭터와 스타일 방향.
  10. 자본화: 만난 모든 함정은 pitfalls.md에, 각 방법은 스킬에.

자세한 내용: references/methode.md.

절대 규칙

  • 검토되지 않은 렌더는 절대 보내지 마세요. 정지 이미지 하나로는 영화에 충분하지 않습니다. 콘택트 시트로 최종 비디오를 검토하세요.
  • 스타일이 정확성보다 우선합니다. 스타일화된 세계의 사실적인 얼굴은 두 번 거부되었습니다. 유사성은 형태와 몇 가지 선명한 특징을 통해 전달됩니다.
  • 라이선스를 준수하세요. Polyfork: 무료 비디오 사용, .mjs 모듈과 구운 클립은 공개 저장소나 패키지에 절대 포함하지 마세요.
  • 획 = 볼륨, 장소 = 인식 가능한 객체, 대사 = 그것을 보여주는 시각 자료.

학생에게 키트 전달하기

키트는 https://github.com/Alex-sia99/threejs-quality-kit 저장소에 게시되어 있습니다. 이 링크를 보내기만 하면 됩니다. README는 학생을 대상으로 합니다(전제 조건, 3단계 설치, 에이전트에게 제공할 문구). install.js는 공개 스킬과 시작 프로젝트를 직접 다운로드하므로 저장소는 가볍고 최신 상태를 유지합니다. Polyfork .mjs 모듈, anim-*.json 클립, API 키, 사진 또는 개인 음성을 여기에 절대 추가하지 마세요.

관련 스킬