character-bundle

Generate a Godot SpriteFrames resource from character action intents and reference images.

531|45|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/RandallLiuXin/GodotMaker --skill character-bundle
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: character-bundle
Source: https://github.com/RandallLiuXin/GodotMaker/tree/main/skills/assets/character-bundle
Command: npx skills add https://github.com/RandallLiuXin/GodotMaker --skill character-bundle

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Creating animated 2D game characters requires manually drawing sprite sheets, slicing frames, and assembling SpriteFrames resources in Godot, which is slow and error-prone for developers who want playable prototypes quickly.

Core Features & Use Cases

  • AI Image Generation Pipeline: Generates full-body character sprite sheets through declared providers (native, codex, gemini, openai) using an identity anchor image and optional style references.
  • Animation Planning: Resolves high-level action intents into concrete frame counts, FPS, loop flags, grids, and per-frame durations, archived as validated plan files.
  • Deterministic Processing & Validation: Slices source sheets into frames, recovers edge-touching sprites, merges multi-batch actions, and compiles one SpriteFrames resource validated through L0-L4 checks plus an optional consumer smoke test.
  • Use Case: Describe a player character with idle, run, and attack actions in a hand-drawn cel-shaded style, and receive a ready-to-use SpriteFrames resource plus per-action GIF previews and a canonical character image.

Quick Start

Ask the agent to create a character-bundle asset with a list of named actions and intents, optionally attaching a character reference image and style description, then let it produce the validated SpriteFrames resource.

Frequently Asked Questions about character-bundle

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

FAQPage Schema
How do I generate an animated character sprite sheet for Godot?

Supply an asset request with asset_type character-bundle and an ordered list of actions, each with a unique name and intent describing pose beats and motion. The skill resolves frame counts, FPS, and grids, generates sheets via an image provider, and compiles one SpriteFrames resource.

What image providers can generate the character sprites?

The skill supports the declared native, codex, gemini, or openai providers, and never switches providers silently. If the selected provider cannot generate or attach the required images, the skill stops with a clear failure.

Can I use my own character reference image?

Yes. A user-supplied canonical image is used directly as the identity anchor for every action, or a full-body anchor is derived from a cropped image. Reference images are attached to the provider as actual images, never as text paths.

Does the character-bundle skill support pixel art styles?

No. Pixel-art production is explicitly unsupported in this skill family, and requests for it stop clearly. Supported styles include hand-drawn cel-shaded, comic-book ink, and painterly storybook, with nearest-neighbor resampling prohibited.

What happens when sprite sheet processing fails or frames touch edges?

On a needs_regeneration report, the skill runs connected-component recovery on the real source and reprocesses it. If recovery fails recoverably, it falls back to fixed-grid processing with structured warnings, and never returns a partial action bundle.