EL4CTEO/blender-skills

Blender Agent Skills

소개

• AI 코딩 어시스턴트(Claude Code, Codex, OpenCode, Gemini CLI, GitHub Copilot, Cursor)가 Blender 5.2 LTS+를 구동하여 전문적인 3D 에셋을 제작할 수 있도록 돕는 22개의 즉시 사용 가능한 Agent Skills 모음입니다.
• 각 스킬은 3D 파이프라인의 특정 부분(모델링, UV, PBR 재질 설정, 베이킹, 리깅, 애니메이션, 최적화, 내보내기, 렌더링, 환경 효과, QA 등)을 캡슐화한 작은 스크립트입니다.
• 이 스킬들은 실제 Blender 설치 환경에서 테스트되었으며, AI 에이전트가 내장 명령어처럼 호출할 수 있습니다.

설치

• Claude Code: Claude 플러그인 마켓플레이스를 통해 리포지토리를 추가하고 blender-agent-skills 패키지를 설치합니다.
• 기타 에이전트: 리포지토리를 복제하고 제공된 설치 프로그램을 실행합니다(macOS/Linux는 install.sh, Windows는 install.ps1). 기본적으로 스킬은 ~/.claude/skills 및 ~/.agents/skills에 배치되며, 지원되는 에이전트가 이를 자동으로 읽어옵니다.
• 선택 사항: Blender MCP server를 실행하면 에이전트가 이미 열려 있는 Blender UI를 제어할 수 있습니다. 그렇지 않은 경우 스크립트는 Blender를 헤드리스 모드(headless mode)로 실행합니다.

스킬 카탈로그 (README의 간략한 설명)

스킬	기능
blender-core	진입점: 코드 실행, 작업 라우팅, Blender 5.x API 규칙 강제
blender-scene-setup	단위, 명명 규칙, 컬렉션, 에셋 라이브러리 설정
blender-hardsurface-modeling	하드 서피스 작업을 위한 베벨, 불리언, 가중치 노멀
blender-sculpting	유기적 스컬핑 워크플로우
blender-retopology-uv	리토폴로지, UV 언랩, 텍셀 밀도 확인
blender-pbr-materials	텍스처 맵에서 올바른 PBR 재질 생성
blender-texture-baking	노멀, AO, 곡률, ORM 맵 베이킹
blender-geometry-nodes	간단한 JSON 입력을 통한 절차적 모델링
blender-character-rigging	Rigify 설정, 스키닝, 게임 엔진용 스켈레톤
blender-facial-shapekeys	ARKit 스타일의 52개 블렌드셰이프 및 비젬 추가
blender-animation	액션 생성, NLA 트랙, 모션 캡처 가져오기, 루트 모션
blender-game-optimization	예산 확인, LOD 생성, 드로우 콜 감소
blender-export-pipelines	Roblox, Unity, Unreal, Godot, 웹, USD로 내보내기
blender-rendering	Cycles 및 EEVEE 배치 렌더링
blender-lighting-lookdev	스튜디오 조명, HDRI, 턴테이블 렌더링
blender-simulation	강체, 천, 유체 시뮬레이션
blender-time-of-day	골든 아워, 야간, 안개, 분위기 조명
blender-weather-fx	비, 눈, 젖은 거리, 웅덩이, 번개
blender-addon-development	사용자 지정 Blender 애드온 생성을 위한 보일러플레이트
blender-pipeline-automation	배치 작업, 파일 변환 스크립트
blender-asset-qa	Z-파이팅, 떠 있는 부품, 잘못된 노멀/웨이트 감지
blender-workflow-recipes	일반적인 에셋 유형을 위한 엔드 투 엔드 플레이북

도움이 되는 점

• *“베이킹된 노멀과 LOD가 포함된 Unreal용 게임 준비 크레이트를 만들어줘”*와 같은 프롬프트가 사용자가 Python을 작성할 필요 없이 구체적인 Blender 작업으로 변환됩니다.
• 비교 페이지(README에 링크됨)를 보면 이 스킬들을 사용했을 때 결과물의 품질이 눈에 띄게 향상됨을 확인할 수 있습니다.

개발 및 테스트

• tools/validate_skills.py는 스킬 사양과 토큰 예산 제한을 확인합니다.
• tools/run_tests.py는 50개의 헤드리스 Blender 테스트를 실행합니다(BLENDER_EXE를 통해 사용자 지정 가능).

라이선스

• MIT License.

---

모든 세부 정보는 리포지토리의 README에서 직접 가져왔습니다.