Skip to content
Back to search

game-dev-agentic-skills

Multi-engine long-term memory for game AI agents. Deep Godot 4.7+ (99 skills, 27 genre blueprints) + Bevy docs-first parity — audited patterns, persona orchestration (Analyst · Auditor · Builder), production-grade engineering.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/thedivergentai--game-dev-agentic-skills/badge.svg)](/listings/thedivergentai--game-dev-agentic-skills)

HTML

<a href="/listings/thedivergentai--game-dev-agentic-skills"><img src="/api/listings/thedivergentai--game-dev-agentic-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Choose **one** path so you do not trigger a **"Context Storm"** (flooding the agent with every skill at once).

Path A: Godot

New Godot project, or an existing one that needs a **Godot 4.7+** standards check - install the Godot hub **or** one Godot Domain Skill:

npx skills add thedivergentai/Game-Dev-Agentic-Skills/skills/godot-master
# or one Domain Skill:
npx skills add thedivergentai/Game-Dev-Agentic-Skills/skills/godot-characterbody-2d

Path B: Bevy

Bevy work starts at the Bevy hub **or** one Bevy Domain Skill:

npx skills add thedivergentai/Game-Dev-Agentic-Skills/skills/bevy-master
# or one Domain Skill:
npx skills add thedivergentai/Game-Dev-Agentic-Skills/skills/bevy-ecs-composition

Path C: One specialist skill

Need a single feature and already know which skill owns it - install only that path (either engine):

npx skills add thedivergentai/Game-Dev-Agentic-Skills/skills/godot-inventory-system
npx skills add thedivergentai/Game-Dev-Agentic-Skills/skills/bevy-inventory-system

