Agent skill

Godogen

by liangdabiao in liangdabiao/Godogen

This skill should be used when the user asks to "make a game", "build a game", "generate a game", or wants to generate or update a complete Godot game from a natural language description.

MITAuto-check passedGame Development

Install Godogen

skills CLI
$ npx skills add liangdabiao/Godogen --skill godogen -a claude-code

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

GitHub CLI
$ gh skill install liangdabiao/Godogen godogen --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/liangdabiao/Godogen.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/godogen .claude/skills/godogen && 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
godogen
GitHub stars
126
Token cost
~1.5k tokens
SKILL.md length
610 words
Files
22
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

This skill should be used when the user asks to "make a game", "build a game", "generate a game", or wants to generate or update a complete Godot game from a natural language description.

  • Works in 2 steps: Risk tasks (if any) — implement each in… → Main build — implement everything else,…
  • Asks to make a game
  • SKILL.md covers Capabilities, Pipeline, Execution and Godot API Lookup, plus 3 more sections
  • Runs Python scripts from its folder

What it does

Godogen is an agent skill from liangdabiao/Godogen. This skill should be used when the user asks to "make a game", "build a game", "generate a game", or wants to generate or update a complete Godot game from a natural language description.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 22 other files (for example `android-build.md`, `asset-gen.md` and `asset-planner.md`).

It sits in Game Development, covering Game development and Visual regression testing. It works with Godot. The repository describes itself as: liang's Godogen: 使用 Claude Code 构建完整 Godot 4 项目的技能集,你描述你想要的内容。AI pipeline 会设计架构、生成美术资源、编写每一行代码、从运行的游戏引擎中截取截图,并修复看起来不对的地方。输出是一个真正的 Godot 4…. The licence is MIT.

When your agent uses it

  • Asks to make a game
  • Generate a game
  • Wants to generate
  • Update a complete Godot game from a natural language description

Example prompts

  • “make a game”
  • “build a game”
  • “generate a game”
  • “/godogen”

Requirements

  • Python 3

Workflow steps

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

  1. Risk tasks (if any) — implement each in isolation, verify, commit
  2. Main build — implement everything else, verify, present results (video for new games), commit

What it can do on your machine

Read from SKILL.md and the folder at commit 8f31578. 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 script files (Python, from the files we listed), which the agent can run.

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

  • Network

    No URLs in SKILL.md.

    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

Godogen loads about 1.5k tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 610 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~49
When it runs · the whole SKILL.md, loaded when a task matches
~1.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); files beside SKILL.md are not scanned.

SKILL.md

The full file from liangdabiao/Godogen at commit 8f31578, republished under its MIT licence (© liangdabiao). 610 words, ~1,506 tokens.

