Agent skill

Image Sprite Sheet Split

by godot-fun in godot-fun/gai

Splits uniform sprite sheet grids into individual frame PNGs using FFmpeg crop.

MITAuto-check passedGame Development

Install Image Sprite Sheet Split

skills CLI
$ npx skills add godot-fun/gai --skill image-sprite-sheet-split -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install godot-fun/gai image-sprite-sheet-split --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/godot-fun/gai.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/image-sprite-sheet-split .claude/skills/image-sprite-sheet-split && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
image-sprite-sheet-split
GitHub stars
182
Token cost
~1.4k tokens
SKILL.md length
520 words
Files
1
Skills in repo
36
Repo updated
First seen
Licence
MIT

At a glance

Splits uniform sprite sheet grids into individual frame PNGs using FFmpeg crop.

  • Works in 2 steps: Ensure python and ffmpeg are populated… → FFmpeg must include ffprobe beside…
  • The user wants to split sprite sheets
  • SKILL.md covers Rules, Setup (first run), Quick Start and Defaults, plus 7 more sections
  • Calls python and ffmpeg

What it does

Image Sprite Sheet Split is an agent skill from godot-fun/gai. Splits uniform sprite sheet grids into individual frame PNGs using FFmpeg crop. Use when the user wants to split sprite sheets, extract animation frames, divide grid images into cells, cut 4x4 or NxM sheets, slice tilesets, or prepare frames for background removal.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Game Development, covering Sprites and pixel art. It works with FFmpeg and Python. The repository describes itself as: A lightweight AI agent and skill workflow framework built with Godot. The licence is MIT.

When your agent uses it

  • The user wants to split sprite sheets
  • Extract animation frames
  • Divide grid images into cells
  • Prepare frames for background removal

Example prompts

  • “Use the image-sprite-sheet-split skill to split uniform sprite sheet grids into individual frame PNGs using FFmpeg crop”
  • “/image-sprite-sheet-split”

Requirements

  • Python 3

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Ensure python and ffmpeg are populated in .dependency/manifest.json (see skill-dependency-manager).
  2. FFmpeg must include ffprobe beside ffmpeg in the same bin/ folder.

What it can do on your machine

Read from SKILL.md and the folder at commit aff659b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python
    • ffmpeg

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Image Sprite Sheet Split loads about 1.4k tokens when it runs. Until then it costs about 73 tokens; SKILL.md has 520 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~73
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from godot-fun/gai at commit aff659b, republished under its MIT licence (© godot-fun). 520 words, ~1,359 tokens.