> [!DANGER] > **NEVER** use the `--all` flag when installing this repository (e.g., `npx skills add ... --all`). That is an **"Instant No-No"** — it forces your agent to load every metadata entry across **184** skills and triggers an unrecoverable Context Storm.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 940 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Game Dev Agentic Skills
  2. <div align="center">
  3. <img src="assets/hero_banner.webp" alt="Game Dev Agentic Skills — Godot & Bevy" width="100%" />
  4. [![GitHub Stars](https://img.shields.io/github/stars/thedivergentai/Game-Dev-Agentic-Skills?style=for-the-badge&logo=github&color=58A6FF)](https://github.com/thedivergentai/Game-Dev-Agentic-Skills/stargazers)
  5. [![License](https://img.shields.io/badge/License-LGPL--3.0-blue?style=for-the-badge)](LICENSE)
  6. [![Godot Version](https://img.shields.io/badge/Godot-4.7%2B-478CBF?style=for-the-badge&logo=godotengine&logoColor=white)](https://godotengine.org/)
  7. [![Bevy Version](https://img.shields.io/badge/Bevy-0.20%2B-232323?style=for-the-badge&logo=bevy&logoColor=white)](https://bevyengine.org/)
  8. [![Skills](https://img.shields.io/badge/Skills-184-green?style=for-the-badge)](skills_index.json)
  9. [![Last Commit](https://img.shields.io/github/last-commit/thedivergentai/Game-Dev-Agentic-Skills?style=for-the-badge&color=purple)](https://github.com/thedivergentai/Game-Dev-Agentic-Skills/commits/main)
  10. [![Installs](https://img.shields.io/endpoint?url=https://skills.sh/api/badge/thedivergentai/gd-agentic-skills&style=for-the-badge&label=INSTALLS&color=FFC107)](https://skills.sh/thedivergentai/Game-Dev-Agentic-Skills)
  11. **Game Dev Agentic Skills (GDAS)** - agent library for **Godot 4.7+** and **Bevy 0.20+**
  12. **"A skill forgotten is a power lost." — The Code Architect**
  13. **Brought to you by [Divergent AI](https://github.com/thedivergentai)**
  14. </div>
  15. ---
  16. ## 📜 Updates
  17. <div align="center">
  18. <img src="assets/banner_0_1_1.webp" alt="Artifact to Engine - v0.1.1" width="100%" />
  19. </div>
  20. ### v0.1.1 - Artifact to Engine
  21. **October 16, 2026**
  22. - **[gdas-reader](skills/gdas-reader/SKILL.md)**: reads a source tree, web bundle, asset folder, WASM module, or PE/ELF header into an evidence ledger. It is shared by both engines and is not part of either hub mirror.
  23. - **[godot-rea](skills/godot-rea/SKILL.md)**: emits a Godot 4.7 stub project from that ledger. Unknown behavior stays `pass`.
  24. - **[bevy-rea](skills/bevy-rea/SKILL.md)**: emits a Bevy 0.20 stub crate from the same ledger. Empty systems stay empty until a Domain Skill fills them.
  25. - **License gate**: asset bytes are copied only when you pass a real license note and `--allow-assets`.
  26. ---
  27. <details>
  28. <summary><b>📜 Update Archive</b></summary>
  29. <div align="center">
  30. <img src="assets/banner_bevy.webp" alt="Bevy skills - v0.1.0" width="100%" />
  31. </div>
  32. #### v0.1.0 - Bevy skills
  33. **October 11, 2026**
  34. - **Two engines**: Godot 4.7+ under **[godot-master](skills/godot-master/SKILL.md)** and Bevy 0.20+ under **[bevy-master](skills/bevy-master/SKILL.md)**, each with its own hub and Domain Skills.
  35. - **Route by engine**: Godot work starts at godot-master. Bevy work starts at bevy-master. There is no singular product-wide master.
  36. - **Bevy Domain Skills**: ECS ownership, rendering, gameplay, UI, platforms, and genre skills. Install one path at a time.
  37. <div align="center">
  38. <img src="assets/banner_0_0_11.webp" alt="Agent Eyes Update - v0.0.11" width="100%" />
  39. </div>
  40. #### v0.0.11 — Agent Eyes
  41. - **500 stars** — thank you. That puts this repo in roughly the **top 0.4%** of all public GitHub repositories.
  42. - **New — [godot-agent-vision](skills/godot-agent-vision/SKILL.md)**: agents get **eyes** — capture GUI / assets / editor viewports to budgeted WebP, then score what they see against a granular production rubric (typography-weighted, anti-slop, identity).
  43. - Cross-platform host CLI (Win / macOS / Linux) + TEMP editor bridge under `.gdskills/` — not an in-game Autoload.
  44. <div align="center">
  45. <img src="assets/banner_0_0_10.webp" alt="Migration Station Update - v0.0.10" width="100%" />
  46. </div>
  47. #### v0.0.10 — Version Station
  48. - **Version Station**: New Architecture skill - [godot-version-migration](skills/godot-version-migration/SKILL.md) - full-history engine upgrades from early Godot through **4.7** (legacy eras, official 3 to 4, then hop-by-hop 4.x).
  49. - **Per-skill version notes**: Every Domain Skill ships `references/migration-notes.md`; Domain `SKILL.md` bodies stay on **current** APIs.
  50. - **Routing**: Analyst, Auditor, Builder, foundations, GDScript, and TileMap point engine-version work at that hub; `godot-master` routes upgrades there.
  51. <div align="center">
  52. <img src="assets/banner_0_0_9.webp" alt="The Reference Rail Update - v0.0.9" width="100%" />
  53. </div>
  54. #### v0.0.9 — The Reference Rail Update
  55. - **The reference rail**: Every Domain Skill now ends with curated official documentation (`docs.godotengine.org/en/stable/`) plus Related Skills (Prerequisites / Complements / Downstream / Master), so agents can research deeper without leaving the skill graph.
  56. - **Script and reference footers**: Research-link comment blocks on Domain Skill scripts and reference notes (marker `GDSkills research links (agents)`) - non-executing, file-specific, progressive disclosure.
  57. - **SPECIAL MENTION —** <a href="https://github.com/DedInc"><img src="https://wsrv.nl/?url=github.com/DedInc.png&w=64&h=64&mask=circle&fit=cover&maxage=1w" width="22" height="22" alt="@DedInc" /></a> [**@DedInc**](https://github.com/DedInc): First external Domain Skill — [godot-monte-carlo-balancer](skills/godot-monte-carlo-balancer/SKILL.md) — source-driven Monte Carlo balance lab (Rust + rayon), Resource-first extract, playstyle CI bands, economy careers, and headless Godot calibration. Thank you!
  58. <div align="center">
  59. <img src="assets/banner_0_0_8.webp" alt="The Director's Cut Update - v0.0.8" width="100%" />
  60. </div>
  61. #### v0.0.8 — The Director's Cut Update
  62. - **Godot 4.7 Director's Cut**: Full library upgrade to Godot 4.7+ - AreaLight3D, HDR output, Asset Store, built-in virtual joystick, and a version digest for 4.6 to 4.7 projects.
  63. - **Domain Skills**: Renamed "Micro-Skills" to **Domain Skills** - 92 modular topic skills, each with a 4.7 baseline and targeted version deltas.
  64. - **Persona Squad**: Anara, Aurelius, and Builder updated for 4.7 scoring, never-lists, and `GODOT_PATH` CLI overrides.
  65. <div align="center">
  66. <img src="assets/banner_0_0_7.webp" alt="The Analyze, Audit, Build! Update - v0.0.7" width="100%" />
  67. </div>
  68. #### v0.0.7 — The Analyze, Audit, Build! Update
  69. - **Three Persona-Based Skills**: We introduced specialized agent skills for `@godot-analyst` (Anara), `@godot-auditor` (Aurelius), and `@godot-builder` to streamline and unify our persona development and code optimization workflows.
  70. - **MCP Clean-up & Direct Building**: Defunct `MCP Setup` and `MCP Builder` skills have been removed; we now use Auditor and Builder to construct and compile projects directly via the Godot CLI, maximizing native efficiency.
  71. - **Full Skills Audit**: Completed a comprehensive and rigorous audit of all microskills to elevate the knowledge depth and execution quality to the highest agentic standard.
  72. - **Lead Architect Sync**: Synchronized all audited advancements with the central `godot-master` hub, making the orchestrator smarter, faster, and more robust.
  73. <div align="center">
  74. <img src="assets/banner_0_0_6.webp" alt="The Expert Augmentation Update - v0.0.6" width="100%" />
  75. </div>
  76. #### v0.0.6 — The Expert Augmentation & Master Orchestration Update
  77. - **Microskill Overhaul**: We spent many hours updating *all* microskills to contain top expert-level knowledge, directly extracted from the Godot documentation. This massive update ensures all resources are true to the current engine state, empowering developers with best practices and reducing AI slop.
  78. - **Godot Master Takes Control**: We updated the `godot-master` skill to fully orchestrate and integrate this major skill update. It is now a true, all-in-one Godot Master skill!
  79. - **Feedback Requested**: We'd love your feedback on the new updates! The easiest way to share your thoughts is to [open an issue or start a discussion on our GitHub](https://github.com/thedivergentai/Game-Dev-Agentic-Skills/issues).
  80. <div align="center">
  81. <img src="assets/banner_0_0_5.webp" alt="The Looper Update - v0.0.5" width="100%" />
  82. </div>
  83. #### v0.0.5 — The Looper Update
  84. - **Resource Harvesting**: Introduced `godot-game-loop-harvest` for interactive gathering, node depletion, and rarity-based drop tables.
  85. - **Time Trials & Ghosts**: Added `godot-game-loop-time-trial` with precise millisecond timing and ghost transform recording/playback.
  86. - **Wave-Based Survival**: Implemented `godot-game-loop-waves` for round-based difficulty scaling and dynamic enemy pool management.
  87. <div align="center">
  88. <img src="assets/banner_0_0_4.webp" alt="The Easter & Renewal Update - v0.0.4" width="100%" />
  89. </div>
  90. #### v0.0.4 — The Easter & Renewal Update
  91. - **Seasonal Theming Identity**: Introduced `godot-theme-easter` for safe, runtime aesthetic injection (StyleBox duplication & material swapping).
  92. - **Core Loop Expansion**: Added `godot-game-loop-collection` for volumetric procedural spawning and `godot-mechanic-revival` for "Souls-like" mortality.
  93. - **Interaction Secrets**: Implemented `godot-mechanic-secrets` for input sequence buffering (Konami code) and hidden discovery persistence.
  94. <div align="center">
  95. <img src="assets/banner_0_0_3.webp" alt="The Romance Update - v0.0.3" width="100%" />
  96. </div>
  97. #### v0.0.3 — The Romance Update
  98. - **New Genre Mastery**: Introduced the comprehensive [Romance & Dating Sim](skills/godot-genre-romance/SKILL.md) skill set.
  99. - **Master Integration**: Unified the Romance skill into the [godot-master](skills/godot-master/SKILL.md) orchestration layer.
  100. - **Production Scripts**: Added battle-tested GDScript patterns for affection tracking, relationship routing, and date events.
  101. <div align="center">
  102. <img src="assets/banner_0_0_2.webp" alt="Master Skill Evolution - v0.0.2" width="100%" />
  103. </div>
  104. #### v0.0.2 — Master Skill Evolution
  105. - **Unified Architecture**: Upgraded `godot-master` to an all-in-one orchestration layer for all 87 specialized skills.
  106. - **Decision trees**: Integrated expert-level Godot 4 architectural decision trees and anti-pattern guides.
  107. - **Workflow Scaffolding**: Added programmatic scene building and project initialization patterns.
  108. <div align="center">
  109. <img src="assets/banner_0_0_1.webp" alt="Initial Launch - v0.0.1" width="100%" />
  110. </div>
  111. #### v0.0.1 — Initial Launch
  112. - **The Foundation**: Released the initial library of 80+ Godot 4.x Agentic Skills.
  113. - **Agent-First Design**: Established the DIA (Discovery-Ingestion-Application) loop for AI Coding Agents.
  114. - **Core Systems**: Atomic implementations for 2D, 3D, UI, and Gameplay fundamentals.
  115. </details>
  116. ---
  117. ## Engines
  118. **Game Dev Agentic Skills** is one product with per-engine trees. Pick the master for the engine you are shipping — there is **no** singular product-wide master.
  119. | Engine | Master | What you get |
  120. | --- | --- | --- |
  121. | **Godot 4.7+** | [godot-master](skills/godot-master/SKILL.md) | 99 Domain Skills, personas, workflows, production scripts |
  122. | **Bevy 0.20+** | [bevy-master](skills/bevy-master/SKILL.md) | ECS hub plus 82 Domain Skills |
  123. Install **one** engine master or **one** Domain Skill — never `--all`. Pick the engine you are shipping; skills stay engine-scoped.
  124. ## 📍 Quick Navigation
  125. | 🚀 Get Started | 🟦 Godot Master | 🦀 Bevy Master | 🧩 Domain Skills | 🤖 Agent Protocol | ⭐ Star History |
  126. |:---:|:---:|:---:|:---:|:---:|:---:|
  127. | [Install](#-quick-start) | [Godot hub](#-godot-master---godot-hub) | [Bevy hub](#-bevy-master---bevy-hub) | [Godot skills](#godot-domain-skills) · [Bevy skills](#bevy-domain-skills) | [DIA Loop](#-for-agents--the-discovery-ingestion-application-protocol) | [Growth Chart](#-star-history) |
  128. ---
  129. ## The Philosophy
  130. **Game Dev Agentic Skills (GDAS)** is an agent-first knowledge library for shipping real games — not AI slop. Each engine gets its own master and Domain Skills.
  131. - **Godot 4.7+** is fully supported: doc-true patterns, personas, and production scripts under [godot-master](skills/godot-master/SKILL.md).
  132. - **Bevy 0.20+** is fully supported: ECS ownership and Domain Skills under [bevy-master](skills/bevy-master/SKILL.md).
  133. - Skills stay engine-scoped. Install one path so you do not trigger a Context Storm.
  134. **If this project helps your development or empowers your agents, please give it a star! 🌟**
  135. ---
  136. ## ⚡ Quick Start
  137. Choose **one** path so you do not trigger a **"Context Storm"** (flooding the agent with every skill at once).
  138. ### Path A: Godot
  139. New Godot project, or an existing one that needs a **Godot 4.7+** standards check - install the Godot hub **or** one Godot Domain Skill:
  140. ```bash
  141. npx skills add thedivergentai/Game-Dev-Agentic-Skills/skills/godot-master
  142. # or one Domain Skill:
  143. npx skills add thedivergentai/Game-Dev-Agentic-Skills/skills/godot-characterbody-2d
  144. ```
  145. ### Path B: Bevy
  146. Bevy work starts at the Bevy hub **or** one Bevy Domain Skill:
  147. ```bash
  148. npx skills add thedivergentai/Game-Dev-Agentic-Skills/skills/bevy-master
  149. # or one Domain Skill:
  150. npx skills add thedivergentai/Game-Dev-Agentic-Skills/skills/bevy-ecs-composition
  151. ```
  152. ### Path C: One specialist skill
  153. Need a single feature and already know which skill owns it - install only that path (either engine):
  154. ```bash
  155. npx skills add thedivergentai/Game-Dev-Agentic-Skills/skills/godot-inventory-system
  156. npx skills add thedivergentai/Game-Dev-Agentic-Skills/skills/bevy-inventory-system
  157. ```
  158. > [!DANGER]
  159. > **NEVER** use the `--all` flag when installing this repository (e.g., `npx skills add ... --all`). That is an **"Instant No-No"** — it forces your agent to load every metadata entry across **184** skills and triggers an unrecoverable Context Storm.
  160. ---
  161. ## 🧭 Agent Installation Rubric
  162. Use this when installing via the [skills CLI](https://github.com/vercel-labs/skills), or when an agent is reading this README after a **repo clone** (DIA path) instead of a normal plugin install.
  163. | Agent | `-a` flag | Project path | Global path |
  164. |:---|:---|:---|:---|
  165. | Cursor | `cursor` | `.agents/skills/` | `~/.cursor/skills/` |
  166. | Claude Code | `claude-code` | `.claude/skills/` | `~/.claude/skills/` |
  167. | Codex | `codex` | `.agents/skills/` | `~/.codex/skills/` |
  168. | Windsurf | `windsurf` | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
  169. | Gemini CLI | `gemini-cli` | `.agents/skills/` | `~/.gemini/skills/` |
  170. | GitHub Copilot | `github-copilot` | `.agents/skills/` | `~/.copilot/skills/` |
  171. | OpenCode | `opencode` | `.agents/skills/` | `~/.config/opencode/skills/` |
  172. **Rules**
  173. 1. **Preferred install**: one path only, for example `npx skills add thedivergentai/Game-Dev-Agentic-Skills/skills/godot-master -g -a <agent> -y` or `npx skills add thedivergentai/Game-Dev-Agentic-Skills/skills/bevy-master -g -a <agent> -y` (swap the skill path for a Domain Skill when needed).
  174. 2. **Verify**: `npx skills list -g -a <agent>`
  175. 3. **Restart** the host agent after install — most agents load skills once at session start.
  176. 4. **Clone / DIA path** (no `npx skills add`): query [`skills_index.json`](skills_index.json), then read `skills/<name>/SKILL.md` with the agent's file tool. Do **not** hand-symlink into host skill dirs unless the user asks for that.
  177. 5. **Canonical store**: `~/.agents/skills/` is the CLI's shared copy; per-agent discovery paths differ by design.
  178. ### Troubleshooting
  179. - Skill installed but missing in the agent → confirm with `npx skills list`, re-run with the correct `-a <agent>`, then restart the agent.
  180. - Do **not** treat a manual Claude-only symlink into `~/.claude/skills/` as the default fix — that only helps one host.
  181. ---
  182. ## 🧠 Context Management: Performance Guidelines
  183. To keep your AI agent fast and accurate, follow these "Expert Efficiency" rules:
  184. ### 1. The "Power of One" Rule
  185. Either use an engine **master** (`godot-master` / `bevy-master`) OR individual **Domain Skills** — never both masters plus a pile of Domain Skills.
  186. * **Godot Master** is an "Orchestrator" skill. It is dense (~15k tokens) but provides a complete blueprint. Use it when the "Big Picture" matters.
  187. * **Domain Skills** are "Surgical" skills (~2-5k tokens). They are fast, reliable, and keep the agent focused on one specific API.
  188. ### 2. Why "Install All" Fails
  189. Installing 184 skills simultaneously creates a **"Metadata Flood"**:
  190. - **Token Bleed**: ~15,000 tokens are "permanently" used just to tell the agent which skills exist.
  191. - **Instruction Conflicts**: Having multiple overlapping expert instructions (e.g., 20+ different genre blueprints) can cause the agent to lose its specific focus.
  192. - **Reasoning Lag**: The model has to sift through 100+ KB of text before deciding what to do.
  193. ### 3. Repository Clones vs. Plugin Installs
  194. - **Plugin Install (`npx skills add`)**: Copies/links the skill into your agent's skill directory (see [Agent Installation Rubric](#-agent-installation-rubric)). The agent can then discover it automatically. This is why installing too many at once causes a "Context Storm."
  195. - **Repository Clone**: If you merely clone this repo to a folder (e.g., `Downloads/GDSkills`), the agent will **NOT** auto-load skills unless you are working inside that directory. Use [`skills_index.json`](skills_index.json) + read each `SKILL.md` with the agent's file tool (DIA loop below).
  196. ---
  197. <div align="center">
  198. <img src="assets/engine_godot.webp" alt="Godot hub" width="100%" />
  199. </div>
  200. **[godot-master](skills/godot-master/SKILL.md)** is the hub for Godot 4.7+ projects. It orchestrates 99 Domain Skills, personas, workflows, and production scripts into one architectural framework. Install the hub or a single Domain Skill when you are shipping on Godot.
  201. <details>
  202. <summary><b>Explore Godot</b></summary>
  203. ## 🏆 Godot Master - Godot hub
  204. **[godot-master](skills/godot-master/SKILL.md)** is the Godot hub. It orchestrates the Godot Domain Skills into one architectural framework for Godot 4.7+ projects. It does not route Bevy work. Bevy starts at [bevy-master](skills/bevy-master/SKILL.md).
  205. ### 🎯 What Makes Godot Master Special?
  206. Unlike individual Domain Skills that focus on isolated features, **godot-master** is your *system architect*. It provides:
  207. **📚 Comprehensive Knowledge Base**
  208. - **100 Reference Documents**: Complete markdown guides for every skill, from foundations to advanced genres
  209. - **982 Unique Production Scripts**: Battle-tested, production-ready GDScript implementations
  210. - **11 Workflow Patterns**: Step-by-step architectural workflows (scaffolding, entity orchestration, persistence, optimization, multiplayer, Builder CLI scene builds, etc.)
  211. **🧠 Expert Frameworks**
  212. - **Architectural decision guide**: Choose the right pattern for your project (component-driven, event-driven, resource-streaming, deterministic networking)
  213. - **15 Anti-Patterns**: Explicit "NEVER DO THIS" rules with non-obvious explanations (e.g., why `get_tree().root.get_node()` breaks, why `load()` in `_process` kills performance)
  214. - **Performance Budgets**: Concrete numbers for mobile/desktop targets (draw calls, triangle counts, script time)
  215. - **Server API Patterns**: Expert escape hatch for 10K+ entities using RenderingServer/PhysicsServer RIDs
  216. **🏗️ The Layer Cake Architecture**
  217. Godot Master enforces a signal-based separation of concerns:
  218. ```mermaid
  219. graph TD
  220. UI[🎨 PRESENTATION<br/>UI / VFX / Audio] -->|Signals ⬆️| LOGIC[⚙️ LOGIC<br/>State Machines / Controllers]
  221. LOGIC -->|Signals ⬆️| DATA[💾 DATA<br/>Resources / .tres / Stats]
  222. DATA -->|Signals ⬆️| INFRA[🌐 INFRASTRUCTURE<br/>Autoloads / Signal Bus / Managers]
  223. style UI fill:#1f2937,stroke:#58A6FF,stroke-width:2px,color:#fff
  224. style LOGIC fill:#1f2937,stroke:#79C0FF,stroke-width:2px,color:#fff
  225. style DATA fill:#1f2937,stroke:#A371F7,stroke-width:2px,color:#fff
  226. style INFRA fill:#1f2937,stroke:#F778BA,stroke-width:2px,color:#fff
  227. ```
  228. **Critical Rule**: Signals travel UP only. Presentation layer never modifies Data directly. Infrastructure speaks exclusively through signals.
  229. ### 🔄 When to Use Godot Master vs Domain Skills
  230. ```mermaid
  231. flowchart LR
  232. START([New Task]) --> Q1{Starting a<br/>new project?}
  233. Q1 -->|Yes| MASTER[Use godot-master]
  234. Q1 -->|No| Q2{Need architectural<br/>guidance?}
  235. Q2 -->|Yes| MASTER
  236. Q2 -->|No| Q3{Building a<br/>complete system?}
  237. Q3 -->|Yes| MASTER
  238. Q3 -->|No| MICRO[Use Domain Skill:<br/>targeted implementation]
  239. MASTER --> DESC1[✓ Full workflow context<br/>✓ Decision frameworks<br/>✓ Anti-patterns<br/>✓ Performance budgets]
  240. MICRO --> DESC2[✓ Quick implementation<br/>✓ Focused feature<br/>✓ Standalone pattern]
  241. style START fill:#1f2937,stroke:#58A6FF,stroke-width:3px,color:#fff
  242. style MASTER fill:#0d1117,stroke:#58A6FF,stroke-width:3px,color:#79C0FF
  243. style MICRO fill:#0d1117,stroke:#A371F7,stroke-width:3px,color:#F778BA
  244. style DESC1 fill:#1f2937,stroke:#58A6FF,stroke-width:2px,color:#fff
  245. style DESC2 fill:#1f2937,stroke:#A371F7,stroke-width:2px,color:#fff
  246. ```
  247. **Use godot-master when:**
  248. - Starting a new Godot project from scratch
  249. - **Auditing an existing project** to find anti-patterns or standards violations
  250. - Designing game or application architecture
  251. - Building entity/component systems
  252. - Debugging performance or physics issues
  253. - Choosing between 2D/3D approaches
  254. - Implementing multiplayer
  255. - Optimizing draw calls or script time
  256. - Shipping the same design on more than one platform
  257. **Use Domain Skills when:**
  258. - Adding a specific feature to an existing codebase
  259. - Learning a targeted Godot API pattern
  260. - Implementing standalone functionality (UI component, particle effect, save system)
  261. ### 📖 Access Godot Master
  262. ```bash
  263. # Skill path
  264. skills/godot-master/SKILL.md
  265. # Contains
  266. ├── 91 reference markdown files (references/)
  267. ├── 185 production scripts (scripts/)
  268. └── Complete architectural decision trees
  269. ```
  270. ### GDAS-reader
  271. **[gdas-reader](skills/gdas-reader/SKILL.md)** reads a source tree, web bundle, asset folder, WASM module, or PE/ELF header into an evidence ledger. It is shared by the Godot and Bevy reconstruction skills and mirrored inside both hubs.
  272. ### Godot Domain Skills
  273. Godot Domain Skills are modular Godot 4.7+ modules. Install **[godot-master](skills/godot-master/SKILL.md)** or one skill below. 99 Domain Skills sit with the hub.
  274. <details>
  275. <summary><b>Architecture & Foundation (15 skills)</b></summary>
  276. - **[godot-analyst](skills/godot-analyst/SKILL.md)**: Anara - visionary scoring and certification for Godot 4.7+ architecture
  277. - **[godot-auditor](skills/godot-auditor/SKILL.md)**: Aurelius - never-list enforcement and architectural audit for Godot 4.7+
  278. - **[godot-autoload-architecture](skills/godot-autoload-architecture/SKILL.md)**: Singleton patterns, global state management, signal-based communication
  279. - **[godot-builder](skills/godot-builder/SKILL.md)**: Headless CLI scene scaffolding and build orchestration
  280. - **[godot-composition](skills/godot-composition/SKILL.md)**: Entity-Component architecture for scalable game systems (NPCs, weapons, actors)
  281. - **[godot-composition-apps](skills/godot-composition-apps/SKILL.md)**: Composition patterns for applications and tools (UI-focused)
  282. - **[godot-debugging-profiling](skills/godot-debugging-profiling/SKILL.md)**: Print debugging, breakpoints, profiler, memory leak detection
  283. - **[godot-gdscript-mastery](skills/godot-gdscript-mastery/SKILL.md)**: Static typing, signal architecture, unique nodes, style guide
  284. - **[godot-project-foundations](skills/godot-project-foundations/SKILL.md)**: Feature-driven folder structure, project scaffolding, conventions
  285. - **[godot-rea](skills/godot-rea/SKILL.md)**: Emit a Godot 4.7 stub project from a GDAS-reader ledger
  286. - **[godot-project-templates](skills/godot-project-templates/SKILL.md)**: Base `.gitignore`, export presets, input maps
  287. - **[godot-resource-data-patterns](skills/godot-resource-data-patterns/SKILL.md)**: `.tres` workflows, data-driven design, resource factories
  288. - **[godot-signal-architecture](skills/godot-signal-architecture/SKILL.md)**: Global vs scoped signal buses, signal-driven decoupling
  289. - **[godot-state-machine-advanced](skills/godot-state-machine-advanced/SKILL.md)**: Hierarchical FSMs, pushdown automata, state stacks, transition validation
  290. - **[godot-version-migration](skills/godot-version-migration/SKILL.md)**: Full-history engine upgrades (legacy eras → 3→4 → 4.x hops) with per-skill migration notes
  291. </details>
  292. <details>
  293. <summary><b>World, Rendering & Animation (18 skills)</b></summary>
  294. - **[godot-2d-animation](skills/godot-2d-animation/SKILL.md)**: `AnimatedSprite2D`, skeletal cutout rigs, procedural animation
  295. - **[godot-2d-physics](skills/godot-2d-physics/SKILL.md)**: Collision layers/masks, `Area2D` triggers, raycasting, `PhysicsDirectSpaceState2D`
  296. - **[godot-animation-player](skills/godot-animation-player/SKILL.md)**: Timeline animations, track types, root motion, RESET tracks
  297. - **[godot-animation-tree-mastery](skills/godot-animation-tree-mastery/SKILL.md)**: `AnimationTree`, `StateMachine`, `BlendSpace2D`, layered animations
  298. - **[godot-camera-systems](skills/godot-camera-systems/SKILL.md)**: Smooth following, camera shake, trauma system, deadzone logic
  299. - **[godot-characterbody-2d](skills/godot-characterbody-2d/SKILL.md)**: Platformer movement (coyote time, jump buffer), collision handling
  300. - **[godot-particles](skills/godot-particles/SKILL.md)**: `GPUParticles2D/3D` vs `CPUParticles`, visibility AABB, particle effects
  301. - **[godot-shaders-basics](skills/godot-shaders-basics/SKILL.md)**: `CanvasItem` shaders, post-processing, parameter animation
  302. - **[godot-tilemap-mastery](skills/godot-tilemap-mastery/SKILL.md)**: `TileMap`, autotiling, chunking, runtime modification
  303. - **[godot-tweening](skills/godot-tweening/SKILL.md)**: `Tween` API, juice/game feel, easing functions
  304. - **[godot-3d-lighting](skills/godot-3d-lighting/SKILL.md)**: `DirectionalLight3D`, shadow cascades, `VoxelGI` vs `SDFGI`, `LightmapGI`
  305. - **[godot-ai-navigation](skills/godot-ai-navigation/SKILL.md)**: Chase, patrol, and crowd choices on NavigationAgent / NavigationServer
  306. - **[godot-3d-materials](skills/godot-3d-materials/SKILL.md)**: `StandardMaterial3D`, PBR workflows, ORM textures, transparency modes
  307. - **[godot-3d-world-building](skills/godot-3d-world-building/SKILL.md)**: `GridMap`, `CSG` geometry, `WorldEnvironment`, volumetric fog
  308. - **[godot-navigation-pathfinding](skills/godot-navigation-pathfinding/SKILL.md)**: `NavigationAgent2D/3D`, RVO avoidance, async NavMesh baking
  309. - **[godot-physics-3d](skills/godot-physics-3d/SKILL.md)**: `CharacterBody3D`, `RigidBody3D`, ragdoll physics, collision shapes
  310. - **[godot-procedural-generation](skills/godot-procedural-generation/SKILL.md)**: `FastNoiseLite`, WFC (Wave Function Collapse), chunk loading
  311. - **[godot-raycasting-queries](skills/godot-raycasting-queries/SKILL.md)**: RayCast/ShapeCast, DirectSpaceState, hitscan, LOS, mouse picking
  312. </details>
  313. <details>
  314. <summary><b>Gameplay Mechanics (17 skills)</b></summary>
  315. - **[godot-ability-system](skills/godot-ability-system/SKILL.md)**: Cooldowns, skill trees, combo systems, upgrade paths
  316. - **[godot-combat-system](skills/godot-combat-system/SKILL.md)**: Hitbox/hurtbox architecture, damage calculation, invincibility frames
  317. - **[godot-dialogue-system](skills/godot-dialogue-system/SKILL.md)**: Branching dialogue, character portraits, typewriter effects, localization
  318. - **[godot-economy-system](skills/godot-economy-system/SKILL.md)**: Multi-currency, shop systems, dynamic pricing, loot tables
  319. - **[godot-game-loop-collection](skills/godot-game-loop-collection/SKILL.md)**: Scavenger hunt logic, volumetric spawning, collection tracking
  320. - **[godot-game-loop-harvest](skills/godot-game-loop-harvest/SKILL.md)**: Resource depletion, interactive gathering, drop calculation
  321. - **[godot-game-loop-time-trial](skills/godot-game-loop-time-trial/SKILL.md)**: Ghost recording, race logic, checkpoint-based timing
  322. - **[godot-game-loop-waves](skills/godot-game-loop-waves/SKILL.md)**: Wave-based spawning, difficulty scaling, round management
  323. - **[godot-inventory-system](skills/godot-inventory-system/SKILL.md)**: Slot-based containers, stacking logic, drag-drop UI
  324. - **[godot-mechanic-revival](skills/godot-mechanic-revival/SKILL.md)**: Souls-like mortality, corpse runs, revival charges, consequence tracking
  325. - **[godot-mechanic-secrets](skills/godot-mechanic-secrets/SKILL.md)**: Input sequence buffering (Konami code), interaction thresholds, secret persistence
  326. - **[godot-monte-carlo-balancer](skills/godot-monte-carlo-balancer/SKILL.md)**: Source-driven Monte Carlo balance lab, playstyle win-rate bands, economy careers, CI snapshots — co-authored by <a href="https://github.com/DedInc"><img src="https://wsrv.nl/?url=github.com/DedInc.png&w=48&h=48&mask=circle&fit=cover&maxage=1w" width="18" height="18" alt="@DedInc" /></a> [@DedInc](https://github.com/DedInc)
  327. - **[godot-quest-system](skills/godot-quest-system/SKILL.md)**: Quest graphs, prerequisites, state tracking
  328. - **[godot-rpg-stats](skills/godot-rpg-stats/SKILL.md)**: Stat modifiers, attribute scaling, damage formulas
  329. - **[godot-save-load-systems](skills/godot-save-load-systems/SKILL.md)**: Dictionary serialization, delta-save patterns, encryption
  330. - **[godot-scene-management](skills/godot-scene-management/SKILL.md)**: Async scene loading, transitions, pooling
  331. - **[godot-turn-system](skills/godot-turn-system/SKILL.md)**: Turn-based combat, active time battle (ATB), timeline management
  332. </details>
  333. <details>
  334. <summary><b>UI & UX (6 skills)</b></summary>
  335. - **[godot-agent-vision](skills/godot-agent-vision/SKILL.md)**: Agentic eyes — host screenshot CLI → WebP, TEMP editor bridge, structured anti-slop vision review
  336. - **[godot-input-handling](skills/godot-input-handling/SKILL.md)**: `InputMap`, controller support, rebinding, input buffering
  337. - **[godot-ui-containers](skills/godot-ui-containers/SKILL.md)**: Responsive layouts, anchor presets, margin containers
  338. - **[godot-ui-rich-text](skills/godot-ui-rich-text/SKILL.md)**: Expert blueprint for RichTextLabel with BBCode formatting (bold, italic, colors, images, clickable links) and custom effects. Covers meta tags, RichTextEffect shaders, and dynamic content. Use when implementing dialogue systems OR formatted text. Keywords RichTextLabel, BBCode, [b], [color], [url], meta_clicked, RichTextEffect, dialogue
  339. - **[godot-theme-easter](skills/godot-theme-easter/SKILL.md)**: Seasonal theming, runtime StyleBox duplication, juice components (wobble/bounce)
  340. - **[godot-ui-theming](skills/godot-ui-theming/SKILL.md)**: `.theme` resources, style inheritance, global skinning
  341. </details>
  342. <details>
  343. <summary><b>Platforms & Connectivity (11 skills)</b></summary>
  344. - **[godot-audio-systems](skills/godot-audio-systems/SKILL.md)**: `AudioBus` routing, positional audio, music crossfades, audio pooling
  345. - **[godot-export-builds](skills/godot-export-builds/SKILL.md)**: Multi-platform exports, CI/CD, codesigning, headless mode
  346. - **[godot-multiplayer-networking](skills/godot-multiplayer-networking/SKILL.md)**: `MultiplayerSynchronizer`, client prediction, server reconciliation
  347. - **[godot-performance-optimization](skills/godot-performance-optimization/SKILL.md)**: Profiling, draw call batching, `MultiMesh`, LOD systems
  348. - **[godot-platform-console](skills/godot-platform-console/SKILL.md)**: Console certification, controller compliance
  349. - **[godot-platform-desktop](skills/godot-platform-desktop/SKILL.md)**: Steam integration, window management, settings menus
  350. - **[godot-platform-mobile](skills/godot-platform-mobile/SKILL.md)**: Touch controls, safe areas, battery optimization
  351. - **[godot-platform-vr](skills/godot-platform-vr/SKILL.md)**: Expert blueprint for VR platforms (Meta Quest, PSVR, SteamVR, Pico) covering XR toolkit (OpenXR), comfort settings (vignetting, snap turning, teleport), motion controls, hand tracking, and 90+ FPS requirements. Use when targeting VR headsets or implementing immersive 3D experiences. Keywords VR, XR, OpenXR, Meta Quest, motion sickness, comfort, locomotion, XRController3D, foveated rendering
  352. - **[godot-platform-web](skills/godot-platform-web/SKILL.md)**: HTML5 exports, JavaScript bridge, browser limitations
  353. - **[godot-server-architecture](skills/godot-server-architecture/SKILL.md)**: Headless servers, authoritative networking, RID patterns
  354. - **[godot-testing-patterns](skills/godot-testing-patterns/SKILL.md)**: GUT framework, unit tests, integration tests, CI/CD testing
  355. </details>
  356. <details>
  357. <summary><b>Adaptation Guides (5 skills)</b></summary>
  358. - **[godot-adapt-2d-to-3d](skills/godot-adapt-2d-to-3d/SKILL.md)**: Dimension conversion, camera migration, sprite-to-model pipeline
  359. - **[godot-adapt-3d-to-2d](skills/godot-adapt-3d-to-2d/SKILL.md)**: Flattening 3D to 2D, orthogonal projection, performance gains
  360. - **[godot-adapt-desktop-to-mobile](skills/godot-adapt-desktop-to-mobile/SKILL.md)**: Touch controls, UI scaling, battery optimization
  361. - **[godot-adapt-mobile-to-desktop](skills/godot-adapt-mobile-to-desktop/SKILL.md)**: Mouse/keyboard, resolution scaling, Steam features
  362. - **[godot-adapt-single-to-multiplayer](skills/godot-adapt-single-to-multiplayer/SKILL.md)**: Client-server architecture, lag compensation, anti-cheat
  363. </details>
  364. <details>
  365. <summary><b>Genre Blueprints (27 skills)</b></summary>
  366. **Action & Combat**
  367. - **[godot-genre-action-rpg](skills/godot-genre-action-rpg/SKILL.md)**: Loot generation, skill trees, stat-based combat, equipment systems
  368. - **[godot-genre-fighting](skills/godot-genre-fighting/SKILL.md)**: Frame data, hitbox/hurtbox, motion inputs, rollback netcode
  369. - **[godot-genre-platformer](skills/godot-genre-platformer/SKILL.md)**: Coyote time, jump buffer, game feel polish, level design
  370. - **[godot-genre-shooter](skills/godot-genre-shooter/SKILL.md)**: Hitscan, recoil patterns, weapon archetypes, hit registration
  371. - **[godot-genre-shooter-fps](skills/godot-genre-shooter-fps/SKILL.md)**: FPS movement physics, camera sway, weapon bobbing, high-precision hit registration
  372. **Strategy & Tactics**
  373. - **[godot-genre-moba](skills/godot-genre-moba/SKILL.md)**: Lane management, tower aggro, fog of war, ability cooldowns
  374. - **[godot-genre-rts](skills/godot-genre-rts/SKILL.md)**: Unit selection, command queues, fog of war, pathfinding
  375. - **[godot-genre-tower-defense](skills/godot-genre-tower-defense/SKILL.md)**: Wave spawning, targeting priority, mazing mechanics
  376. **Exploration & Adventure**
  377. - **[godot-genre-metroidvania](skills/godot-genre-metroidvania/SKILL.md)**: Ability gating, interconnected worlds, map revelation
  378. - **[godot-genre-open-world](skills/godot-genre-open-world/SKILL.md)**: Chunk streaming, floating origin, HLOD, POI discovery
  379. - **[godot-genre-roguelike](skills/godot-genre-roguelike/SKILL.md)**: Procedural generation, permadeath, meta-progression, seeded RNG
  380. - **[godot-genre-survival](skills/godot-genre-survival/SKILL.md)**: Needs systems, crafting recipes, base building, resource gathering
  381. **Narrative & Puzzle**
  382. - **[godot-genre-card-game](skills/godot-genre-card-game/SKILL.md)**: Deck management, effect resolution, hand layouts, Command pattern
  383. - **[godot-genre-educational](skills/godot-genre-educational/SKILL.md)**: Adaptive difficulty, spaced repetition, mastery tracking
  384. - **[godot-genre-horror](skills/godot-genre-horror/SKILL.md)**: Tension pacing, Director AI, sanity systems, sensory perception
  385. - **[godot-genre-puzzle](skills/godot-genre-puzzle/SKILL.md)**: Undo systems, grid logic, non-verbal tutorials
  386. - **[godot-genre-visual-novel](skills/godot-genre-visual-novel/SKILL.md)**: Branching narratives, rollback, typewriter effects
  387. - **[godot-genre-romance](skills/godot-genre-romance/SKILL.md)**: Relationship tracking, affection systems, dating mechanics
  388. **Simulation & Social**
  389. - **[godot-genre-battle-royale](skills/godot-genre-battle-royale/SKILL.md)**: Shrinking zones, deployment systems, relevancy networking
  390. - **[godot-genre-idle-clicker](skills/godot-genre-idle-clicker/SKILL.md)**: Big number handling, exponential growth, prestige systems
  391. - **[godot-genre-party](skills/godot-genre-party/SKILL.md)**: Minigame collections, local multiplayer, split-screen
  392. - **[godot-genre-racing](skills/godot-genre-racing/SKILL.md)**: Vehicle physics, checkpoint systems, rubber-banding AI
  393. - **[godot-genre-rhythm](skills/godot-genre-rhythm/SKILL.md)**: BPM conductors, timing judgments, latency compensation
  394. - **[godot-genre-sandbox](skills/godot-genre-sandbox/SKILL.md)**: Voxel systems, cellular automata, emergent gameplay
  395. - **[godot-genre-simulation](skills/godot-genre-simulation/SKILL.md)**: Economy systems, time progression, feedback loops
  396. - **[godot-genre-sports](skills/godot-genre-sports/SKILL.md)**: Ball physics, team AI, formation systems
  397. - **[godot-genre-stealth](skills/godot-genre-stealth/SKILL.md)**: Vision cones, alert states, sound propagation, gradual detection
  398. </details>
  399. </details>
  400. <div align="center">
  401. <img src="assets/engine_bevy.webp" alt="Bevy hub" width="100%" />
  402. </div>
  403. **[bevy-master](skills/bevy-master/SKILL.md)** is the hub for Bevy 0.20+ apps. It orchestrates 82 Domain Skills covering ECS ownership, rendering, gameplay, UI, platforms, and genres into one architectural framework. Install the hub or a single Domain Skill when you are shipping on Bevy.
  404. <details>
  405. <summary><b>Explore Bevy</b></summary>
  406. ## 🏆 Bevy Master - Bevy hub
  407. **[bevy-master](skills/bevy-master/SKILL.md)** is the Bevy hub. It orchestrates the Bevy Domain Skills into one architectural framework for Bevy 0.20+ apps. It does not route Godot work. Godot starts at [godot-master](skills/godot-master/SKILL.md).
  408. ### 🎯 What Makes Bevy Master Special?
  409. Unlike individual Domain Skills that focus on isolated features, **bevy-master** is your *system architect*. It provides:
  410. **Comprehensive knowledge base**
  411. - **Hub plus 82 Domain Skills**: composition, rendering, gameplay, UI, platforms, adaptation, and genre skills
  412. - **ECS ownership**: every piece of state names a component or resource, a system that may mutate it, and the message or observer that should see it
  413. - **Schedule literacy**: app setup, plugins, states, and the order systems actually run
  414. **Expert frameworks**
  415. - **Architectural decision guide**: component vs resource vs plain struct, app state vs per-entity mode, messages vs observers
  416. - **Anti-patterns**: Godot types inside a Bevy crate, an entity spawned for every config value, systems that mutate data they do not own
  417. - **Plugin boundaries**: features live in plugins; the hub tells you which Domain Skill to open next
  418. - **Data rules**: data that is not simulated stays a resource or a plain Rust struct
  419. **The schedule architecture**
  420. Bevy Master enforces ownership along the schedule, not a scene tree:
  421. ```mermaid
  422. graph TD
  423. APP[APP SETUP<br/>App / plugins / states] --> ECS[COMPONENTS / RESOURCES / SYSTEMS]
  424. PLUG[PLUGINS AND STATES] --> APP
  425. ECS --> DOMAIN[DOMAIN BEVY SKILLS<br/>one feature at a time]
  426. style APP fill:#1f2937,stroke:#58A6FF,stroke-width:2px,color:#fff
  427. style PLUG fill:#1f2937,stroke:#79C0FF,stroke-width:2px,color:#fff
  428. style ECS fill:#1f2937,stroke:#A371F7,stroke-width:2px,color:#fff
  429. style DOMAIN fill:#1f2937,stroke:#F778BA,stroke-width:2px,color:#fff
  430. ```
  431. **Critical rule**: Name the owner before you write the system. A system reads and writes only the data it owns.
  432. ### 🔄 When to Use Bevy Master vs Domain Skills
  433. ```mermaid
  434. flowchart LR
  435. START([New Task]) --> Q1{Starting a<br/>new app?}
  436. Q1 -->|Yes| MASTER[Use bevy-master]
  437. Q1 -->|No| Q2{Need ECS<br/>boundaries?}
  438. Q2 -->|Yes| MASTER
  439. Q2 -->|No| Q3{Building a<br/>complete system?}
  440. Q3 -->|Yes| MASTER
  441. Q3 -->|No| MICRO[Use Domain Skill:<br/>targeted implementation]
  442. MASTER --> DESC1[Full schedule context<br/>Decision frameworks<br/>Ownership rules<br/>Which skill next]
  443. MICRO --> DESC2[Quick implementation<br/>Focused feature<br/>Standalone pattern]
  444. style START fill:#1f2937,stroke:#58A6FF,stroke-width:3px,color:#fff
  445. style MASTER fill:#0d1117,stroke:#58A6FF,stroke-width:3px,color:#79C0FF
  446. style MICRO fill:#0d1117,stroke:#A371F7,stroke-width:3px,color:#F778BA
  447. style DESC1 fill:#1f2937,stroke:#58A6FF,stroke-width:2px,color:#fff
  448. style DESC2 fill:#1f2937,stroke:#A371F7,stroke-width:2px,color:#fff
  449. ```
  450. **Use bevy-master when:**
  451. - Starting a new Bevy app from scratch
  452. - **Auditing an existing app** for ownership mistakes or schedule sprawl
  453. - Designing ECS architecture
  454. - Choosing component vs resource vs schedule
  455. - Deciding messages vs observers
  456. - Choosing which Domain Skill to open next
  457. - Implementing gameplay that spans several systems
  458. - Checking that a task belongs on the Bevy side of the library
  459. - Wiring plugins, states, and feature folders
  460. **Use Domain Skills when:**
  461. - Adding a specific feature to an existing crate
  462. - Learning a targeted Bevy pattern
  463. - Implementing standalone functionality (movement, inventory, UI layout, a genre loop)
  464. ### 📖 Access Bevy Master
  465. ```bash
  466. # Skill path
  467. skills/bevy-master/SKILL.md
  468. # Install
  469. npx skills add thedivergentai/Game-Dev-Agentic-Skills/skills/bevy-master
  470. ```
  471. **Routing table**
  472. | Scenario | Route |
  473. | --- | --- |
  474. | New Bevy app, ECS boundaries, which skill to load | [bevy-master](skills/bevy-master/SKILL.md) |
  475. | Crate, Cargo features, feature folders | [bevy-project-foundations](skills/bevy-project-foundations/SKILL.md) |
  476. | Entity composition, components, systems | [bevy-ecs-composition](skills/bevy-ecs-composition/SKILL.md) |
  477. | Messages and observers | [bevy-events-messaging](skills/bevy-events-messaging/SKILL.md) |
  478. | Components and resources as data | [bevy-data-resources](skills/bevy-data-resources/SKILL.md) |
  479. | App states or a per-entity mode flag | [bevy-state-machines](skills/bevy-state-machines/SKILL.md) |
  480. | App-wide resources and schedules | [bevy-app-resources](skills/bevy-app-resources/SKILL.md) |
  481. | Character movement | [bevy-character-movement](skills/bevy-character-movement/SKILL.md) |
  482. | 3D physics / 2D physics | [bevy-physics-3d](skills/bevy-physics-3d/SKILL.md) / [bevy-physics-2d](skills/bevy-physics-2d/SKILL.md) |
  483. | Keyboard, mouse, gamepad | [bevy-input-handling](skills/bevy-input-handling/SKILL.md) |
  484. | Camera, audio, assets, save | [bevy-camera-systems](skills/bevy-camera-systems/SKILL.md), [bevy-audio-systems](skills/bevy-audio-systems/SKILL.md), [bevy-asset-scenes](skills/bevy-asset-scenes/SKILL.md), [bevy-save-load](skills/bevy-save-load/SKILL.md) |
  485. | Clips, lights, materials, UI, or a genre loop | Matching Domain Skill in [Bevy Domain Skills](#bevy-domain-skills) |
  486. | Godot language, version hops, CLI, or project audit | [godot-master](skills/godot-master/SKILL.md) |
  487. Data that is not simulated can stay a plain Rust struct or a resource. Do not spawn an entity for every config value.
  488. ### Bevy Domain Skills
  489. Bevy Domain Skills are modular Bevy 0.20+ modules. Install **[bevy-master](skills/bevy-master/SKILL.md)** or one skill below. 82 Domain Skills sit with the hub. Schedules replace a scene tree: name the component, the resource, and the system.
  490. <details>
  491. <summary><b>Architecture & Foundation (12 skills)</b></summary>
  492. - **[bevy-project-foundations](skills/bevy-project-foundations/SKILL.md)**: Cargo crate layout, features, and folder habits
  493. - **[bevy-rea](skills/bevy-rea/SKILL.md)**: Emit a Bevy 0.20 stub crate from a GDAS-reader ledger
  494. - **[bevy-project-templates](skills/bevy-project-templates/SKILL.md)**: Template starting points for 2D and 3D apps
  495. - **[bevy-ecs-composition](skills/bevy-ecs-composition/SKILL.md)**: Components, `Query`, `Commands`, `Startup` / `Update`, `.chain()`
  496. - **[bevy-events-messaging](skills/bevy-events-messaging/SKILL.md)**: Messages and observers as an ownership slot
  497. - **[bevy-data-resources](skills/bevy-data-resources/SKILL.md)**: `Component` versus `Resource` as data
  498. - **[bevy-state-machines](skills/bevy-state-machines/SKILL.md)**: App states and per-entity mode flags
  499. - **[bevy-app-resources](skills/bevy-app-resources/SKILL.md)**: App-wide resources and plugin boundaries
  500. - **[bevy-save-load](skills/bevy-save-load/SKILL.md)**: Save-slot boundaries (scene spawn is not a save)
  501. - **[bevy-debugging-profiling](skills/bevy-debugging-profiling/SKILL.md)**: Logs and frame diagnostics
  502. - **[bevy-performance](skills/bevy-performance/SKILL.md)**: Parallel systems, fixed step, handle lifetimes
  503. - **[bevy-testing-patterns](skills/bevy-testing-patterns/SKILL.md)**: `cargo test` around Bevy apps
  504. </details>
  505. <details>
  506. <summary><b>World, Rendering & Animation (11 skills)</b></summary>
  507. - **[bevy-2d-animation](skills/bevy-2d-animation/SKILL.md)**: Sprite clip playback
  508. - **[bevy-animation](skills/bevy-animation/SKILL.md)**: Animation clips and players
  509. - **[bevy-animation-graph](skills/bevy-animation-graph/SKILL.md)**: Blend graphs
  510. - **[bevy-particles](skills/bevy-particles/SKILL.md)**: Particle and VFX entities
  511. - **[bevy-shaders](skills/bevy-shaders/SKILL.md)**: Materials and shaders
  512. - **[bevy-tilemap](skills/bevy-tilemap/SKILL.md)**: Tile map entities
  513. - **[bevy-tweening](skills/bevy-tweening/SKILL.md)**: Curves and juice
  514. - **[bevy-camera-systems](skills/bevy-camera-systems/SKILL.md)**: `Camera2d` and `Camera3d`
  515. - **[bevy-3d-lighting](skills/bevy-3d-lighting/SKILL.md)**: Directional, point, and spot lights
  516. - **[bevy-3d-materials](skills/bevy-3d-materials/SKILL.md)**: PBR materials
  517. - **[bevy-3d-world-building](skills/bevy-3d-world-building/SKILL.md)**: Mesh and scene assembly for levels
  518. </details>
  519. <details>
  520. <summary><b>Gameplay Mechanics (24 skills)</b></summary>
  521. - **[bevy-character-movement](skills/bevy-character-movement/SKILL.md)**: Locomotion on `Fixed` / `FixedMain`
  522. - **[bevy-physics-2d](skills/bevy-physics-2d/SKILL.md)**: 2D physics ownership
  523. - **[bevy-physics-3d](skills/bevy-physics-3d/SKILL.md)**: 3D physics ownership
  524. - **[bevy-spatial-queries](skills/bevy-spatial-queries/SKILL.md)**: Rays, overlaps, and picks
  525. - **[bevy-navigation](skills/bevy-navigation/SKILL.md)**: Path data
  526. - **[bevy-ai-navigation](skills/bevy-ai-navigation/SKILL.md)**: Chase, patrol, and retarget policy
  527. - **[bevy-procedural-generation](skills/bevy-procedural-generation/SKILL.md)**: Seeded layout and spawn
  528. - **[bevy-input-handling](skills/bevy-input-handling/SKILL.md)**: Keyboard, mouse, and gamepad
  529. - **[bevy-audio-systems](skills/bevy-audio-systems/SKILL.md)**: Play and control clips
  530. - **[bevy-asset-scenes](skills/bevy-asset-scenes/SKILL.md)**: Asset loading and scene spawn
  531. - **[bevy-ability-system](skills/bevy-ability-system/SKILL.md)**: Cooldowns and ability entities
  532. - **[bevy-combat-system](skills/bevy-combat-system/SKILL.md)**: Hits, damage, and health
  533. - **[bevy-dialogue-system](skills/bevy-dialogue-system/SKILL.md)**: Dialogue lines as data
  534. - **[bevy-economy-system](skills/bevy-economy-system/SKILL.md)**: Currency and prices
  535. - **[bevy-inventory-system](skills/bevy-inventory-system/SKILL.md)**: Stacks and item entities
  536. - **[bevy-mechanic-revival](skills/bevy-mechanic-revival/SKILL.md)**: Downed state and revival
  537. - **[bevy-mechanic-secrets](skills/bevy-mechanic-secrets/SKILL.md)**: Discovery flags
  538. - **[bevy-quest-system](skills/bevy-quest-system/SKILL.md)**: Objectives and quest state
  539. - **[bevy-rpg-stats](skills/bevy-rpg-stats/SKILL.md)**: Attributes and modifiers
  540. - **[bevy-turn-system](skills/bevy-turn-system/SKILL.md)**: Initiative and rounds
  541. - **[bevy-game-loop-collection](skills/bevy-game-loop-collection/SKILL.md)**: Pickups and collection tracking
  542. - **[bevy-game-loop-harvest](skills/bevy-game-loop-harvest/SKILL.md)**: Gathering and depletion
  543. - **[bevy-game-loop-time-trial](skills/bevy-game-loop-time-trial/SKILL.md)**: Timers and splits
  544. - **[bevy-game-loop-waves](skills/bevy-game-loop-waves/SKILL.md)**: Encounter waves and spawns
  545. </details>
  546. <details>
  547. <summary><b>UI & UX (3 skills)</b></summary>
  548. - **[bevy-ui-layout](skills/bevy-ui-layout/SKILL.md)**: Flex layout, nodes, and buttons
  549. - **[bevy-ui-text](skills/bevy-ui-text/SKILL.md)**: UI and world text
  550. - **[bevy-ui-theming](skills/bevy-ui-theming/SKILL.md)**: Colors, borders, and theme tokens
  551. </details>
  552. <details>
  553. <summary><b>Platforms & Connectivity (3 skills)</b></summary>
  554. - **[bevy-platform-desktop](skills/bevy-platform-desktop/SKILL.md)**: Desktop windows
  555. - **[bevy-platform-web](skills/bevy-platform-web/SKILL.md)**: Wasm and browser targets
  556. - **[bevy-platform-mobile](skills/bevy-platform-mobile/SKILL.md)**: Touch and mobile targets
  557. </details>
  558. <details>
  559. <summary><b>Adaptation Guides (4 skills)</b></summary>
  560. - **[bevy-adapt-2d-to-3d](skills/bevy-adapt-2d-to-3d/SKILL.md)**: Move a Bevy game from 2D to 3D
  561. - **[bevy-adapt-3d-to-2d](skills/bevy-adapt-3d-to-2d/SKILL.md)**: Flatten a Bevy game from 3D to 2D
  562. - **[bevy-adapt-desktop-to-mobile](skills/bevy-adapt-desktop-to-mobile/SKILL.md)**: Desktop to touch and mobile
  563. - **[bevy-adapt-mobile-to-desktop](skills/bevy-adapt-mobile-to-desktop/SKILL.md)**: Mobile to mouse, keyboard, and desktop
  564. </details>
  565. <details>
  566. <summary><b>Genre Blueprints (25 skills)</b></summary>
  567. **Action & Combat**
  568. - **[bevy-genre-action-rpg](skills/bevy-genre-action-rpg/SKILL.md)**: Action RPG loop
  569. - **[bevy-genre-fighting](skills/bevy-genre-fighting/SKILL.md)**: Fighting loop
  570. - **[bevy-genre-platformer](skills/bevy-genre-platformer/SKILL.md)**: Platformer loop
  571. - **[bevy-genre-shooter](skills/bevy-genre-shooter/SKILL.md)**: Shooter loop
  572. - **[bevy-genre-shooter-fps](skills/bevy-genre-shooter-fps/SKILL.md)**: FPS shooter loop
  573. **Strategy & Tactics**
  574. - **[bevy-genre-rts](skills/bevy-genre-rts/SKILL.md)**: RTS loop
  575. - **[bevy-genre-tower-defense](skills/bevy-genre-tower-defense/SKILL.md)**: Tower defense loop
  576. **Exploration & Adventure**
  577. - **[bevy-genre-metroidvania](skills/bevy-genre-metroidvania/SKILL.md)**: Metroidvania loop
  578. - **[bevy-genre-open-world](skills/bevy-genre-open-world/SKILL.md)**: Open world loop
  579. - **[bevy-genre-roguelike](skills/bevy-genre-roguelike/SKILL.md)**: Roguelike loop
  580. - **[bevy-genre-survival](skills/bevy-genre-survival/SKILL.md)**: Survival loop
  581. **Narrative & Puzzle**
  582. - **[bevy-genre-card-game](skills/bevy-genre-card-game/SKILL.md)**: Card game loop
  583. - **[bevy-genre-educational](skills/bevy-genre-educational/SKILL.md)**: Educational loop
  584. - **[bevy-genre-horror](skills/bevy-genre-horror/SKILL.md)**: Horror loop
  585. - **[bevy-genre-puzzle](skills/bevy-genre-puzzle/SKILL.md)**: Puzzle loop
  586. - **[bevy-genre-visual-novel](skills/bevy-genre-visual-novel/SKILL.md)**: Visual novel loop
  587. - **[bevy-genre-romance](skills/bevy-genre-romance/SKILL.md)**: Romance loop
  588. **Simulation & Social**
  589. - **[bevy-genre-idle-clicker](skills/bevy-genre-idle-clicker/SKILL.md)**: Idle / clicker loop
  590. - **[bevy-genre-party](skills/bevy-genre-party/SKILL.md)**: Party / minigame loop
  591. - **[bevy-genre-racing](skills/bevy-genre-racing/SKILL.md)**: Racing loop
  592. - **[bevy-genre-rhythm](skills/bevy-genre-rhythm/SKILL.md)**: Rhythm loop
  593. - **[bevy-genre-sandbox](skills/bevy-genre-sandbox/SKILL.md)**: Sandbox loop
  594. - **[bevy-genre-simulation](skills/bevy-genre-simulation/SKILL.md)**: Simulation loop
  595. - **[bevy-genre-sports](skills/bevy-genre-sports/SKILL.md)**: Sports loop
  596. - **[bevy-genre-stealth](skills/bevy-genre-stealth/SKILL.md)**: Stealth loop
  597. </details>
  598. </details>
  599. ### 📂 Full Skill Index
  600. All skills are catalogued in the machine-readable [`skills_index.json`](skills_index.json) with keywords, descriptions, and dependency chains.
  601. > [!NOTE]
  602. > This JSON index is a repository-level file and is only present if you have cloned the source repository.
  603. ---
  604. ## 🤖 For Agents — The Discovery-Ingestion-Application Protocol
  605. AI agents must follow the **DIA loop** for maximum quality:
  606. ### 1. Discovery
  607. Query [`skills_index.json`](skills_index.json) and pick the **engine** first.
  608. **Godot example**: "smooth character movement" -> `godot-characterbody-2d`, then `godot-master` if the project needs architecture.
  609. **Bevy example**: "ECS player movement" -> `bevy-character-movement`, then `bevy-master` if ownership and schedules are still open.
  610. ### 2. Ingestion
  611. Agents must not implement from general training data alone.
  612. Read the chosen `SKILL.md` with the file tool. Godot skills carry Godot 4.7+ nuances (`StringName` lookups, signal direction). Bevy skills carry ECS ownership (`Component`, `Resource`, `Query`, `Commands`, `.chain()`, `Fixed` / `FixedMain`).
  613. **Complex Godot projects**: load `godot-master`.
  614. **Complex Bevy projects**: load `bevy-master`.
  615. Do not load both hubs for one task.
  616. ### 3. Application
  617. Follow the skill chain in the skill header. Apply patterns from the deepest dependency upward, staying inside the same engine.
  618. **Godot workflow**:
  619. ```
  620. User: "Build a player controller" (Godot)
  621. Agent: Query skills_index.json -> godot-characterbody-2d
  622. Agent: Read dependencies (godot-composition, godot-state-machine-advanced) first
  623. Agent: Implement movement on top of those patterns
  624. ```
  625. **Bevy workflow**:
  626. ```
  627. User: "Build a player controller" (Bevy)
  628. Agent: Query skills_index.json -> bevy-character-movement
  629. Agent: Read bevy-master if component vs resource is unclear
  630. Agent: Implement locomotion on Fixed / FixedMain
  631. ```
  632. ### Anti-Erosion Policy
  633. Documentation stays in sync with implementation. When a Godot 4 or Bevy 0.20 API changes, update the relevant `SKILL.md`.
  634. ---
  635. ## 🏗️ Infrastructure Integration
  636. ### Godot programmatic building (`godot-builder`)
  637. Godot scene scaffolding and headless automation go through **[godot-builder](skills/godot-builder/SKILL.md)** (also mirrored in `godot-master` Workflow 11). Use Godot CLI scripts such as `create_scene.py`, `add_node.py`, and `run_project.py`.
  638. Bevy apps scaffold through Cargo and **[bevy-project-foundations](skills/bevy-project-foundations/SKILL.md)** (`App::new()`, `DefaultPlugins` / `MinimalPlugins`). Do not point Bevy tasks at godot-builder.
  639. ### Project standards
  640. **Godot** code follows **Godot 4.7+** conventions:
  641. - Static typing: `func move(vec: Vector2) -> void:`
  642. - `Signal` / `Callable` / `Tween` (Godot 4 syntax)
  643. - `StringName` for performance-critical lookups
  644. - Component composition over deep inheritance
  645. ---
  646. ## 🤝 Contributing
  647. We welcome contributions from developers and agents!
  648. 📖 **Read the full contribution guide**: [CONTRIBUTING.md](CONTRIBUTING.md)
  649. **Quick Guidelines**:
  650. - Every skill must provide **Expert Knowledge Delta** (not tutorials)
  651. - Include anti-patterns with non-obvious explanations
  652. - Godot skills: Godot 4.7+ GDScript, statically typed, scripts parse without warnings
  653. - Bevy skills: Bevy 0.20+ Rust, ECS ownership explicit, no Godot types in Bevy crates
  654. **Submit**: Open an issue with `[Request]` tag or submit a PR describing the knowledge delta your skill adds.
  655. ---
  656. ## ⭐ Star History
  657. If this project accelerates your Godot or Bevy work, or empowers your AI agents, consider starring the repository!
  658. <div align="center">
  659. <a href="https://github.com/thedivergentai/Game-Dev-Agentic-Skills/stargazers">
  660. <picture>
  661. <source media="(prefers-color-scheme: dark)" srcset="https://thedivergentai.github.io/Game-Dev-Agentic-Skills/star-history-dark.svg" />
  662. <source media="(prefers-color-scheme: light)" srcset="https://thedivergentai.github.io/Game-Dev-Agentic-Skills/star-history-light.svg" />
  663. <img alt="GDAS Star History Chart" src="https://thedivergentai.github.io/Game-Dev-Agentic-Skills/star-history-dark.svg" width="100%" />
  664. </picture>
  665. </a>
  666. </div>
  667. ---
  668. ## 📊 Repository Stats
  669. | Metric | Value |
  670. |:---|:---|
  671. | **Total Skills** | 184 |
  672. | **Godot skills** | 100 (godot-master + 99 Domain Skills) |
  673. | **Bevy skills** | 83 (bevy-master + 82 Domain Skills) |
  674. | **Godot genre blueprints** | 27 |
  675. | **Bevy genre skills** | 25 |
  676. | **Godot production scripts** | 982 |
  677. | **Godot reference documents** | 99 |
  678. | **Target engines** | Godot 4.7+ and Bevy 0.20+ |
  679. | **License** | LGPLv3 |
  680. ---
  681. ## 💖 Sponsorship & Support
  682. We are seeking **financial sponsors and infrastructure partners** to sustain Game Dev Agentic Skills across Godot and Bevy. Every contribution helps us maintain these skills and keep them free for the community.
  683. 🚀 **View our [Sponsorship & Support Opportunities](PARTNERS.md)**
  684. **Get in Touch**: [sponsor@thedivergentai.com](mailto:sponsor+github@thedivergentai.com)
  685. ---
  686. ## 📜 License
  687. This project is licensed under the **GNU Lesser General Public License v3.0** - see [LICENSE](LICENSE) for details.
  688. **Why LGPLv3?**
  689. We chose this license because it strikes the perfect balance for an open ecosystem. It ensures that any improvements or additions made directly to the GDSkills library itself remain open-source and shared with the community. At the same time, it empowers you to use these agentic skills to build and compile your own incredible games, which you are completely free to commercialize and keep closed-source if you wish.
  690. **By contributing**, you agree that your code will be licensed under the project's LGPLv3 License.
  691. ---
  692. <div align="center">
  693. <a href="https://github.com/thedivergentai"><img src="https://wsrv.nl/?url=github.com/thedivergentai.png&w=96&h=96&mask=circle&fit=cover&maxage=1w" width="36" height="36" alt="Divergent AI" /></a>
  694. &nbsp;**Authored by [Divergent AI](https://github.com/thedivergentai)**
  695. **Maintained by the Agents**
  696. ---
  697. > [!IMPORTANT]
  698. > **Anti-Erosion Policy**: Documentation stays in sync with implementation. When a Godot 4 or Bevy 0.20 API changes, update the relevant `SKILL.md`.
  699. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.