A utility to compile AI-generated pixel character reference sheets and individual actions into validated, game-ready assets and engine scenes.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install pixel-asset-compiler
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install pixel-asset-compiler using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Pixel Asset Compiler?
The Pixel Asset Compiler is a technical utility designed to transition AI-generated art into structured game engine files. By consuming character reference sheets alongside action-specific images, this tool produces deterministic, well-aligned sprite assets. It helps developers enforce consistency, eliminate background residues, and scale game assets while maintaining artistic intent.
As part of the Openclaw Skills collection, this system automates structural validation and export workflows. It bridges the gap between raw generative AI outputs and structured engine imports, providing tools to verify game-ready formats for platforms like Godot 4.
Pixel Asset Compiler Use Cases
- Converting AI-generated pixel character reference sheets and action strips into structured asset packages
- Auditing multi-frame animations for visual consistency, frame alignment, and color palette drift
- Automating the removal of flat backgrounds and preserving detached visual effects across frames
- Packaging and exporting sprite sheets directly into engine-specific formats, such as Godot 4 AnimatedSprite2D scenes
- Conducting targeted regeneration requests for specific failed actions while keeping successful assets intact
How Pixel Asset Compiler Works
- Inspection: The tool scans the target directory to verify the character reference and ensure each named action contains exactly one action sheet.
- Manifest Verification: It validates or creates the sprite-asset.manifest.json file containing definitions for FPS, loop configurations, and frame counts.
- Quality Auditing: The compiler processes the images using quality gates to detect structural ambiguities, visual drift, and background artifacts.
- Action Compilation: Once all quality checks pass, the utility generates the unified sprite sheets and metadata.
- Engine Exporting: The system packages the final assets and can export complete scene configurations, such as Godot .tscn files.
Pixel Asset Compiler Setup
To install the compiler globally via npm, run the following command:
npm install --global pixel-asset-compiler
If you are developing locally within the repository, compile the CLI using:
npm run cli:build
You can then run the end-to-end workflow script:
node <skill-dir>/scripts/run-workflow.mjs --input <character-source> --output <generic-asset-dir> --target godot --target-output <godot-asset-dir>
Pixel Asset Compiler Data Schema & Taxonomy
The compiler expects a structured directory layout and produces validated outputs as shown below:
Directory Structure
character-source/
├── reference.png
├── actions/
│ └── <action>.png
└── sprite-asset.manifest.json
Asset Manifest Specification
The sprite-asset.manifest.json file contains semantic rules for each action:
| Property | Type | Description |
|---|---|---|
| fps | Integer | Frames per second for the animation |
| loop | Boolean | Defines if the animation should loop |
| frameCount | Integer | The exact count of frames within the action strip |
All quality gates and export reports are recorded to verify the compilation state.
Pixel Asset Compiler Advanced Features
- Targeted Action Regeneration: Isolates and requests updates only for failed animations, maintaining the integrity of successful assets.
- Automated Quality Gates: Detects background residues and scale variations dynamically before exporting.
- Headless Engine Validation: Loads exported scene files headlessly to verify engine compatibility before finishing the task.
- Deterministic CLI Execution: Employs a workflow script that reports clear error codes for automated continuous integration.
SKILL.md
Loading
Related Openclaw Skills
Save Claude Notes
Save Claude Notes captures Claude Code Q&A into Markdown notes with transcript-aware defaults and flexible save targets.
TED English Learning Assistant
Converts TED talk PDFs or pasted English transcripts into structured bilingual notes, vocabulary lists, reading questions, and Obsidian Canvas maps.
LYGO Excavationpro Music Lattice
Openclaw Skills that connect listeners and agents to the Excavationpro music portal, verify the vault and catalog, and route live discovery.
Lovense LAN Control
Openclaw Skills for Lovense LAN Control turns a zero-dependency Python CLI into safe, local-network control for Lovense toys and feedback scenes.
PDF Label - Made In China
Batch-inserts "Made In China" into Amazon FBA label PDFs with barcode-aware positioning, test-page previews, and mixed-SKU support.
Wool Hunter (薅羊毛助手)
A unified shopping and deal aggregator designed to help users programmatically discover coupons, compare prices, and query welfares across multiple platforms.
Featured*
