godot-rea
Emit a Godot 4.7 project from a GDAS-reader evidence ledger. Stubs name the ledger id and the Domain Skill to load. Use after gdas-reader, not as a decompiler. Keywords: godot-rea, reconstruction, ledger, emit_project, Godot 4.7.
How do I install this agent skill?
npx skills add https://github.com/thedivergentai/game-dev-agentic-skills --skill godot-reaIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill reconstructs Godot 4.7 projects from a JSON ledger. It features robust sanitization for identifiers and comments to prevent script injection. It includes the capability to copy files from paths specified in the input ledger, which presents a potential data exposure risk if used with untrusted input files.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
godot-rea
Turn a GDAS-reader ledger into a Godot 4.7 project. The project is a scaffold of stubs. It is not a port of machine code.
When to use
Run this after read_artifact.py has written ledger.json and the honesty rubric in GDAS-reader scores at least 3. Then open the Domain Skill named on each stub before writing gameplay.
python skills/gdas-reader/scripts/read_artifact.py P:\artifact --out P:\work\ledger.json
python skills/godot-rea/scripts/emit_project.py P:\work\ledger.json --out P:\work\godot-project
python skills/godot-rea/scripts/emit_project.py --self-test
What gets written
| Path | Role |
|---|---|
project.godot | Godot 4.7 project. Features are 4.7 and Forward Plus. Renderer is forward_plus. Main scene is res://scenes/main.tscn. The scene file has no uid:// line. The editor writes UIDs on import. |
scenes/main.tscn | One child node per ledger entry. The node name is the ledger id, not the display name, so two entries cannot share a sibling name. |
scripts/<id>.gd | Stub. Comment carries ledger id, status, evidence path, and the Godot skill to load. _ready is pass. |
placeholders/ or assets/ | Placeholders when the license is unspecified. Copied bytes when --allow-assets and the ledger license are both set. |
COVERAGE.md | Limits plus one line per entry. |
--allow-assets copies bytes into assets/<ledger-id>.<ext> when that entry's license is not blank or unspecified. It prefers the reader's copied path, then source_path. Without that pair, the emitter writes placeholders/ and leaves the bytes alone.
Expert Knowledge Delta
- A
confirmeddeclaration means the name exists in the artifact. It does not mean the Godot function should reproduce that body. Load the suggested skill and re-implement the behavior you are allowed to write. - A
partialstring from a PE or ELF scan is a hint. The reader does not walk the import table, so a.dllstring is not a confirmed import. Wiring it tohealthor a signal without a second source of truth fails the honesty rubric. unknownentries still get a node so coverage stays visible. Leaving them out makes the project look finished.- Headless
ResourceSaverdoes not write UIDs. The emitter omitsuid://becauseuid://rea_mainis illegal:ResourceUIDtext isa-zand0-9only, and an underscore returnsINVALID_ID. After import, godot-builder runsgodot -e --headless --import. config/featuresmust include both4.7andForward Plus, andrenderer/rendering_methodmust beforward_plus. A features array that is only4.7loses the renderer tag the next time the editor saves the project.- The text loader sets
ownerto the scene root when a node hasparent="."and no owner field.parentis not that assignment.Node.duplicate()does not copy owner. A laterPackedScene.packdrops children whose owner is unset, so that step mustset_owneron the copy and each child. - Godot 4.7 new projects stretch with
canvas_itemsandexpandonce the editor rewrites settings. The emitter does not pin stretch. See references/migration-notes.md and references/ledger-contract.md.
NEVER
- NEVER invent damage formulas, scene flow, or input maps that the ledger does not state. A
partialorunknownrow is not a mechanic. Band 0 is that failure. - NEVER mark a stub done by deleting
passand guessing a method body. The stub is done when the named Domain Skill replaces it. - NEVER copy asset bytes unless
--allow-assetsis set and that entry'slicenseis not blank orunspecified. An unspecified license means the bytes are not cleared to vendor into the project. - NEVER decompile the original binary to fill a stub. The reader did not prove a function body, and a disassembly is not a Godot function.
- NEVER link this skill to GDAS-reader with a relative
../gdas-readerpath. A single-skill install has no sibling folder. Use the GitHub URL in Related Skills. - NEVER add a
## Godot 4.7 Baselinesection here. Hop text stays inreferences/migration-notes.md.
Honesty rubric
| Band | Rule |
|---|---|
| 0 | Emitted GDScript implements a mechanic the ledger marked partial or unknown. |
| 1 | COVERAGE.md omits limits or drops unknown ids. |
| 2 | Stubs exist but comments omit the skill name. |
| 3 | Every entry has a script, a coverage line, and a pass body. Comments are single lines. |
| 4 | Feature tags are 4.7 and Forward Plus. Suggested skills match the ledger. Assets are placeholders, or a licensed copy named from the ledger id when --allow-assets was set. |
Ship at band 4.
Available Scripts
emit_project.py
Reads ledger JSON and writes the project tree. --self-test checks the Forward Plus feature tag, a comment that cannot become a statement, a placeholder when the license is unspecified, and a licensed copy under --allow-assets.
Field table and scene header: references/ledger-contract.md.
Reference
Official Documentation
- Godot projects — Project file and main scene the emitter writes.
- Scenes and nodes — Node tree the main scene uses for one stub per entry.
- GDScript basics — Typed
_readystubs. - Upgrading to Godot 4.7 — Feature tag and stretch defaults.
Related Skills
Prerequisites
- gdas-reader — Writes the ledger this skill emits.
- godot-project-foundations — Folder and project conventions for the scaffold.
- godot-builder — Headless import after the files exist.
Complements
- godot-composition — Fill entity-shaped stubs.
- godot-combat-system — Fill combat-shaped symbols.
- godot-input-handling — Fill input entries.
- godot-ui-containers — Fill UI entries.
- godot-save-load-systems — Fill save entries.
Downstream / consumers
- godot-testing-patterns — Tests for stubs once a skill replaces
pass.
Master
- godot-master — Router when a stub's suggested skill is the wrong chain.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/thedivergentai/game-dev-agentic-skills/godot-rea">View godot-rea on skillZs</a>