Agent skill

Image To Png

by godot-fun in godot-fun/gai

Converts image files to PNG using FFmpeg while preserving dimensions and alpha.

MITAuto-check passedMedia & Creative

Install Image To Png

skills CLI
$ npx skills add godot-fun/gai --skill image-to-png -a claude-code

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

GitHub CLI
$ gh skill install godot-fun/gai image-to-png --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-to-png .claude/skills/image-to-png && 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-to-png
GitHub stars
183
Token cost
~1.1k tokens
SKILL.md length
428 words
Files
2
Skills in repo
36
Repo updated
First seen
Licence
MIT

At a glance

Converts image files to PNG using FFmpeg while preserving dimensions and alpha.

  • Works in 2 steps: Download FFmpeg and extract to… → Register in .dependency/manifest.json
  • The user wants to convert images to PNG
  • SKILL.md covers Rules, Setup (first run), Quick Start and Format Defaults, plus 6 more sections
  • Calls python, ffmpeg and git

What it does

Image To Png is an agent skill from godot-fun/gai. 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.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `reference.md`).

It sits in Media & Creative, covering Video production and Image editing. It works with FFmpeg. 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 convert images to PNG
  • Transcode JPG/WebP/GIF/BMP/TIFF to PNG
  • Export a game/UI texture as PNG
  • Mentions PNG conversion without background removal

Example prompts

  • “Use the image-to-png skill to convert image files to PNG using FFmpeg while preserving dimensions and alpha”
  • “/image-to-png”

Requirements

  • Python 3

Workflow steps

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

  1. Download FFmpeg and extract to .dependency/ffmpeg/ (see skill-dependency-manager).
  2. Register in .dependency/manifest.json

What it can do on your machine

Read from SKILL.md and the folder at commit 6394686. 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
    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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 To Png loads about 1.1k tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 428 words of instructions outside code blocks.

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

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 6394686, republished under its MIT licence (© godot-fun). 428 words, ~1,102 tokens.

Download SKILL.mdSave it as .claude/skills/image-to-png/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
image-to-png
description
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.

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 skill-dependency-manager — run scripts as documented, install missing tools into .dependency/.

  • Run convert.py through the bundled script — do not hand-write ffmpeg -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: false for ffmpeg is not a reason to skip. Install first, set populated: true, retry the same command.

Setup (first run)

  1. Download FFmpeg and extract to .dependency/ffmpeg/ (see skill-dependency-manager).

    Windows result example: .dependency/ffmpeg/bin/ffmpeg.exe

  2. Register in .dependency/manifest.json:

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:

bash
# assets/ui/icon.webp → assets/ui/image-to-png/icon.png
.dependency/python/python .ai/image-to-png/convert.py --image assets/ui/icon.webp

Custom output path:

bash
.dependency/python/python .ai/image-to-png/convert.py --image assets/ui/icon.webp -o assets/ui_png

Strip alpha (RGB output):

bash
.dependency/python/python .ai/image-to-png/convert.py --image assets/sprites/hero.webp --strip-alpha

Format Defaults

SettingDefaultNotes
DimensionsPreserve sourceNo resize unless user asks separately
AlphaPreserveRGBA when source has transparency
Already PNGStream copyBit-perfect when --strip-alpha is off
Animated GIFFirst frameMulti-frame GIF export not supported

Defaults

OptionDefaultNotes
--imageRequiredSingle supported image file
Output<image-dir>/image-to-png/<name>.pngUse -o / --output for custom file or directory
--strip-alphaoffForce RGB PNG without alpha

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

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

Agent Workflow

  1. Paths — Pass whatever image path the user gives. Output lands in image-to-png/ next to that file by default.
  2. One file per run — convert one image, verify the result, then repeat for additional files if needed.
  3. Already PNG? Stream-copied by default (no generation loss) unless --strip-alpha is set.
  4. Revert — delete output file or git restore; sources are never modified.

Agent Notes

  1. Use the bundled script, not hand-written FFmpeg commands.
  2. Missing Python/FFmpeg → populate .dependency/ per skill-dependency-manager, retry same command.
  3. Do not copy, move, or replace the source with converted output — tell the user where the output file is.
  4. Need transparent cutouts → use image-remove-background, not this skill.
  5. Need resize after conversion → image-resize.
  6. FFmpeg codec and probing details: reference.md

Troubleshooting

