skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
thedivergentai/game-dev-agentic-skills54 installs

gdas-reader

GDAS-reader turns a source tree, web bundle, asset folder, WASM module, or PE/ELF file into an evidence ledger for godot-rea or bevy-rea. Use before emitting a Godot or Bevy reconstruction. Keywords: GDAS-reader, ledger, read_artifact, reconstruction, evidence.

How do I install this agent skill?

npx skills add https://github.com/thedivergentai/game-dev-agentic-skills --skill gdas-reader
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill is a utility for scanning source code, web assets, and binary files to generate an evidence ledger for game reconstruction. It uses only Python's standard library, performs no network operations, and includes robust logic to handle untrusted artifacts securely.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

GDAS-reader

Read an artifact and write ledger.json. This skill does not create a Godot scene or a Bevy crate. godot-rea and bevy-rea do that from the ledger.

When to use

Load this when the input is a folder or a shipped file and the output must be a reconstruction in Godot or Bevy. Run the reader first. Hand the ledger to one emitter.

python skills/gdas-reader/scripts/read_artifact.py P:\artifact --out P:\work\ledger.json
python skills/gdas-reader/scripts/read_artifact.py --self-test

A hub-only install uses the copy under Available Scripts: read_artifact.py.

Schema: references/ledger.md.

What the reader records

ArtifactConfirmed factsWhat stays partial or unknown
Source treeDeclarations, including class_name, async fn, and pub(crate) fn. UI-shaped string literals.State-looking names (state, phase, mode) stay partial.
Web bundleDocument title outside script and style, headings, script URLs, image URLs, JSON key paths for every array elementBehavior inside minified scripts. A folder is also scanned for source, assets, and WASM instead of dropping them.
Asset folderFile path, media type, and source_pathBytes stay put unless --allow-assets and a real --license-note are both set
WASMExport names, import module and field names, up to 10 ASCII runsFunction bodies. Non-ASCII text. A truncated section becomes unknown instead of a crash.
PE or ELFFormat identification and readable stringsMachine code. A .dll or .so string is partial because the import table is not walked. A short header becomes unknown.

The reader is stdlib Python. It does not call an external decompiler. A native binary contributes a header walk, imports, and strings. Packed or encrypted sections become unknown entries.

Ledger honesty

Score the ledger before an emitter runs. Bands are additive. A ledger below 3 does not get emitted as gameplay.

BandRule
0Entries claim behavior the file does not show.
1Status is missing, or every guess is marked confirmed.
2Status values exist, but limits hides a format the reader cannot parse.
3Each entry has id, status, evidence, and a skill suggestion. unknown is listed.
4Caps and license gaps are in limits. No asset bytes were copied. Partial names are not described as working mechanics.

NEVER

  • NEVER mark a symbol confirmed because its name looks like health, damage, or save. Those matches are partial.
  • NEVER copy image, audio, or glTF bytes unless both --allow-assets and --license-note are set. A note alone records the license and still leaves the bytes in place.
  • NEVER decompile native code, WASM bodies, or minified JavaScript to invent a mechanic.
  • NEVER drop limits when the scan hit the 40-entry cap or the file was packed.
  • NEVER point godot-rea or bevy-rea at a relative ../gdas-reader path. Link the GitHub URL above so a single-skill install still names the prerequisite.

Available Scripts

read_artifact.py

Classifies a file or directory and writes the ledger. --self-test checks fixtures. --license-note records a license. --allow-assets copies bytes into copied-assets/ next to --out and requires that note.

Related Skills

Prerequisites

  • None. This skill is the first step.

Complements

  • godot-rea — Godot 4.7 project emitted from this ledger.
  • bevy-rea — Bevy 0.20 crate emitted from this ledger.

Downstream / consumers

Master

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/gdas-reader">View gdas-reader on skillZs</a>