thedivergentai/GD-Agentic-Skills

The official "Long-Term Memory" for Godot 4.7+ AI Agents. A high-density library of 99 expert skills and 27 genre blueprints, providing audited, strictly typed GDScript patterns, automated persona orchestration (Analyst, Auditor, Builder), and production-grade game engineering.

GD Agentic Skills – Godot 4.7+ 마스터리 생태계

무엇인가요

최적의 실천 방법을 반영한 99 개의 "도메인 스킬"(이전의 마이크로 스킬) 컬렉션. 이들은 Godot 4.7+ 코드, 아키텍처 패턴, 프로덕션 준비된 GDScript 스니펫을 인코딩합니다.
이 라이브러리는 AI 코딩 에이전트(예: Claude Code, Cursor, Gemini‑CLI 등)를 위한 외부 장기 기억으로 설계되었습니다.
특별한 스킬인 godot‑master 는 모든 다른 스킬을 참조하고, 의사결정 매트릭스, 악성 패턴, 성능 예산을 추가하는 오케스트레이터 역할을 합니다.

왜 중요한가요

현대의 AI 에이전트는 종종 "환각"을 일으키거나 공식 Godot 문서에서 벗어난 코드를 생성합니다.
결정적이고 토큰 효율적인 지식 기반을 에이전트에 제공함으로써, 모델의 컨텍스트를 집중시키고 출력을 엔진의 최신 API와 일치시킵니다.
리포지토리에는 비전 스킬(godot‑agent‑vision)도 포함되어 있어, 에이전트가 에디터 GUI/자산 스크린샷을 캡처하고 WebP로 변환하며, 프로덕션 기준에 따라 결과를 평가할 수 있게 해줍니다. 이로써 에이전트가 파일 경로만 읽는 것이 아니라 프로젝트를 "보는" 방법을 제공합니다.

핵심 개념

개념	기능
도메인 스킬	작은, 자가 포함형 마크다운 파일(`SKILL.md`)로, 하나의 Godot 기능(예: `godot‑characterbody‑2d`, `godot‑game‑loop‑waves`)을 설명합니다. 각 파일에는 공식 문서 링크, 샘플 스크립트, 마이그레이션 노트가 포함됩니다.
Godot‑master	모든 99개의 도메인 스킬을 집약하고, 의사결정 매트릭스, 악성 패턴 목록, 성능 예산, 계층적 신호 기반 아키텍처 다이어그램을 추가하는 "리드 아키텍트" 스킬입니다. 새로운 프로젝트 시작이나 전체 프로젝트 가이드가 필요한 에이전트의 최초 진입점입니다.
에이전트 우선 설계 (DIA 루프)	발견-인제스트-적용 루프는 에이전트가 `skills_index.json`를 찾고, 적절한 `SKILL.md` 파일을 읽어 모델의 컨텍스트를 과부하하지 않고 지식을 적용하는 방법을 알려줍니다.
설치 기준	각 에이전트별 설치 플래그(`-a cursor`, `-a claude-code`, …)와 예상되는 디렉터리 구조(`.agents/skills/`, `~/.cursor/skills/`, 등)의 표입니다.
컨텍스트 폭풍 방어장치	`--all`을 사용하지 말 것을 명시적인 경고합니다. 모든 스킬을 한 번에 설치하면 약 15k 토큰을 소비하고 "메타데이터 폭풍"이 발생해 추론 속도가 느려집니다.

빠른 시작 경로

경로	사용 시기	명령어 (`skills` CLI를 통해)
A – 아키텍트	새 프로젝트 시작 또는 기존 프로젝트의 완전한 감사가 필요한 경우.	`npx skills add thedivergentai/gd-agentic-skills/skills/godot-master -g -a <agent> -y`
B – 전문가	단일 기능(예: 2D 이동, 인벤토리)만 필요할 경우.	`npx skills add thedivergentai/gd-agentic-skills/skills/godot-characterbody-2d -g -a <agent> -y`

설치 후 npx skills list -g -a <agent>를 실행하여 확인하고 호스트 에이전트를 재시작하여 새로운 스킬 파일을 로드하세요.

주목할 만한 업데이트 (최신 v0.0.11)

godot‑agent‑vision – 에디터 GUI/자산 뷰포트를 캡처하고 WebP로 저장하며, 세밀한 평가 기준(타이포그래피 가중치, 기울기 방지, 정체성)에 따라 시각적 출력을 평가합니다.
크로스플랫폼 호스트 CLI – Windows/macOS/Linux를 지원하는 얇은 래퍼. 리포지토리와 에이전트를 연결합니다. .gdskills/ 아래에 있으며, 게임 내 Autoload가 아닙니다.
마이그레이션 스테이션 – 전용 스킬(godot‑version‑migration)으로, 어떤 오래된 Godot 버전에서든 4.7까지 단계별로 업그레이드하는 가이드를 제공하며, 각 스킬별 마이그레이션 노트 포함.
참고 레티스 – 모든 도메인 스킬은 공식 Godot 문서와 관련 스킬의 큐레이션된 목록으로 마무리되며, 에이전트가 스킬 그래프를 벗어나지 않고 "더 깊이 조사"할 수 있게 합니다.

대상 사용자

Godot 프로젝트 생성 또는 리팩터링을 수행하는 AI 코딩 에이전트(Claude Code, Cursor, Gemini‑CLI 등).
자신의 에이전트에 공급하거나 수동으로 탐색할 수 있는 토큰 효율적이고 검증된 참조 라이브러리가 필요한 인간 개발자.
프로그래밍적으로 질의 가능한 구조적이고 최신의 Godot 최적 실천 예제를 찾는 교육자/멘토.

제한 사항 및 주의사항

이 라이브러리는 Godot 외부에 있습니다. Godot 플러그인이나 Autoload로 설치되지 않습니다. 에이전트는 마크다운 파일을 읽고 제공된 스니펫을 직접 삽입해야 합니다.
skills CLI (Vercel‑Labs 도구)를 사용한 설치에 의존합니다. 이 CLI를 사용하지 않는 사용자는 "클론 / DIA 경로" 워크플로우를 따라야 합니다: skills_index.json을 읽고 에이전트의 파일 도구로 관련 SKILL.md 파일을 엽니다.
모든 99개의 스킬을 한 번에 설치하는 것은 권장되지 않습니다. 큰 토큰 예산을 소비하고 "컨텍스트 폭풍"을 유발할 수 있습니다. 권장되는 패턴은 단일 godot‑master 오케스트레이터 또는 타겟된 도메인 스킬의 소수를 설치하는 것입니다.
비전 스킬은 현재 예산 기반 WebP 이미지와 평가 점수를 출력하지만, 제공된 평가 기준을 넘어서는 완전한 이미지 분석은 수행하지 않습니다.

결론

GD Agentic Skills는 AI 코딩 에이전트가 Godot 4.7+에서 체계적이고 최적 실천 중심으로 작업할 수 있도록 설계된 목적 지향적이고 토큰 효율적인 지식 기반입니다. godot‑master 스킬을 전체적으로 또는 선택적인 도메인 스킬을 설치함으로써, 에이전트는 큐레이션된 문서 링크, 프로덕션 수준의 GDScript 스니펫, 마이그레이션 가이드, 시각적 검증에 접근할 수 있지만, 모델의 컨텍스트를 과부하하지 않습니다.

빠른 참조 링크

전체 스킬 인덱스: skills_index.json
Godot‑master 스킬: skills/godot-master/SKILL.md
비전 스킬: skills/godot-agent-vision/SKILL.md
설치 가이드: 위의 ⚡ 빠른 시작 표를 참조하세요.