godot-asset-ops

Modify Godot scenes and resources through engine APIs while preserving node ownership.

1|Updated Sep 15, 2024
One-click install
npx skills add https://github.com/mysticfall/alleycat --skill godot-asset-ops
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: godot-asset-ops
Source: https://github.com/mysticfall/alleycat/tree/main/.opencode/skills/godot-asset-ops
Command: npx skills add https://github.com/mysticfall/alleycat --skill godot-asset-ops

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Godot scene and resource edits are error-prone when done by hand; this skill provides a safe, API-driven approach to modify scenes and assets while preserving ownership and integrity.

Core Features & Use Cases

  • Safe Scene Mutation: perform edits via Godot APIs rather than editing text files directly.
  • Asset Preparation: prepare and mutate resource files, using SceneUtils helpers and a dedicated temporary script.
  • Headless Workflows: enable automated, repeatable edits in CI or headless environments.

Quick Start

Create and run a headless Godot script that uses SceneUtils to load, modify, and save a scene.

Frequently Asked Questions about godot-asset-ops

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Godot scene edits without breaking node ownership?

Automate Godot scene edits by applying mutations through engine APIs, which preserves node ownership and resource integrity. This approach uses SceneUtils helpers to safely load, modify, and save scenes instead of editing text files directly.

What is the safest way to mutate Godot resource files in a headless workflow?

Mutating Godot resource files safely in headless workflows requires executing API-driven scripts via godot-mono. This approach generates a temporary script under @game/temp and uses SceneUtils to ensure resource integrity during automated asset preparation.

Can I use GDScript to modify Godot assets in CI pipelines?

You can modify Godot assets in CI pipelines by running headless Godot execution via godot-mono. This skill automates scene and resource mutations using GDScript and SceneUtils helpers, enabling repeatable, API-driven asset preparation in automated environments.

Why should I use Godot engine APIs instead of directly editing scene text files?

Editing scene text files directly is error-prone and can break node ownership and resource integrity. Using Godot engine APIs for scene mutations ensures safe modifications, maintaining proper internal relationships and preventing data corruption during asset preparation.

Do I need a specific Godot version to run headless scene editing scripts?

Headless scene editing requires the godot-mono executable for execution. The workflow operates by creating a temporary script under @game/temp and leveraging SceneUtils helpers, which necessitates a compatible Godot environment supporting these APIs for asset mutation.