Agent skill

Godot Project Templates

by thedivergentai in thedivergentai/GD-Agentic-Skills

Navigation skill for genre project scaffolds: pick platformer/RPG/FPS (or other genre) then load matching template scripts and route gameplay fill to godot-genre- skills.

LGPL-3.0Auto-check passedGame Development

Install Godot Project Templates

skills CLI
$ npx skills add thedivergentai/GD-Agentic-Skills --skill godot-project-templates -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install thedivergentai/GD-Agentic-Skills godot-project-templates --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/thedivergentai/GD-Agentic-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/godot-project-templates .claude/skills/godot-project-templates && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
godot-project-templates
GitHub stars
821
Token cost
~3.3k tokens
SKILL.md length
887 words
Files
16 (incl. scripts, references)
Skills in repo
98
Repo updated
First seen
Licence
LGPL-3.0

At a glance

Navigation skill for genre project scaffolds: pick platformer/RPG/FPS (or other genre) then load matching template scripts and route gameplay fill to godot-genre- skills.

  • Works in 4 steps: Bootstrap — MANDATORY… → Pick a genre row below → load listed… → Rename project, register… → …
  • Bootstrapping architecture
  • SKILL.md covers NEVER Do (Expert Anti-Patterns), Golden Path, Genre Router → Scripts and Architecture Deltas (keep in…, plus 3 more sections
  • Bootstrap order

What it does

Godot Project Templates is an agent skill from thedivergentai/GD-Agentic-Skills. Navigation skill for genre project scaffolds: pick platformer/RPG/FPS (or other genre) then load matching template scripts and route gameplay fill to godot-genre- skills. Use when bootstrapping architecture, bootstrap order, pause modes, PCK DLC, or feature tags — not for pasting FPS/inventory recipes. Keywords: project templates, bootstrap, Subsystem Locator, PCK, feature tags, PROCESSMODEALWAYS, genre scaffold.

Its SKILL.md is about 3.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 17 other files, including scripts and reference files (for example `references/genre-template-scaffolds.md` and `references/migration-notes.md`).

It sits in Game Development, covering Project scaffolding and Game development. It works with Godot. The repository describes itself as: 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… The licence is LGPL-3.0.

When your agent uses it

  • Bootstrapping architecture
  • Bootstrap order
  • Feature tags — not for pasting FPS/inventory recipes

Example prompts

  • “/godot-project-templates”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Bootstrap — MANDATORY bootstrap_config.gd: config/network before audio/UI (do not rely on accidental Autoload order).
  2. Pick a genre row below → load listed scripts only.
  3. Rename project, register locator/bootstrap, configure Input Map.
  4. Open the consumer godot-genre-* skill for gameplay systems.

What it can do on your machine

Read from SKILL.md and the folder at commit 4c4d0ff. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 13 files in scripts/, which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • docs.godotengine.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Godot Project Templates loads about 3.3k tokens when it runs, and up to ~5k if it reads all its reference files. Until then it costs about 111 tokens; SKILL.md has 887 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~111
When it runs · the whole SKILL.md, loaded when a task matches
~3.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from thedivergentai/GD-Agentic-Skills at commit 4c4d0ff, republished under its LGPL-3.0 licence (© thedivergentai). 887 words, ~3,333 tokens.

Download SKILL.mdSave it as .claude/skills/godot-project-templates/SKILL.md (or your agent's skills folder). This skill also uses 15 other files; get the full folder from GitHub.
name
godot-project-templates
description
Navigation skill for genre project scaffolds: pick platformer/RPG/FPS (or other genre) then load matching template scripts and route gameplay fill to godot-genre-* skills. Use when bootstrapping architecture, bootstrap order, pause modes, PCK DLC, or feature tags — not for pasting FPS/inventory recipes. Keywords: project templates, bootstrap, Subsystem Locator, PCK, feature tags, PROCESS_MODE_ALWAYS, genre scaffold.

Project Templates (Navigation)

Scaffold architecture, then adapt — never dump genre tutorials into the project verbatim.

NEVER Do (Expert Anti-Patterns)

Directory & Scaffolding
  • NEVER hardcode scene paths in dozens of call sites — AutoLoad constants or a scene registry.
  • NEVER skip .gdignore for designer asset drops outside import pipelines.
  • NEVER copy-paste templates as-is — Understand structure, then adapt (see checklist below).
Architecture & Lifecycle
  • NEVER use get_tree().paused without process-mode groups — Pause menus need PROCESS_MODE_ALWAYS. Why: pausing the tree freezes _process on menu nodes too, so buttons never receive input; set gameplay to INHERIT (paused) and menu/HUD to ALWAYS via base_menu.gd or explicit process_mode on the pause root.
  • NEVER skip virtual lifecycle hooks on base classes — Prefer _initialize_*() over brittle _ready() overrides.
  • NEVER rely on monolithic God singletons — Signal Bus or Subsystem Locator.
Platform & UI
  • NEVER skip Input.MOUSE_MODE_CAPTURED in FPS scaffolds — Set when the FPS genre path is chosen.
  • NEVER use floating-point constants for UI layout — Anchors/containers.
  • NEVER ignore i18n translation context — Disambiguate strings in tr() / contexts.
Performance
  • NEVER load massive levels synchronously — ResourceLoader.load_threaded_request().

Golden Path

  1. Bootstrap — MANDATORY bootstrap_config.gd: config/network before audio/UI (do not rely on accidental Autoload order).
  2. Pick a genre row below → load listed scripts only.
  3. Rename project, register locator/bootstrap, configure Input Map.
  4. Open the consumer godot-genre-* skill for gameplay systems.

Platformer end-to-end: row 1 scripts → godot-genre-platformer (advanced_platformer_controller.gd for movement; template base_level + state machine for scene flow). Do NOT paste FPS/inventory recipes from this skill.

Genre Router → Scripts

MANDATORY: Choose a genre row, load the listed scripts, then open the consumer godot-genre-* skill for gameplay systems. Do NOT paste inline FPS controllers or inventory managers from memory.

Genre intentLoad these template scripts (MANDATORY)Fill gameplay via
2D platformerbase_game_manager.gd, base_level.gd, base_actor.gd, scene_state_machine.gd, state_machine_node.gdgodot-genre-platformer
Top-down / action RPGSame bases + subsystem_locator.gd, base_menu.gdgodot-genre-action-rpg
3D FPS / shooterBases + multi_platform_input.gd, platform_feature_config.gdgodot-genre-shooter-fps
Any genre + DLC packsmodular_dlc_loader.gdGenre skill + godot-export-builds
Cross-platform input/featuresmulti_platform_input.gd, platform_feature_config.gdgodot-input-handling
Threaded level streaminglevel_steamer_manager.gdgodot-scene-management
Accessibility TTSaccessibility_tts_manager.gdProject foundations / UI skills

Folder-by-feature skeleton (all genres): entities/<name>/, levels/ or maps/, ui/, autoloads/ or locator-registered systems, resources/. Details belong in the genre consumer skill — not duplicated here.


Architecture Deltas (keep in this skill)

Subsystem Locator vs God Autoload

Prefer subsystem_locator.gd for modular registration; keep a thin bootstrap Autoload only.

Bootstrap order

MANDATORY bootstrap_config.gd (or equivalent): critical systems (config/network) before audio/UI. Do not rely on accidental Project Settings Autoload order alone.

Pause modes

Gameplay tree pauses; UI/pause menu nodes use PROCESS_MODE_ALWAYS. Wire via base_menu.gd.

PCK / DLC

MANDATORY modular_dlc_loader.gd for ProjectSettings.load_resource_pack() mounts — never hand-roll path hacks in gameplay code.

Feature tags

MANDATORY platform_feature_config.gd for OS.has_feature() / export-tag forks (mobile, low_end, dedicated_server).


Adapt-Not-Copy Checklist

Map each template piece to a consumer skill before writing gameplay code:

Template pieceAdapt into
base_actor / state machine nodesGenre movement/combat skill (godot-genre-*) + godot-state-machine-advanced
base_game_manager signalsgodot-autoload-architecture / godot-signal-architecture
Level streamergodot-scene-management
Input / feature configgodot-input-handling + platform skills
Menus / HUD shellsgodot-ui-containers
Export / CI / PCKgodot-export-builds

Usage: pick genre row → load scripts → rename project → register locator/bootstrap → configure Input Map → open genre skill for systems — do not paste stock FPS/inventory recipes from this skill.

Deep dive (load on demand)

Platformer/RPG/FPS directory trees, input map template, CI export YAML, PCK mount, bootstrap priority — references/genre-template-scaffolds.md.

Show full SKILL.md (363 more words)Show less

Reference

Progressive disclosure: open Official Documentation links only when researching a specific API; load Related Skills when routing to a peer domain — do not preload the whole lattice.

Official Documentation
  • Project organization — Feature-folder layouts, .gdignore, and VCS hygiene that genre boilerplates should bake in from day one.
  • Scene organization — Ownership boundaries for entities/, levels/, and UI scenes so templates stay refactor-safe.
  • Singletons (Autoload) — Registering lean GameManager / Audio / SceneTransitioner services that survive scene changes.
  • Autoloads versus regular nodes — When a Subsystem Locator or scene-local node beats a monolithic God singleton.
  • Background loading — ResourceLoader.load_threaded_* patterns used by level streamer templates.
  • Pausing games — Process modes so pause menus stay alive while gameplay freezes.
  • Multiple resolutions — Stretch mode/aspect defaults (canvas_items / expand) every new project template should document.
  • Feature tags — OS.has_feature() profiles for mobile/PC/server overrides in platform config templates.
  • Exporting packs (PCK) — Modular DLC / patch mounts via ProjectSettings.load_resource_pack().
  • Using controllers and gamepads — Default Input Map actions and deadzone tuning for multi-platform templates.
  • Text-to-speech — DisplayServer TTS hooks for accessibility manager scaffolding.
  • Internationalizing games — Translation contexts so UI strings in menus/HUD avoid ambiguous keys.
Prerequisites
  • godot-project-foundations — Folder hygiene, naming, and import basics before copying a genre skeleton into a real repo.
  • godot-gdscript-mastery — Typed base classes, virtual hooks, and signal style used by every template script here.
Complements
  • godot-autoload-architecture — Boot order and ownership rules once BootstrapConfig / GameManager Autoloads leave the template stage.
  • godot-scene-management — Production scene swaps and load queues that deepen the level streamer boilerplate.
  • godot-input-handling — Full action maps, device routing, and remapping beyond MultiPlatformInput scaffolding.
  • godot-state-machine-advanced — Hierarchical / visual FSM patterns that extend SceneStateMachine and StateMachineNode.
  • godot-export-builds — Export presets, VRAM compression, and CI headless flags assumed by Standard-Export-Presets templates.
  • godot-signal-architecture — Typed EventBus patterns when templates grow past direct GameManager signals.
  • godot-ui-containers — Anchor/container layouts for BaseMenu and HUD scenes instead of floating-point pixel drift.
  • godot-adapt-desktop-to-mobile — Touch, safe-area, and mobile feature-tag profiles that PlatformFeatureConfig only stubs.
Downstream / consumers
  • godot-genre-platformer — Fills the 2D platformer directory skeleton with movement, coyote time, and level flow.
  • godot-genre-action-rpg — Combat, inventory, and quest systems that plug into the top-down RPG template folders.
  • godot-genre-shooter-fps — Weapons, hit detection, and camera feel layered on the 3D FPS player scaffold.
Master
  • godot-master — Library router and mirrored module entry for cross-skill discovery.

© thedivergentai, LGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 15 other files (scripts, references) in skills/godot-project-templates of thedivergentai/GD-Agentic-Skills.

  • SKILL.md
  • references/genre-template-scaffolds.md
  • references/migration-notes.md
  • scripts/accessibility_tts_manager.gd
  • scripts/base_actor.gd
  • scripts/base_game_manager.gd
  • scripts/base_level.gd
  • scripts/base_menu.gd
  • scripts/bootstrap_config.gd
  • scripts/level_steamer_manager.gd
  • scripts/modular_dlc_loader.gd
  • scripts/multi_platform_input.gd
  • scripts/platform_feature_config.gd
  • scripts/scene_state_machine.gd
  • scripts/state_machine_node.gd
  • scripts/subsystem_locator.gd

Open the folder on GitHubat commit 4c4d0ff

Compare with similar skills

Godot Project Templates next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Godot Project Templates compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Godot Project Templates this skillthedivergentai/GD-Agentic-Skills821—~3.3kAutomated safety check: PassLGPL-3.0
Godot Project Setupjame581/GodotPrompter805—~3.2kAutomated safety check: PassMIT
Gm ScaffoldRandallLiuXin/GodotMaker550—~1.9kAutomated safety check: PassCustom licence
Hz New Project Creationmeta-quest/agentic-tools215—~2.3kAutomated safety check: PassApache-2.0
Dependency Injectionjame581/GodotPrompter805—~2.8kAutomated safety check: PassMIT
Gdscript Advancedjame581/GodotPrompter805—~3.4kAutomated safety check: PassMIT

Similar skills

  • Godot Project Setup

    jame581/GodotPrompter

    A skill your agent uses when creating a new Godot 4.x project — scaffolds recommended directory structure, project settings, autoloads, and .gitignore

    805 GitHub stars~3.2k tokensUpdated yesterday
    Game DevelopmentAuto-check passed
  • Gm Scaffold

    RandallLiuXin/GodotMaker

    Scaffold a new Godot project: project.godot + addons + base directories + e2e/conftest.py + initial git commit.

    550 GitHub stars~1.9k tokensUpdated 23 days ago
    Game DevelopmentAuto-check passed
  • Hz New Project Creation

    meta-quest/agentic-tools

    Scaffolds new Meta VR and Horizon OS projects after the build path is selected — Standard Android, Meta Spatial SDK, Unity, Unreal, or WebXR.

    215 GitHub stars~2.3k tokensUpdated 16 days ago
    Game DevelopmentAuto-check passed
  • Dependency Injection

    jame581/GodotPrompter

    A skill your agent uses when managing dependencies between systems — autoloads, service locators, @export injection, and scene injection patterns

    805 GitHub stars~2.8k tokensUpdated yesterday
    Game DevelopmentAuto-check passed
  • Gdscript Advanced

    jame581/GodotPrompter

    A skill your agent uses when writing production-grade GDScript — performance idioms, metaprogramming, @tool lifecycle, async pitfalls, signal/Callable trade-offs, profiler-driven idioms, and common…

    805 GitHub stars~3.4k tokensUpdated yesterday
    Game DevelopmentAuto-check passed
  • Gdscript Patterns

    jame581/GodotPrompter

    A skill your agent uses when writing GDScript — static typing, await/coroutines, lambdas, match patterns, export annotations, inner classes, and common idioms

    805 GitHub stars~3.5k tokensUpdated yesterday
    Game DevelopmentAuto-check passed

More from thedivergentai/GD-Agentic-Skills

All 98 skills in this repo
  • Godot 2D Animation

    thedivergentai/GD-Agentic-Skills

    Expert patterns for 2D animation in Godot using AnimatedSprite2D and skeletal cutout rigs.

    821 GitHub stars~3.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot 3D World Building

    thedivergentai/GD-Agentic-Skills

    Expert patterns for 3D level design using GridMap with MeshLibrary, CSG constructive solid geometry, occlusion, and runtime GridMap builders.

    821 GitHub stars~3.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot Adapt 2D To 3D

    thedivergentai/GD-Agentic-Skills

    Expert patterns for migrating 2D games to 3D including node type conversions, camera systems (third-person, first-person, orbit), physics layer migration, sprite-to-model art pipeline, and control…

    821 GitHub stars~4.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot Adapt 3D To 2D

    thedivergentai/GD-Agentic-Skills

    Expert patterns for simplifying 3D games to 2D including dimension reduction strategies, 2.5D fake-depth, isometric ports, camera flattening, physics conversion, 3D-to-sprite art pipeline, and…

    821 GitHub stars~4.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot Agent Vision

    thedivergentai/GD-Agentic-Skills

    Agentic eyes for Godot work: cross-platform screenshot CLI (asset/region/window/screen) to budgeted WebP, TEMP editor viewport bridge under .gdskills/, and Taste Receptor Atlas v2 (~237…

    821 GitHub stars~3.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot Animation Tree Mastery

    thedivergentai/GD-Agentic-Skills

    Expert patterns for AnimationTree including StateMachine transitions, BlendSpace2D for directional movement, BlendTree for layered animations, root motion, transition conditions, advance…

    821 GitHub stars~3.6k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about Godot Project Templates

What does Godot Project Templates do?

Navigation skill for genre project scaffolds: pick platformer/RPG/FPS (or other genre) then load matching template scripts and route gameplay fill to godot-genre- skills. Godot Project Templates is an agent skill from thedivergentai/GD-Agentic-Skills. Navigation skill for genre project scaffolds: pick platformer/RPG/FPS (or other genre) then load matching template scripts and route gameplay fill to godot-genre- skills.

When should I use Godot Project Templates?

Godot Project Templates fits situations like: bootstrapping architecture; bootstrap order; feature tags — not for pasting FPS/inventory recipes.

How do I install Godot Project Templates in Claude Code?

Run `npx skills add thedivergentai/GD-Agentic-Skills --skill godot-project-templates -a claude-code`. Or copy the skill folder (skills/godot-project-templates in thedivergentai/GD-Agentic-Skills) into .claude/skills/godot-project-templates in your project. Claude Code loads it when a task matches its description.

How do I install Godot Project Templates in Codex?

Run `npx skills add thedivergentai/GD-Agentic-Skills --skill godot-project-templates -a codex`. Or copy the skill folder (skills/godot-project-templates in thedivergentai/GD-Agentic-Skills) into .agents/skills/godot-project-templates in your project. Codex loads it when a task matches its description.

Can I use Godot Project Templates in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add thedivergentai/GD-Agentic-Skills --skill godot-project-templates -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/godot-project-templates, .gemini/skills/godot-project-templates, .github/skills/godot-project-templates and .opencode/skills/godot-project-templates in your project.

What does Godot Project Templates need to run?

SKILL.md names no scripts, command-line tools or credentials: Godot Project Templates is instructions for the agent only.

Does Godot Project Templates access the network?

SKILL.md names 1 domain. As links in the text: docs.godotengine.org. This is read from the text; nothing was executed.

Is Godot Project Templates safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Godot Project Templates use?

Godot Project Templates is published under the LGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Godot Project Templates use?

About 3.3k tokens (SKILL.md is roughly 13k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.6k tokens, read only when the agent opens those files.

What are the alternatives to Godot Project Templates?

Skills that share tags, products or a category with Godot Project Templates: Godot Project Setup (jame581/GodotPrompter, 805 stars), Gm Scaffold (RandallLiuXin/GodotMaker, 550 stars), Hz New Project Creation (meta-quest/agentic-tools, 215 stars) and Dependency Injection (jame581/GodotPrompter, 805 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Godot Project Templates?

thedivergentai (a GitHub user) maintains it in thedivergentai/GD-Agentic-Skills, which has 821 GitHub stars. The repository holds 98 skills in this directory. The repository was last updated on September 9, 2026.

Source: thedivergentai/GD-Agentic-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.