image-to-png
Skill210 starsChanged 2 days agoMITView on GitHub
Converts image files to PNG using FFmpeg while preserving dimensions and alpha. Use when the user wants to convert images to PNG, transcode JPG/WebP/GIF/BMP/TIFF to PNG, export a game/UI texture as PNG, or mentions PNG conversion without background removal.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- godot-fun/godot-agentword for word, first seen Nov 15, 2026
Other versions1 project uses a version of this.
Word for word · 1
- godot-fun/godot-agent★ 210100% same
Edited · 0
None found.
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository40 other files it gives its agents.
- AGENTS.mdAGENTS.md
- .agents/skills/AGENTS.mdAGENTS.md
- ai-text-to-speechSkill
- audio-denoiseSkill
- audio-fadeSkill
- audio-loudness-normalizationSkill
- audio-sample-rate-standardizeSkill
- audio-splitSkill
- audio-to-oggSkill
- audio-to-textSkill
- audio-to-wavSkill
- audio-trimSkill
- audio-volume-adjustSkill
- file-naming-normalizationSkill
- git-commit-messageSkill
- image-inpaint-regionSkill
- image-region-remove-key-color-appSkill
- image-remove-backgroundSkill
- image-remove-white-backgroundSkill
- image-resizeSkill
- image-sprite-sheet-splitSkill
- image-to-textSkill
- image-trimSkill
- storyboard-av-mixSkill
- storyboard-shot-to-htmlSkill
- storyboardSkill
- storyboard-ttsSkill
- video-4k-normalizationSkill
- video-bgmSkill
- video-compress-to-sizeSkill
- video-cutSkill
- video-merge-gpuSkill
- video-mergeSkill
- video-publishSkill
- video-remove-audioSkill
- video-to-4kSkill
- video-to-60fpsSkill
- video-to-mp4Skill
- video-to-ogvSkill
- video-to-wavSkill
The file
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 1 is distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 12
When this skill applies, read and follow dependency-manager — run scripts as documented, install missing tools into .dependency/.
- Very specific: line 14
Run convert.py through the bundled script — do not hand-write ffmpeg -i … commands.
- Very specific: line 35
Use bin/ffmpeg on Unix (no .exe).
- Distinctive: line 86
Use the bundled script, not hand-written FFmpeg commands.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Image to PNG
Convert a single image file to lossless PNG via FFmpeg. Defaults preserve source quality — dimensions unchanged, alpha channel kept when present.
Rules
When this skill applies, read and follow dependency-manager — run scripts as documented, install missing tools into .dependency/.
- Run
convert.pythrough the bundled script — do not hand-writeffmpeg -i …commands. - Single file only. Pass one image with
--image; directories are not supported. - Never overwrite source files. Output goes to
image-to-png/(or--output) by default. - Do not resize or recompress unless the user explicitly asks — omit quality/size overrides.
populated: falseforffmpegis not a reason to skip. Install first, setpopulated: true, retry the same command.
Setup (first run)
Download FFmpeg and extract to
.dependency/ffmpeg/(see dependency-manager).Windows result example:
.dependency/ffmpeg/bin/ffmpeg.exe- Register in
.dependency/manifest.json:
"ffmpeg": {
"populated": true,
"bin": ".dependency/ffmpeg/bin/ffmpeg.exe"
}Use bin/ffmpeg on Unix (no .exe).
Quick Start
Default: create an image-to-png/ folder beside the input file and write the PNG there:
# assets/ui/icon.webp → assets/ui/image-to-png/icon.png
.dependency/python/python .ai/image-to-png/convert.py --image assets/ui/icon.webpCustom output path:
.dependency/python/python .ai/image-to-png/convert.py --image assets/ui/icon.webp -o assets/ui_pngStrip alpha (RGB output):
.dependency/python/python .ai/image-to-png/convert.py --image assets/sprites/hero.webp --strip-alphaFormat Defaults
| Setting | Default | Notes |
| Dimensions | Preserve source | No resize unless user asks separately |
| Alpha | Preserve | RGBA when source has transparency |
| Already PNG | Stream copy | Bit-perfect when --strip-alpha is off |
| Animated GIF | First frame | Multi-frame GIF export not supported |
Defaults
| Option | Default | Notes |
--image | Required | Single supported image file |
| Output | <image-dir>/image-to-png/<name>.png | Use -o / --output for custom file or directory |
--strip-alpha | off | Force RGB PNG without alpha |
Supported inputs: .jpg, .jpeg, .png, .webp, .gif, .bmp, .tif, .tiff, .avif, .ico.
Agent Workflow
- Paths — Pass whatever image path the user gives. Output lands in
image-to-png/next to that file by default. - One file per run — convert one image, verify the result, then repeat for additional files if needed.
- Already PNG? Stream-copied by default (no generation loss) unless
--strip-alphais set. - Revert — delete output file or
git restore; sources are never modified.
Agent Notes
- Use the bundled script, not hand-written FFmpeg commands.
- Missing Python/FFmpeg → populate
.dependency/per dependency-manager, retry same command. - Do not copy, move, or replace the source with converted output — tell the user where the output file is.
- Need transparent cutouts → use image-remove-background, not this skill.
- Need resize after conversion → image-resize.
- FFmpeg codec and probing details: reference.md
Troubleshooting
| Issue | Fix |
ffmpeg missing in manifest | Follow Setup; update manifest |
Directory passed to --image | Run once per file; this skill accepts image files only |
| Output already exists | Delete the existing output or choose a different -o path |
| Animated GIF | Only first frame is exported by default |
| Need RGB only | Add --strip-alpha |
CLI
Copy-paste commands: cli/image-to-png.md
Related
- Resize after conversion: image-resize
- Transparent cutouts: image-remove-background
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

