Library / SDK
thedivergentai/GD-Agentic-Skills avatar
thedivergentai/GD-Agentic-Skills

GD Agentic Skills: A Skill Library for Godot 4 AI Agents

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.

721 stars43 forksGDScriptLGPL-3.0

At a glance

What is it?
GD Agentic Skills is a curated GDScript library of 99 expert skills and 27 genre blueprints that gives AI coding agents structured, best-practice knowledge of Godot 4.7+. It is aimed at game developers who use AI assistants and want those assistants to produce idiomatic Godot code rather than generic output.
Who is it for?
GD Agentic Skills is a practical fit for Godot 4.7+ developers who use AI coding assistants and want agent outputs that follow official Godot documentation patterns. It is not a runtime plugin; nothing in this library loads into a game's Autoload system.
Can I use it commercially?
Yes, with conditions. LGPL-3.0 is a weak copyleft licence: you can use it inside commercial and closed-source software, but if you distribute changes to its own files, you must publish those changes under the same licence.
Is it still maintained?
Yes. The repository last received commits 21 days ago.
What is it written in?
Mainly GDScript, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on September 17, 2026, and from our analysis. They are not legal advice.

Editorial analysis

What GD Agentic Skills Is Built For

GD Agentic Skills is not a game library you import into a project. It is a collection of structured knowledge files that AI coding agents read before writing or reviewing Godot code. The premise is that an AI agent without Godot-specific context will produce code that violates engine patterns or uses deprecated APIs. Each skill file is a self-contained reference covering one domain of the engine, derived from the official Godot documentation.

The description calls it "long-term memory" for Godot 4.7+ agents. Each SKILL.md file carries the current API patterns for its domain, migration notes for users moving between engine versions, and a reference lattice pointing to the official docs.godotengine.org pages that the patterns came from. That lattice lets an agent research further without guessing.

Repository Layout and the Skills Index

The skills/ directory holds the domain skill files. The top-level skills_index.json is a machine-readable index of all 99 skills, structured for programmatic access by agents and tooling. The repository also includes a skills.sh registry badge, which suggests it is registered with an external skill distribution service. The scripts/ directory contains update_skills_index.py for maintaining that index.

For each domain skill, the README describes a pattern of four files: the SKILL.md body with current API patterns, a references/migration-notes.md for engine-version deltas, Official Documentation lattice links (docs.godotengine.org/en/stable/...), and Related Skills metadata listing prerequisites, complements, and downstream skills. The 27 genre blueprints cover full-game starting points organized by game genre. The separation between domain skills (99 focused topics) and genre blueprints (27 broader patterns) lets a developer pull in just the domains relevant to their current task.

The repository root includes AGENT.md, SOUL.md, and IDENTITY.md files. These are not game files; they define the agent's operational rules and identity for AI tools that read repository-level context files.

The Three Personas: Analyst, Auditor, and Builder

The library introduces three automated personas to organize how an agent approaches a task. The Analyst (named Anara) examines a problem and identifies the relevant Godot patterns and domain skills to apply. The Auditor (named Aurelius) reviews code against official standards and scores it on a production rubric. The Builder persona generates code using the patterns the Analyst identified.

This three-step structure separates analysis from generation from review, which the README describes as reducing the chance that an agent produces code without first reading the relevant skill. Starting from v0.0.8 onward, all three personas were updated for Godot 4.7 scoring and GODOT_PATH CLI overrides.

The godot-master skill acts as a routing hub. For engine-version-specific work, it directs agents to godot-version-migration rather than embedding migration logic inline. That routing pattern keeps individual skills focused and avoids duplicating migration guidance across dozens of files.

Agent Vision and the Version Migration Skill

Two skills stand out for their specific mechanisms. The godot-agent-vision skill (added in v0.0.11) gives agents the ability to capture GUI elements, assets, and editor viewports to budgeted WebP files, then score what they see against a production rubric that includes typography weighting and anti-slop criteria. The README describes this as giving agents "eyes" so they can verify that generated UI matches design intent, not just that the code compiles. The capture tool runs outside the game via a host CLI (Windows, macOS, Linux) under a .gdskills/ directory, not as an in-game Autoload.

The godot-version-migration skill (added in v0.0.10) handles full-history engine upgrades from early Godot versions through Godot 4.7. It tracks legacy eras, the official 3-to-4 migration path, and hop-by-hop 4.x deltas. Every domain skill ships its own migration-notes.md that documents what changed in its API without mixing migration history into the current API body.

Creation Station: LoRA-Based Asset Generation

The v0.1.0 update added godot-creation-station (formerly godot-asset-gen), a persona-driven asset direction skill named The Artificer. It introduces five visual style families: pixel, painted, flat, cel, and ink. Each is backed by a LoRA adapter trained on CC0/CC-BY datasets from OpenGameArt with synthetic augmentation. The adapters were trained on a frozen ternary Bonsai checkpoint (FLUX.2 Klein 4B gemlite) with FP16 side-adapters and SVD downranked to minimum viable rank.

The README states the LoRA model files are delivered via GitHub release assets and are gitignored in the working tree. A models/README.md in the repository provides the manifest, checksums, and download instructions. The workflow described is: Brainstorm, Art-Direct, Generate, then QA with the godot-agent-vision skill to verify the output matches the intended style.

Limitations, Licence, and What This Is Not

GD Agentic Skills has no GitHub releases. Version history follows a v0.0.x numbering in CHANGELOG.md. The last push was on 2026-09-09, and the repository is not archived.

The library is licensed under LGPL-3.0. LGPL-3.0 allows use as a library without requiring downstream projects to open-source their own code, but modifications to the skill library files themselves would need to be shared under the same licence. The README does not give legal advice, and neither does this article; teams with compliance requirements should review the full LGPL-3.0 text.

For a team writing Godot code without AI agents, GD Agentic Skills provides no direct benefit. The SKILL.md files are not importable modules and do not run inside a Godot project. The alternative for teams that want structured AI coding assistance without a skill library is to write their own CLAUDE.md or AGENT.md context file describing their project's conventions. That approach requires more upfront work but gives full control over the patterns the agent learns. GD Agentic Skills provides that upfront work already done, constrained to official Godot 4.7 patterns.

Editorial conclusion

GD Agentic Skills is a practical fit for Godot 4.7+ developers who use AI coding assistants and want agent outputs that follow official Godot documentation patterns. It is not a runtime plugin; nothing in this library loads into a game's Autoload system. Developers who need a traditional importable GDScript package rather than an agent skill set will not find it here. The per-skill reference lattice pointing to docs.godotengine.org gives a direct path to verify any pattern the agents produce.

Frequently asked questions

Does GD Agentic Skills run inside a Godot game at runtime?

No. The README explicitly states that the host CLI and capture tooling run outside the game under a .gdskills/ directory, not as an in-game Autoload. GD Agentic Skills is a context library for AI agents, not a runtime plugin.

Which Godot version does GD Agentic Skills target?

The README specifies Godot 4.7+ as the baseline throughout the library. The godot-version-migration skill covers upgrades from earlier Godot versions, and every domain skill includes migration-notes.md for engine-version deltas.

What is the skills_index.json file in GD Agentic Skills?

The skills_index.json at the repository root is a machine-readable index of all 99 domain skills, maintained by the update_skills_index.py script. It allows agents and tooling to discover and query available skills programmatically.

Official sources

  1. Issues
  2. License: LGPL-3.0
  3. README
  4. thedivergentai/GD-Agentic-Skills on GitHub
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/thedivergentai-gd-agentic-skills.svg)](https://hysenlabs.com/projects/thedivergentai-gd-agentic-skills)