Download SKILL.mdSave it as .claude/skills/godogen/SKILL.md (or your agent's skills folder). This skill also uses 21 other files; get the full folder from GitHub.
name
godogen
description
This skill should be used when the user asks to "make a game", "build a game", "generate a game", or wants to generate or update a complete Godot game from a natural language description.

Game Generator — Orchestrator

Generate and update Godot games from natural language.

Capabilities

Read each sub-file from ${CLAUDE_SKILL_DIR}/ when you reach its pipeline stage.

FilePurposeWhen to read
visual-target.mdGenerate reference imagePipeline start
decomposer.mdDecompose into task DAGAfter visual target
scaffold.mdArchitecture + skeletonAfter decomposition
asset-planner.mdBudget and plan assetsIf budget provided
asset-gen.mdAsset generation CLI refWhen generating assets
rembg.mdBackground removalOnly when an asset needs transparency removed
sprite-gen.mdSprite sheet animation generationWhen generating animated characters
task-execution.mdTask workflow + commandsBefore first task
quirks.mdGodot gotchasBefore writing code
(godot-api skill)GDScript syntax refWhen unsure about GDScript syntax
scene-generation.mdScene buildersTargets include .tscn
test-harness.mdVerification scriptsBefore test harness
capture.mdScreenshot/videoBefore capture
visual-qa.mdVisual QA (forked skill)After capture
android-build.mdAPK exportUser requests Android

Pipeline

User request
    |
    +- Check if PLAN.md exists (resume check)
    |   +- If yes: read PLAN.md, STRUCTURE.md, MEMORY.md -> skip to task execution
    |   +- If no: continue with fresh pipeline below
    |
    +- Generate visual target -> reference.png + ASSETS.md (art direction only)
    +- Analyze risks + define verification criteria -> PLAN.md
    +- Design architecture -> STRUCTURE.md + project.godot + stubs
    |
    +- If budget provided (and no asset tables in ASSETS.md):
    |   +- Plan and generate assets -> ASSETS.md + updated PLAN.md with asset assignments
    |
    +- Show user a concise plan summary (risk tasks if any, main build scope)
    |
    +- Execute (see Execution below)
    |
    +- If user requested Android app:
    |   +- Read android-build.md, add ETC2/ASTC to project.godot, create export_presets.cfg, export APK
    |
    +- Summary of completed game

Execution

Read task-execution.md before starting. Three phases:

  1. Risk tasks (if any) — implement each in isolation, verify, commit
  2. Main build — implement everything else, verify, present results (video for new games), commit

Godot API Lookup

When you need to look up a Godot class API (methods, properties, signals), use Skill(skill="godot-api") with your query. This runs in a separate context to avoid loading large API docs into the main pipeline.

Be specific about what you need — the docs are comprehensive and full returns are large:

  • Targeted query — ask for specific methods/signals to get a concise answer: "CharacterBody3D: what method applies velocity and slides along collisions?"
  • Full API — only request when you need to survey the entire class: "full API for AnimationPlayer"

Examples:

  • Skill(skill="godot-api") "TileMapLayer: methods for setting/getting cells and their alternatives"
  • Skill(skill="godot-api") "full API for CharacterBody3D"
  • Skill(skill="godot-api") "which class handles 2D particle effects?"
  • Skill(skill="godot-api") "GDScript: tween parallel syntax and callbacks"

Visual QA

After capturing screenshots, verify with Skill(skill="visual-qa"). Runs in a forked context with Claude's native vision.

  • Static: Skill(skill="visual-qa") "Check reference.png against screenshots/{task}/frame0003.png — Goal: ..., Verify: ..."
  • Dynamic: Skill(skill="visual-qa") "Check reference.png against frame1.png frame2.png ... — Goal: ..., Verify: ..."
  • Question: Skill(skill="visual-qa") "Are surfaces showing magenta? screenshots/{task}/frame*.png"

Save output to visual-qa/{N}.md. See visual-qa.md for full usage.

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

Context Hygiene

Keep important state in files so the pipeline can resume even after compaction or clear:

  • PLAN.md — task statuses, always up to date before moving on
  • STRUCTURE.md — architecture reference, update if scaffolding changes
  • MEMORY.md — discoveries, quirks, workarounds, what worked/failed
  • ASSETS.md — asset manifest with paths and generation details

After completing each task: update PLAN.md status, write discoveries to MEMORY.md, git commit. This ensures the pipeline can resume from any point by reading these files.

If the context becomes polluted from debugging loops, manually compact with: /compact "Discard failed debugging attempts."

Visual QA

Don't trust code — verify on screenshots. The most common failure mode: code looks correct, you assume it works, and report "everything's fine." Then screenshots reveal broken placement, wrong scale, missing elements, clipped geometry — dozens of small details that go wrong in unexpected ways, especially with custom assets. Visual QA is your quality partner: use it actively after every task, not as a formality.

Visual QA runs inline with each task. Never ignore a fail verdict — always act on it before marking a task done.

VQA reports are clear signal. If a significant issue is reported, fix it. If you genuinely believe it's a false positive — report it to the user and let them decide. Never silently ignore a fail verdict.

  • pass/warning — move on.
  • fail — fix the issue. If you've already attempted up to 3 fix cycles, decide:
    • Replan — reset architecture, rewrite plan, and/or regenerate assets if the root cause is upstream.
    • Escalate — surface the issue to the user if you can't determine the right fix.

The final task in PLAN.md is a presentation video — a script that showcases gameplay in a ~30-second cinematic MP4.

© liangdabiao, MIT. 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 21 other files in .claude/skills/godogen of liangdabiao/Godogen.

  • SKILL.md
  • android-build.md
  • asset-gen.md
  • asset-planner.md
  • capture.md
  • decomposer.md
  • quirks.md
  • rembg.md
  • scaffold.md
  • scene-generation.md
  • sprite-gen.md
  • task-execution.md
  • test-harness.md
  • tools/asset_gen.py
  • tools/find_loop_frame.py
  • tools/grid_slice.py
  • tools/rembg_matting.py
  • tools/requirements.txt
  • tools/sprite_gen.py
  • tools/tripo3d.py
  • … and 2 more

Open the folder on GitHubat commit 8f31578

Compare with similar skills

Godogen 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.

Godogen compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Godogen this skillliangdabiao/Godogen126—~1.5kAutomated safety check: PassMIT
Godot Agent Visionthedivergentai/GD-Agentic-Skills821—~3.5kAutomated safety check: PassLGPL-3.0
Visual QAvalkor-ai/loom1.2k—~438Automated safety check: PassApache-2.0
Godot Gdscript Patterns925236118/AlphaAgent10310 repos~5kAutomated safety check: PassMIT
2D Map and Scene Generator0x0funky/agent-sprite-forge4.4k—~2.9kAutomated safety check: PassMIT
Godot UI Integrationzimo-xiao-zheng/godot-ui-integration285—~1.5kAutomated safety check: PassMIT

Similar skills

  • 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
    Game DevelopmentAuto-check passed
  • Visual QA

    valkor-ai/loom

    Inspect Godot screenshots or short frame sequences for acceptance issues.

    1.2k GitHub stars~438 tokensUpdated 3 days ago
    Game DevelopmentAuto-check passed
  • Godot Gdscript Patterns

    925236118/AlphaAgent

    Master Godot 4 GDScript patterns including signals, scenes, state machines, and optimization.

    103 GitHub starsUsed in 10 repos~5k tokens
    Game DevelopmentAuto-check passed
  • 2D Map and Scene Generator

    0x0funky/agent-sprite-forge

    Plans and builds 2D game maps and scenes, from tilemaps and parallax backgrounds to HD-2D plates, with collision checks, a playable HTML preview and Tiled, Godot or LDtk export.

    4.4k GitHub stars~2.9k tokensUpdated 3 days ago
    Game DevelopmentAuto-check passed
  • Godot UI Integration

    zimo-xiao-zheng/godot-ui-integration

    Build or revise Godot UI from an approved design, separated art, or a visual reference when scene structure, gameplay binding, and runtime visual verification all matter.

    285 GitHub stars~1.5k tokensUpdated 1 mo ago
    Game DevelopmentAuto-check passed
  • Godot Wechat Minigame Adapter

    godothub/godot-minigame

    Apply the bundled self-contained Godot WeChat Mini Game adapter kit to an official Godot checkout.

    187 GitHub stars~1.5k tokensUpdated 24 days ago
    Game DevelopmentAuto-check passed

More from liangdabiao/Godogen

  • Visual QA

    liangdabiao/Godogen

    Visual quality assurance — analyze game screenshots for defects, compare against reference, check motion in frame sequences.

    126 GitHub stars~1.4k tokensUpdated 5 mo ago
    Auto-check passed
  • Godot API

    liangdabiao/Godogen

    Look up Godot engine class APIs — methods, properties, signals, enums.

    126 GitHub stars~287 tokensUpdated 5 mo ago
    Auto-check passed

Works with

Questions about Godogen

What does Godogen do?

This skill should be used when the user asks to "make a game", "build a game", "generate a game", or wants to generate or update a complete Godot game from a natural language description. Godogen is an agent skill from liangdabiao/Godogen. This skill should be used when the user asks to "make a game", "build a game", "generate a game", or wants to generate or update a complete Godot game from a natural language description.

When should I use Godogen?

Godogen fits situations like: asks to make a game; generate a game; wants to generate; update a complete Godot game from a natural language description.

How do I install Godogen in Claude Code?

Run `npx skills add liangdabiao/Godogen --skill godogen -a claude-code`. Or copy the skill folder (.claude/skills/godogen in liangdabiao/Godogen) into .claude/skills/godogen in your project. Claude Code loads it when a task matches its description.

How do I install Godogen in Codex?

Run `npx skills add liangdabiao/Godogen --skill godogen -a codex`. Or copy the skill folder (.claude/skills/godogen in liangdabiao/Godogen) into .agents/skills/godogen in your project. Codex loads it when a task matches its description.

Can I use Godogen 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 liangdabiao/Godogen --skill godogen -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/godogen, .gemini/skills/godogen, .github/skills/godogen and .opencode/skills/godogen in your project.

What does Godogen need to run?

Going by SKILL.md and its folder, Godogen needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Godogen access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Godogen 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. Review the folder before installing.

What licence does Godogen use?

Godogen is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Godogen use?

About 1.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Godogen?

Skills that share tags, products or a category with Godogen: Godot Agent Vision (thedivergentai/GD-Agentic-Skills, 821 stars), Visual QA (valkor-ai/loom, 1.2k stars), Godot Gdscript Patterns (925236118/AlphaAgent, 103 stars) and 2D Map and Scene Generator (0x0funky/agent-sprite-forge, 4.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Godogen?

liangdabiao (a GitHub user) maintains it in liangdabiao/Godogen, which has 126 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on April 15, 2026.

Source: liangdabiao/Godogen on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.