跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
视频与音频

image-sprite-sheet-split

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.

godot-fun · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add godot-fun/godot-agent --skill image-sprite-sheet-split

技能说明


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:

# 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:

.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

| Option | Default | Notes |
|--------|---------|-------|
| `--image` | **Required** | Single sprite sheet image file |
| `--grid` | **Required** | **COLSxROWS** (columns first), e.g. `4x4`, `6x3` |
| Output | `image-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 fit | Poor fit |
|----------|----------|
| Uniform N×M grid (4×4, 3×6, 8×1) | Irregular / free-form layouts |
| Gemini or Aseprite-style sheets | Packed texture atlases with variable frame sizes |
| Sheets without gutters or border padding | Sheets with grid lines, gutters, or outer padding |
| Preparing frames for per-frame background removal | Auto-detecting grid size (must be supplied) |

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

## 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:

.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

Related

  • Transparent cutouts per frame: image-remove-background
  • Trim frame borders: image-trim