Download SKILL.mdSave it as .claude/skills/image-sprite-sheet-split/SKILL.md (or your agent's skills folder).
name
image-sprite-sheet-split
description
Splits uniform sprite sheet grids into individual frame PNGs using FFmpeg crop. Use when the user wants to split sprite sheets, extract animation frames, divide grid images into cells, cut 4x4 or NxM sheets, slice tilesets, or prepare frames for background removal.

Image Sprite Sheet Split

Split uniform grid sprite sheets into individual PNG frames via FFmpeg crop. Preserves per-cell dimensions and alpha. Does not remove backgrounds — run image-remove-background on frames afterward if needed.

Rules

When this skill applies, read and follow skill-dependency-manager — run scripts as documented, install missing tools into .dependency/.

  • Run split_frames.py through the python manifest entry (.dependency/python/). Never use host python, py, or python3.
  • Do not hand-write FFmpeg crop commands — use the bundled script.
  • Single file only. Pass one sprite sheet with --image; directories are not supported.
  • Grid size required. Supply --grid COLSxROWS before running (e.g. 4x4, 6x3).
  • populated: false is not a reason to skip. Install first, set populated: true, retry the same command.
  • Never overwrite sources. Output goes into <image-dir>/image-sprite-sheet-split/<sheet-stem>/ by default (or under -o).
  • Never copy or move input images. Pass the user's actual file path.

Setup (first run)

  1. Ensure python and ffmpeg are populated in .dependency/manifest.json (see skill-dependency-manager).

  2. FFmpeg must include ffprobe beside ffmpeg in the same bin/ folder.

Quick Start

Default: <image-dir>/image-sprite-sheet-split/<sheet-stem>/ beside the input sheet:

bash
# 4×4 sheet → image/effects/image-sprite-sheet-split/fire_sheet/fire_sheet_001.png … fire_sheet_016.png
.dependency/python/python .ai/image-sprite-sheet-split/split_frames.py --image image/effects/fire_sheet.png --grid 4x4

Custom output root:

bash
.dependency/python/python .ai/image-sprite-sheet-split/split_frames.py --image image/effects/fire_sheet.png --grid 4x4 -o image/effects/frames/
# → image/effects/frames/fire_sheet/fire_sheet_001.png …

Defaults

OptionDefaultNotes
--imageRequiredSingle sprite sheet image file
--gridRequiredCOLSxROWS (columns first), e.g. 4x4, 6x3
Outputimage-sprite-sheet-split/<stem>/Use -o / --output for a custom root directory

Frames are exported row-major (left→right, top→bottom): _001, _002, …

Supported inputs: .png, .jpg, .jpeg, .webp, .gif, .bmp, .tif, .tiff, .avif, .ico.

When to use

Good fitPoor fit
Uniform N×M grid (4×4, 3×6, 8×1)Irregular / free-form layouts
Gemini or Aseprite-style sheetsPacked texture atlases with variable frame sizes
Sheets without gutters or border paddingSheets with grid lines, gutters, or outer padding
Preparing frames for per-frame background removalAuto-detecting grid size (must be supplied)

rembg on whole sheets removes animation content — split frames first, then remove backgrounds per frame if needed.

Show full SKILL.md (224 more words)Show less

Agent Workflow

  1. Confirm grid size — ask or infer from context (4x4, 3x6, etc.).
  2. Trial first — split one sheet, inspect image-sprite-sheet-split/<stem>/001.png and the last frame.
  3. Check warnings — if image size is not evenly divisible, verify cell crops still look correct.
  4. More sheets — run once per file with the same grid settings.
  5. Revert — delete the output folder; sources are never modified.

Examples

4×4 explosion sheet (2048×2048 → 16 × 512×512):

bash
.dependency/python/python .ai/image-sprite-sheet-split/split_frames.py --image sheet.png --grid 4x4

6×3 sheet:

bash
.dependency/python/python .ai/image-sprite-sheet-split/split_frames.py --image sheet.png --grid 6x3

Agent Notes

  1. Use the bundled script, not hand-written FFmpeg crop commands.
  2. Missing Python/FFmpeg → populate .dependency/ per skill-dependency-manager, retry same command.
  3. Do not copy, move, or replace the source with frame outputs — tell the user where the output folder is.
  4. Need transparent frames → split first, then image-remove-background on each frame.

Troubleshooting

IssueFix
FFmpeg not foundPopulate ffmpeg in .dependency/manifest.json
Directory passed to --imageRun once per sheet; this skill accepts image files only
Output already existsDelete the existing frame folder or choose a different -o path
Wrong frame countVerify --grid matches the sheet layout
Misaligned cropsSheet may have gutters/padding — this skill expects a clean uniform grid
Unused pixels warningImage size is not evenly divisible by the grid; inspect output frames
Need transparent framesSplit first, then image-remove-background on frames

CLI

Copy-paste commands: cli/image-sprite-sheet-split.md

© godot-fun, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/image-sprite-sheet-split of godot-fun/gai.

Open the folder on GitHubat commit aff659b

Compare with similar skills

Image Sprite Sheet Split next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Image Sprite Sheet Split compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Image Sprite Sheet Split this skillgodot-fun/gai182—~1.4kAutomated safety check: PassMIT
2D Sprite Generator0x0funky/agent-sprite-forge4.3k—~3.6kAutomated safety check: PassMIT
Spine AnimationGenielabsOpenSource/spine-animation-ai515—~17kAutomated safety check: PassCC-BY-NC-4.0
Vox DirectorAlisa0808/vox-director2.2k—~5.6kAutomated safety check: PassMIT
Youtube Clipperop7418/Youtube-clipper-skill2.2k—~1.6kAutomated safety check: NotesMIT
Gbro Collage Brollpyang5166/gbro-collage-broll1.3k—~2.6kAutomated safety check: NotesMIT

Similar skills

  • 2D Sprite Generator

    0x0funky/agent-sprite-forge

    Produces game-ready 2D characters, creatures, props, icons and effects as master stills, sheets or clips, and exports frames for common game engines.

    4.3k GitHub stars~3.6k tokensUpdated yesterday
    Game DevelopmentAuto-check passed
  • Spine Animation

    GenielabsOpenSource/spine-animation-ai

    Create Spine 2D skeletal animations from pre-existing character assets (separated body-part PNGs, atlas spritesheet, or a full character image).

    515 GitHub stars~17k tokensUpdated 1 mo ago
    Game DevelopmentAuto-check passed
  • Vox Director

    Alisa0808/vox-director

    Turn ONE topic into a finished Vox-style paper-collage explainer / ad video, end to end on the Atlas Cloud API + local ffmpeg — script, collage keyframes, motion, voice-over, music, captions, all…

    2.2k GitHub stars~5.6k tokensUpdated 2 days ago
    Media & CreativeAuto-check passed
  • Youtube Clipper

    op7418/Youtube-clipper-skill

    YouTube 视频智能剪辑工具。下载视频和字幕,AI 分析生成精细章节(几分钟级别), 用户选择片段后自动剪辑、翻译字幕为中英双语、烧录字幕到视频,并生成总结文案。

    2.2k GitHub stars~1.6k tokensUpdated 8 mo ago
    Media & CreativeAuto-check: notes
  • Gbro Collage Broll

    pyang5166/gbro-collage-broll

    将约 5 秒口播文稿、观点句或抽象概念做成高级 editorial halftone paper-collage / 半调纸拼贴 B-roll。用户说“collage b-roll”“纸拼贴 b-roll”“半调拼贴”“拼贴风格配画面”“用这段文稿做拼贴动画”“gbro-collage-broll”,或希望把一句文稿转成拼贴视觉隐喻时,必须使用此…

    1.3k GitHub stars~2.6k tokensUpdated 2 mo ago
    Media & CreativeAuto-check: notes
  • Claude Real Video

    HUANGCHIHHUNGLeo/claude-real-video

    Watch a video for the user. An agent skill from HUANGCHIHHUNGLeo/claude-real-video.

    2.2k GitHub stars~639 tokensUpdated 6 days ago
    Media & CreativeAuto-check passed

More from godot-fun/gai

All 36 skills in this repo
  • AI Text To Speech

    godot-fun/gai

    Zero-shot text-to-speech with voice cloning via IndexTTS2 (index-tts).

    182 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Audio Denoise

    godot-fun/gai

    Reduces background noise in a single audio file using FFmpeg afftdn.

    182 GitHub stars~465 tokensUpdated today
    Auto-check passed
  • Audio Fade

    godot-fun/gai

    Applies fade-in and fade-out at the start and end of a single audio file using FFmpeg.

    182 GitHub stars~652 tokensUpdated today
    Auto-check passed
  • Normalizes a single audio file to consistent LUFS loudness with true-peak limiting using FFmpeg.

    182 GitHub stars~684 tokensUpdated today
    Auto-check passed
  • Standardizes a single audio file to 44100 or 48000 Hz and exports 16-bit PCM WAV using FFmpeg.

    182 GitHub stars~638 tokensUpdated today
    Auto-check passed
  • Audio Split

    godot-fun/gai

    Splits a single audio file into two segments (part 1 before the split point, part 2 after) using FFmpeg.

    182 GitHub stars~554 tokensUpdated today
    Auto-check passed

Works with

Questions about Image Sprite Sheet Split

What does Image Sprite Sheet Split do?

Splits uniform sprite sheet grids into individual frame PNGs using FFmpeg crop. Image Sprite Sheet Split is an agent skill from godot-fun/gai. Splits uniform sprite sheet grids into individual frame PNGs using FFmpeg crop.

When should I use Image Sprite Sheet Split?

Image Sprite Sheet Split fits situations like: the user wants to split sprite sheets; extract animation frames; divide grid images into cells; prepare frames for background removal.

How do I install Image Sprite Sheet Split in Claude Code?

Run `npx skills add godot-fun/gai --skill image-sprite-sheet-split -a claude-code`. Or copy the skill folder (.agents/skills/image-sprite-sheet-split in godot-fun/gai) into .claude/skills/image-sprite-sheet-split in your project. Claude Code loads it when a task matches its description.

How do I install Image Sprite Sheet Split in Codex?

Run `npx skills add godot-fun/gai --skill image-sprite-sheet-split -a codex`. Or copy the skill folder (.agents/skills/image-sprite-sheet-split in godot-fun/gai) into .agents/skills/image-sprite-sheet-split in your project. Codex loads it when a task matches its description.

Can I use Image Sprite Sheet Split in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add godot-fun/gai --skill image-sprite-sheet-split -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/image-sprite-sheet-split, .gemini/skills/image-sprite-sheet-split, .github/skills/image-sprite-sheet-split and .opencode/skills/image-sprite-sheet-split in your project.

What does Image Sprite Sheet Split need to run?

Going by SKILL.md and its folder, Image Sprite Sheet Split needs the command-line tools its instructions call (python and ffmpeg). Our summary lists: Python 3.

Does Image Sprite Sheet Split access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Image Sprite Sheet Split safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Image Sprite Sheet Split use?

Image Sprite Sheet Split is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Image Sprite Sheet Split use?

About 1.4k tokens (SKILL.md is roughly 5.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Image Sprite Sheet Split?

Skills that share tags, products or a category with Image Sprite Sheet Split: 2D Sprite Generator (0x0funky/agent-sprite-forge, 4.3k stars), Spine Animation (GenielabsOpenSource/spine-animation-ai, 515 stars), Vox Director (Alisa0808/vox-director, 2.2k stars) and Youtube Clipper (op7418/Youtube-clipper-skill, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Image Sprite Sheet Split?

godot-fun (a GitHub organization) maintains it in godot-fun/gai, which has 182 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on October 8, 2026.

Source: godot-fun/gai on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.