<div align="center">
🏔️ 아이소메트릭 게임 에이전트 스킬 (Isometric Game Agent Skills)
AI 생성 아트부터 렌더링 엔진까지, 아이소메트릭 게임 구축을 위한 프로덕션급(Production-grade) AI 에이전트 스킬.
시니어 게임 아티스트와 엔진 프로그래머가 아이소메트릭 월드를 실제로 구축하는 방식 — 원활한 타일(seamless tiles), 깊이 정렬된 스프라이트(depth-sorted sprites), 그리드 수학(grid math), 그리고 전체 에셋 파이프라인(asset pipeline) — 을 AI 코딩 에이전트에게 가르치는 필수 도구 모음입니다.
Skills Format License PRs GitHub stars Validate Agents Live Demo Project
Quick Start · Live Demo · The Skills · Gallery · How Skills Work · Contributing · Roadmap
Hero banner
</div>
왜 이것이 존재하는가 (Why this exists)
AI 코딩 에이전트는 React에는 능하지만 아이소메트릭 게임에는 취약합니다. 이들은 정렬되지 않는 타일을 생성하고, 5가지 다른 스타일의 스프라이트를 만들며, 벽 뒤로 렌더링되는 캐릭터를 만들고, 최대 12fps까지 떨어지는 렌더러를 만듭니다. 모델이 약해서가 아닙니다 — 숙련된 아이소메트릭 개발자가 실제로 어떻게 작업하는지 아무도 기록하지 않았기 때문입니다.
이 레포지토리는 바로 그 지식이며, 에이전트가 필요할 때 로드할 수 있는 SKILL.md 파일 형태로 인코딩되어 있습니다. Claude Code, Cursor 또는 Codex를 이 파일에 연결하면, 여러분의 에이전트는 마치 아이소메트릭 월드를 세 개나 출시한 것처럼 구축하게 됩니다.
새로 오셨나요? 메타 스킬인 using-isometric-skills 로 시작하세요 — 이 스킬은 들어오는 모든 작업을 올바른 워크플로우로 라우팅합니다.
🚀 Quick Start
git clone https://github.com/0xheycat/isometric-game-skills.git
그런 다음 에이전트에 연결하세요 (사용할 도구를 선택하세요):
| Tool | How to install |
|---|
| Claude Code | 프로젝트의 .claude/skills/ 폴더 안에 임의의 skills/<name>/ 폴더를 복사합니다. |
| ... | 전체 워크스루: docs/getting-started.md. |
🎮 Live Demo
▶️ 브라우저에서 실시간으로 플레이하기 — GitHub Pages에 호스팅되어 설치가 필요 없습니다. 드래그하여 이동(pan)하고, 스크롤하여 확대/축소(zoom)하며, 🖼️ 스프라이트 표시 여부를 토글할 수 있습니다.
단일 파일이며 의존성(dependency)이 없는 Canvas2D 아이소메트릭 렌더러가 demo/에 구현되어 있습니다. — 이 스킬들이 이론이 아니라 실제임을 증명합니다. 절차적 지형(Procedural terrain), 깊이 정렬된 객체(depth-sorted objects), 타일 선택(tile picking), 그리고 이동/확대/축소 카메라가 모두 하나의 HTML 파일에 담겨 있습니다.
python3 -m http.server 8080
이 코드는 여섯 가지 스킬을 직접적으로 활용합니다: isometric-grid-math, canvas2d-isometric-renderer, depth-sorting-occlusion, tilemap-data-format, tile-picking-interaction, 그리고 camera-pan-zoom-controls. demo/README.md를 참조하세요.
평평한 블록 대신 회화적인(painterly) 스프라이트로 같은 세계를 원하십니까? 생성 스킬에서 에셋을 가져와서 + spritesheet-atlas-packing에 적용할 수 있습니다.
🗺️ 모든 요소가 어떻게 결합되는지 (How it all fits together)
이것들은 단순히 나열된 팁 20개가 아닙니다. 이들은 에이전트를 빈 폴더에서 **플레이 가능한 아이소메트릭 장면(playable isometric scene)**으로 만드는 하나의 파이프라인으로 연결됩니다. 이론이 아닌 증명입니다.
Pipeline: all 20 skills from setup to playable scene
🧩 스킬 모음집(The Skill Collection)
아이소메트릭 게임 파이프라인 전체를 다루는 21가지 스킬로 구성되어 있으며, 단계별로 그룹화되어 있습니다. 이들을 순서대로 실행하거나 필요한 것만 로드할 수 있습니다.
🎨 아트 기초(Art Foundations)
🖼️ 에셋 생성 (Asset Generation) (AI)
🧰 에셋 처리 (Asset Processing)
⚙️ 엔진 및 렌더링 (Engine & Rendering)
🕹️ 게임플레이 시스템 (Gameplay Systems)
🚀 다듬기 및 배포 (Polish & Ship)
🖼️ 갤러리 (Gallery)
이러한 스킬들을 적용했을 때의 실제 결과물 (Hay Day 스타일 페인팅 아이소메트릭):
| Seamless terrain | Object sprites | Building sprites |
|---|
| terrain | objects | buildings |
| 8-direction character | Autotiling transitions | Animated frames |
|---|
| character | autotiling | animation |
📐 스킬 작동 방식 (How Skills Work)
각 스킬은 YAML 프론트매터와 고정된 구조를 가진 단일 SKILL.md 파일로, 에이전트가 지름길을 택하는 것을 막도록 설계되었습니다:
- 프론트매터(Frontmatter) — 에이전트가 자동으로 선택할 수 있도록 "사용 시..."로 시작하는
name과 description.
- 프로세스(Process) — 번호가 매겨진, 협상 불가능한 단계들 (산문이 아닌 과정).
- 합리화(Rationalizations) — 에이전트가 스스로를 설득하는 변명과 실제 사실을 짝지어 제시하여 작업을 회피할 수 없게 만듦.
- 위험 신호(Red Flags) — 작동 중단 조건으로, 현재 버그가 포함된 무언가를 배포하려 한다는 의미임.
- 검증(Verification) — 체크리스트입니다. 모든 항목을 확인하기 전까지는 완료되지 않습니다.
전체 사양은 docs/skill-anatomy.md에서 읽어보세요.
🤝 기여 (Contributing)
PR(Pull Request)은 환영합니다 — 새로운 스킬, 수정 사항, 스크린샷 모두 도움이 됩니다. CONTRIBUTING.md를 읽고 새로운 스킬 이슈 템플릿을 사용하여 제안하세요. 모든 스킬은 구조(anatomy)를 따르고 검증 체크리스트와 함께 배포되어야 합니다.
🗺️ 로드맵 (Roadmap)
⭐ 이 저장소에 별표하기 (Star this repo)
만약 이것이 에이전트와 씨름하던 주말을 아껴주었다면, **별표(star)**를 눌러주세요 — 다른 게임 개발자들이 이 저장소를 찾도록 돕습니다.
📈 별표 기록 (Star History)
<a href="https://star-history.com/#0xheycat/isometric-game-skills&Date">
<img src="https://api.star-history.com/svg?repos=0xheycat/isometric-game-skills&type=Date" alt="Star History Chart" width="600">
</a>
📄 라이선스 (License)
MIT — LICENSE를 참조하세요. 상업용 게임에 사용하고, 포크(fork)하거나 리믹스(remix)하세요.
키워드 (Keywords)
<sub ext>isometric-game-skills · isometric · game-development · gamedev · ai-agents · agent-skills · claude-code · cursor · comfyui · sdxl · sprite-generation · tilemap · autotiling · canvas2d · pathfinding · depth-sorting · godot · game-art · asset-pipeline · procedural-generation · 2d-games</sub