Communitygithub.com

linegel/threejs-complete-set-of-skill

야심 찬 Three.js WebGPU/TSL 장면을 위한 25가지 전문 에이전트 스킬 — 절차적 바다, 구름, 행성, 수광학, 이미지 파이프라인 및 스크린샷 기반 시각적 검증. Claude Code, Codex, Cursor 및 모든 스킬 인식 에이전트용.

threejs-complete-set-of-skill란 무엇인가요?

이 스킬은 Three.js WebGPU/TSL 기반의 고급 장면 제작을 위해 25개의 전문 에이전트 스킬을 제공합니다. 절차적 바다, 구름, 행성, 수광학 효과, 이미지 파이프라인, 스크린샷 기반 시각적 검증 등 복잡한 그래픽스 작업을 지원합니다. Claude Code, Codex, Cursor 등 다양한 스킬 인식 에이전트에서 사용할 수 있으며, WebGPU 렌더러와 TSL(Three.js Shading Language)을 최우선 아키텍처로 채택합니다. 각 스킬은 Bloom, MRT(Multi-Render Target), 노드 기반 셰이딩 등 Three.js의 최신 기능을 활용하여 HDR 신호 보존, 선택적 블룸, 성능 예산 관리 등을 구현합니다. SKILL.md 문서는 아키텍처 우선 접근법, 워크플로, 기능 게이트, 실패 조건 및 라우팅 경계를 명확히 제시하여 AI 에이전트가 일관되고 최적화된 렌더링 파이프라인을 구축할 수 있도록 안내합니다.

지원 대상✓Claude Code✓Codex CLI✓Cursor
npx skills add linegel/threejs-complete-set-of-skill

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

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

문서

블룸

블룸은 밝은 HDR 신호에 대한 카메라/디스플레이 반응입니다. 작성된 장면 휘도에 의해 공급되는 하나의 노드-파이프라인 효과로 가르치되, 객체나 효과의 유일한 가시 형태로 사용하지 마십시오.

아키텍처 우선

프로덕션 경로는 최신 Three.js WebGPURenderer (three/webgpu), TSL (three/tsl), RenderPipeline, pass(), mrt({ output, emissive }) 및 bloom()의 BloomNode를 사용합니다.

장면 패스 MRT 이미시브 출력으로부터 선택적 블룸을 구축하십시오:

scene pass with MRT output + emissive
  -> scene color texture node
  -> emissive contribution texture node
  -> bloom(emissive).setResolutionScale(...)
  -> scene color + bloom
  -> single renderOutput / outputColorTransform owner

이 스킬의 최상위 아키텍처입니다: 하나의 장면 렌더링, 직접 MRT-선택적 기여, 최종 출력 변환까지 HDR 신호 보존, 값비싼 블러 작업을 위한 패스별 해상도 스케일링.

r185 시대 WebGPU/TSL 스켈레톤, 기능 게이트, 품질 계층, 예산, 색상 규칙, 진단 및 교체 노트는 references/hdr-bloom-system.md를 참조하십시오.

표준 WebGPU/TSL 예제: examples/node-selective-bloom/.

워크플로

  1. 블룸이 더 큰 이미지 파이프라인의 일부인 경우 $threejs-choose-skills 사전 점검을 실행하십시오.
  2. NodeMaterial 재질로 이미시브 기여를 작성하고 MRT emissive로 라우팅하십시오.
  3. 별도의 장면 렌더링이 아닌 이미시브 텍스처 노드에서 BloomNode를 공급하십시오.
  4. 톤 매핑 전 HDR에서 strength, radius, threshold, smoothWidth 및 setResolutionScale()을 조정하십시오.
  5. 정확히 하나의 톤 매핑 및 출력 변환 소유자를 유지하십시오.
  6. 데스크탑-개별, 데스크탑-통합 및 모바일 예산에서 베이스, 이미시브 기여, 블룸 전용 및 최종 출력 뷰를 검증하십시오.

기능 게이트

MRT 또는 스토리지 리소스를 사용하는 모든 구현은 렌더러 초기화 후 게이트해야 합니다:

await renderer.init();

if ( renderer.backend.isWebGPUBackend !== true ) {
  throw new Error(
    'WebGPU backend required for threejs-bloom. If the user explicitly asks how to apply fallback when WebGPU is unavailable, route to threejs-compatibility-fallbacks.'
  );
}

// WebGPU 티어는 bloomScale, pixelRatioCap, 기여자 수를 줄이거나
// 읽을 수 있는 기본 장면을 유지하면서 블룸을 비활성화할 수 있습니다.

레거시 WebGL 구현 (더 이상 사용하지 않음, 확장 금지): 이 스킬 폴더에는 없음; 명시적 폴백 요청은 $threejs-compatibility-fallbacks로 라우팅됩니다.

실패 조건

  • 블룸이 효과의 유일한 가시 형태를 만드는 경우;
  • 일반 알베도 또는 조명된 표면이 이미시브 기여 대상으로 누출되는 경우;
  • 모든 밝은 재질이 하나의 임의 방출 배율을 공유하는 경우;
  • 임계값이 톤 매핑 또는 디스플레이 변환 후에 조정되는 경우;
  • 여러 시스템이 톤 매핑 또는 출력 색상 변환을 소유하는 경우;
  • 블룸 패스가 대역폭 제한 장치에서 기본적으로 전체 해상도로 실행되는 경우;
  • 크기 조정 경로가 setSize() 또는 해상도 스케일 검증을 생략하는 경우;
  • 블룸 전에 HDR 에너지가 클램핑되어 하이라이트가 회색이 되는 경우.

라우팅 경계

측광, 적응, 톤 매핑 및 LUT에는 $threejs-exposure-color-grading을 사용하십시오. 블룸이 깊이, 법선, AO, TAA 또는 기타 이미지 공간 리소스를 공유해야 하는 경우 $threejs-image-pipeline을 사용하십시오. 고정 뷰 패스 진단 및 GPU 타이밍 증거에는 $threejs-visual-validation을 사용하십시오.

관련 스킬