IssueFix
ffmpeg missing in manifestFollow Setup; update manifest
Directory passed to --imageRun once per file; this skill accepts image files only
Output already existsDelete the existing output or choose a different -o path
Animated GIFOnly first frame is exported by default
Need RGB onlyAdd --strip-alpha

CLI

Copy-paste commands: cli/image-to-png.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

SKILL.md and 1 other file in .agents/skills/image-to-png of godot-fun/gai.

  • SKILL.md
  • reference.md

Open the folder on GitHubat commit 6394686

Compare with similar skills

Image To Png 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 To Png compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Image To Png this skillgodot-fun/gai183—~1.1kAutomated safety check: PassMIT
Media Processingynulihao/AgentSkillOS618—~817Automated safety check: NotesMIT
API Medianodetool-ai/nodetool560—~1.9kAutomated safety check: PassAGPL-3.0
Video Understandcalesthio/OpenMontage66k—~841Automated safety check: PassAGPL-3.0
HyperFrames Video Entry Pointheygen-com/hyperframes60k3 repos~5.2kAutomated safety check: PassApache-2.0
Video Shotseternityspring/reelbench-skills8781 repos~1.8kAutomated safety check: NotesApache-2.0

Similar skills

  • Media Processing

    ynulihao/AgentSkillOS

    Process multimedia files with FFmpeg (video/audio encoding, conversion, streaming, filtering, hardware acceleration), ImageMagick (image manipulation, format conversion, batch processing, effects…

    618 GitHub stars~817 tokensUpdated 7 mo ago
    Media & CreativeAuto-check: notes
  • API Media

    nodetool-ai/nodetool

    Call nodetool.media or nodetool.generations from a code action: generate or edit images, video, speech and music with a picked model, transcribe and embed, judge images with a vision model, read a…

    560 GitHub stars~1.9k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Video Understand

    calesthio/OpenMontage

    Understand video content locally using ffmpeg frame extraction and Whisper transcription.

    66k GitHub stars~841 tokensUpdated 7 days ago
    Media & CreativeAuto-check passed
  • HyperFrames Video Entry Point

    heygen-com/hyperframes

    Entry point for making, editing and rendering videos from HTML compositions with HyperFrames, routing each request to the right workflow.

    60k GitHub starsUsed in 3 repos~5.2k tokens
    Media & CreativeAuto-check passed
  • Video Shots

    eternityspring/reelbench-skills

    拉片:把一条成片拆成逐镜头的分析表——每个镜头的时长、景别、类别、运镜、画面. An agent skill from eternityspring/reelbench-skills.

    878 GitHub starsUsed in 1 repo~1.8k tokens
    Media & CreativeAuto-check: notes
  • Mobile Demo Film Editor

    superset-sh/superset

    Edits real mobile screen recordings into a configurable demo video with phone framing, title cards, cutaways and an end card, using a bundled renderer.

    15k GitHub stars~1.8k tokensUpdated today
    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).

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

    godot-fun/gai

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

    184 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.

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

    184 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.

    184 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.

    184 GitHub stars~554 tokensUpdated today
    Auto-check passed

Works with

Questions about Image To Png

What does Image To Png do?

Converts image files to PNG using FFmpeg while preserving dimensions and alpha. Image To Png is an agent skill from godot-fun/gai. Converts image files to PNG using FFmpeg while preserving dimensions and alpha.

When should I use Image To Png?

Image To Png fits situations like: the user wants to convert images to PNG; transcode JPG/WebP/GIF/BMP/TIFF to PNG; export a game/UI texture as PNG; mentions PNG conversion without background removal.

How do I install Image To Png in Claude Code?

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

How do I install Image To Png in Codex?

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

Can I use Image To Png 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-to-png -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-to-png, .gemini/skills/image-to-png, .github/skills/image-to-png and .opencode/skills/image-to-png in your project.

What does Image To Png need to run?

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

Does Image To Png access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Image To Png 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 To Png use?

Image To Png 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 To Png use?

About 1.1k tokens (SKILL.md is roughly 4.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 To Png?

Skills that share tags, products or a category with Image To Png: Media Processing (ynulihao/AgentSkillOS, 618 stars), API Media (nodetool-ai/nodetool, 560 stars), Video Understand (calesthio/OpenMontage, 66k stars) and HyperFrames Video Entry Point (heygen-com/hyperframes, 60k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Image To Png?

godot-fun (a GitHub organization) maintains it in godot-fun/gai, which has 183 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on October 10, 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.