godotctl - SKILL.md Agent Skill

name: godotctl description: Lightweight entry point for Godot work with the QXZN godotctl CLI. Use when a task mentions godotctl broadly, when choosing which Godot skill to load, or when starting a new Godot project investigation before selecting inspect, edit, csharp, runtime, or qxzn-shell workflows. license: MIT compatibility: Requires tools/godotctl Rust CLI, a Godot project, and a configured Godot binary for runtime checks. metadata: author: QXZN version: "0.2"

godotctl is a project-agnostic CLI for AI-assisted Godot development. Keep this entry skill light, then load the specialist skill that matches the task.

Path:

/home/xwsl/code/qxzn02/tools/godotctl

Common setup:

cd /home/xwsl/code/qxzn02/tools/godotctl
export GODOT_PROJECT=/home/xwsl/code/qxzn02/games/qxzn-runtime-template
export GODOT_BIN=/home/xwsl/code/qxzn02/godot/bin/godot
./godotctl doctor
./godotctl info
./godotctl --json capabilities

Use GODOT_PROJECT for the active Godot project. For older examples, music-punch may appear as /home/xwsl/code/qxzn02/games/music-punch; for the current Shell work use /home/xwsl/code/qxzn02/games/qxzn-runtime-template.

Choose A Skill

godotctl-inspect: project discovery, scene trees, deps, UI button maps, node properties, UID scans.
godotctl-edit: safe scene/resource edits, typed add/set commands, batch edits, snapshots.
godotctl-csharp: .csproj/.sln, doctor-csharp, build-csharp, C# export readiness.
godotctl-runtime: device profiles, Qualcomm/RK3588 run flags, export reports, deploy-export.
godotctl-qxzn-shell: QXZN Godot Shell routes, embedded game migration, game ids, current kiosk target.

First Moves

Run doctor, info, and --json capabilities unless the task already provides current output.
Use find-projects /home/xwsl/code/qxzn02/games --recursive when the project path is uncertain.
Load only the specialist skill needed for the next step.
After changing godotctl or these AI docs, update the matching source file under tools/godotctl/skills/<skill>/SKILL.md, then run tools/sync-ai-skills.sh from the QXZN superproject to refresh .claude/skills/<skill>/SKILL.md and docs/agent-guide/<skill>-codex.md.