Agent skill

Video To 4k

by godot-fun in godot-fun/gai

Upscales a single low-resolution video to 4K with Video2X (Real-ESRGAN), then encodes to unified 3840×2160 H.265 Main10 40Mbps + AAC 320kbps MP4.

MITAuto-check passedMedia & Creative

Install Video To 4k

skills CLI
$ npx skills add godot-fun/gai --skill video-to-4k -a claude-code

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

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

At a glance

Upscales a single low-resolution video to 4K with Video2X (Real-ESRGAN), then encodes to unified 3840×2160 H.265 Main10 40Mbps + AAC 320kbps MP4.

  • Works in 4 steps: Probe with ffprobe (width, height, fps,… → Already 4K? (width ≥ 3840 and height ≥… → Below 4K → Video2X Real-ESRGAN upscale… → …
  • The user wants video-to-4k
  • SKILL.md covers Pipeline, Rules, Setup (first run) and Quick Start, plus 4 more sections
  • Calls python

What it does

Video To 4k is an agent skill from godot-fun/gai. Upscales a single low-resolution video to 4K with Video2X (Real-ESRGAN), then encodes to unified 3840×2160 H.265 Main10 40Mbps + AAC 320kbps MP4. Source frame rate is preserved (no fps=60 duplication, no RIFE). Already-4K sources skip Video2X and go straight to FFmpeg. Use when the user wants video-to-4k, 4K upscale, UHD export, Video2X, Real-ESRGAN, H.265 Main10, or convert an SD/HD clip to 4K.

Its SKILL.md is about 1.2k 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 Image editing and Video production. 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 video-to-4k
  • Convert an SD/HD clip to 4K

Example prompts

  • “Use the video-to-4k skill to upscale a single low-resolution video to 4K with Video2X (Real-ESRGAN), then encodes to unified 3840×2160 H.265 Main10…”
  • “/video-to-4k”

Requirements

  • Python 3

Workflow steps

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

  1. Probe with ffprobe (width, height, fps, audio).
  2. Already 4K? (width ≥ 3840 and height ≥ 2160) → skip Video2X.
  3. Below 4K → Video2X Real-ESRGAN upscale (scale 2 or 4) to intermediate under video-to-4k/upscaled/.
  4. Always FFmpeg final encode → video-to-4k/ at the unified specs above.

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

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

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com
    • docs.video2x.org

    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

Video To 4k loads about 1.2k tokens when it runs. Until then it costs about 103 tokens; SKILL.md has 406 words of instructions outside code blocks.

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

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). 406 words, ~1,216 tokens.

Download SKILL.mdSave it as .claude/skills/video-to-4k/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
video-to-4k
description
Upscales a single low-resolution video to 4K with Video2X (Real-ESRGAN), then encodes to unified 3840×2160 H.265 Main10 40Mbps + AAC 320kbps MP4. Source frame rate is preserved (no fps=60 duplication, no RIFE). Already-4K sources skip Video2X and go straight to FFmpeg. Use when the user wants video-to-4k, 4K upscale, UHD export, Video2X, Real-ESRGAN, H.265 Main10, or convert an SD/HD clip to 4K.

Video to 4K

Convert a supported video to a unified 4K master:

SpecValue
Resolution3840×2160
Frame rateSource fps kept (no fps= filter, no RIFE)
VideoH.265 Main10 (libx265, yuv420p10le)
Video bitrate40 Mbps
AudioAAC 320 kbps
ContainerMP4 (.mp4, hvc1 tag)

Pipeline

  1. Probe with ffprobe (width, height, fps, audio).
  2. Already 4K? (width ≥ 3840 and height ≥ 2160) → skip Video2X.
  3. Below 4K → Video2X Real-ESRGAN upscale (scale 2 or 4) to intermediate under video-to-4k/upscaled/.
  4. Always FFmpeg final encode → video-to-4k/ at the unified specs above.

Rules

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

  • Run convert.py through .dependency/python/python. Never use host python / ffmpeg / video2x.
  • Never overwrite sources. Outputs go under video-to-4k/ (final) and video-to-4k/upscaled/ (Video2X intermediate).
  • Use the bundled script — do not hand-write equivalent video2x / ffmpeg commands.
  • One file per run — pass --video with a single file; repeat for each clip in a batch.

Setup (first run)

FFmpeg + Python

Populate ffmpeg and python under .dependency/ per skill-dependency-manager.

Video2X (CLI)

Download the CLI release (not the Qt6 installer) from video2x releases and extract to .dependency/video2x/:

PlatformRelease asset
Windowsvideo2x-windows-amd64.zip → video2x.exe
LinuxVideo2X-x86_64.AppImage (or distro package) → register as bin

Register in .dependency/manifest.json:

json
"video2x": {
  "populated": true,
  "bin": ".dependency/video2x/video2x.exe"
}

Use video2x (no .exe) or the AppImage path on Unix. Requires a Vulkan GPU and AVX2 CPU. Docs: Command Line.

Quick Start

bash
.dependency/python/python .ai/video-to-4k/convert.py --video path/to/clip.mp4

Example:

assets/video/clip.mp4
  → assets/video/video-to-4k/upscaled/clip.mkv   (Video2X, only if below 4K)
  → assets/video/video-to-4k/clip.mp4            (final master)

Already-4K source → only video-to-4k/clip.mp4 (FFmpeg only).

Anime / cartoon content (Real-ESRGAN anime model):

bash
.dependency/python/python .ai/video-to-4k/convert.py --video clip.mp4 --anime
Show full SKILL.md (168 more words)Show less

Defaults

SettingDefaultNotes
UpscalerReal-ESRGAN realesrgan-plusGeneral / live-action
--animerealesr-animevideov3Anime / illustration
ScaleAuto 2 or 4Smallest factor that meets or exceeds 4K
IntermediateHigh-bitrate HEVC MKV in video-to-4k/upscaled/Kept for re-encode; delete manually or --clean-upscaled
FinalAlways re-encodeEven if source already matches specs

Common Flags

--video · -o / --output · --anime · --gpu · --clean-upscaled

bash
.dependency/python/python .ai/video-to-4k/convert.py --video clip.mp4
.dependency/python/python .ai/video-to-4k/convert.py --video clip.mp4 --gpu 0 --clean-upscaled
.dependency/python/python .ai/video-to-4k/convert.py --video clip.mp4 -o out/clip.mp4

Never overwrite source files. Input must be a single video file (--video), not a directory. Supported inputs: .mp4, .mkv, .mov, .avi, .webm, .wmv, .flv, .m4v, .mpeg, .mpg, .ts, .mts, .m2ts, .3gp, .ogv.

Agent Notes

  1. Use the bundled script only.
  2. Missing Python / FFmpeg / Video2X → populate .dependency/, set populated: true, retry the same command.
  3. Tell the user where video-to-4k/ (and video-to-4k/upscaled/ if used) outputs are; they swap assets manually.
  4. Default model is general (realesrgan-plus). Pass --anime for anime/cartoon.
  5. Do not force fps. Keep the source frame rate. Need 60fps interpolation → video-to-60fps first (RIFE at source resolution).
  6. Pipeline / FFmpeg / Video2X details: reference.md

Tests

From repo root:

bash
.dependency/python/python .ai/video-to-4k/test_convert.py

Manual CLI examples: cli/video-to-4k.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/video-to-4k of godot-fun/gai.

  • SKILL.md
  • reference.md

Open the folder on GitHubat commit 6394686

Compare with similar skills

Video To 4k 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.

Video To 4k compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Video To 4k this skillgodot-fun/gai183—~1.2kAutomated safety check: PassMIT
Vox DirectorAlisa0808/vox-director2.2k—~5.6kAutomated safety check: PassMIT
Ffmpeg Skillkajisho5/ffmpeg-skill1.9k—~7.4kAutomated safety check: PassMIT
OpenStoryline Install HelperFireRedTeam/FireRed-OpenStoryline3.5k—~1.5kAutomated safety check: NotesApache-2.0
Cassette Video EditCassette-Editor/oh-my-cassette1191 repos~3.4kAutomated safety check: PassMIT
Whiteboard Videognipbao/codex-whiteboard-video-skill327—~7.2kAutomated safety check: NotesMIT

Similar skills

  • 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 5 days ago
    Media & CreativeAuto-check passed
  • Ffmpeg Skill

    kajisho5/ffmpeg-skill

    Edit video and audio with local FFmpeg from natural-language requests: cut, trim, join, resize/reframe (9:16, 1:1), speed change, captions and subtitles (SRT/ASS, animated, karaoke), logos and text…

    1.9k GitHub stars~7.4k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • OpenStoryline Install Helper

    FireRedTeam/FireRed-OpenStoryline

    Installs, repairs and starts a local source checkout of FireRed-OpenStoryline, from prerequisites and a venv to resources, config and the MCP and web servers.

    3.5k GitHub stars~1.5k tokensUpdated 2 mo ago
    Media & CreativeAuto-check: notes
  • Cassette Video Edit

    Cassette-Editor/oh-my-cassette

    Edit, trim, cut, caption, subtitle, reframe, combine, add background music to, or export video, audio, and image files through Cassette.

    119 GitHub starsUsed in 1 repo~3.4k tokens
    Media & CreativeAuto-check passed
  • Whiteboard Video

    gnipbao/codex-whiteboard-video-skill

    Generate smooth hand-drawn whiteboard and story videos directly inside Codex from text scripts, GPT Image 2 color storyboards, scene plans, SVGs, line art, or local images.

    327 GitHub stars~7.2k tokensUpdated 1 mo ago
    Media & CreativeAuto-check: notes
  • Muapi Director

    Anil-matcha/vox-ai-motion-graphics-generator

    Turn ONE topic, talking-head video, or photo into a finished Vox-style paper-collage explainer / ad video on the MuAPI platform (api.muapi.ai) + local ffmpeg — script, collage keyframes, motion…

    246 GitHub stars~679 tokensUpdated 1 mo 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).

    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 Video To 4k

What does Video To 4k do?

Upscales a single low-resolution video to 4K with Video2X (Real-ESRGAN), then encodes to unified 3840×2160 H.265 Main10 40Mbps + AAC 320kbps MP4. Video To 4k is an agent skill from godot-fun/gai.265 Main10 40Mbps + AAC 320kbps MP4.

When should I use Video To 4k?

Video To 4k fits situations like: the user wants video-to-4k; convert an SD/HD clip to 4K.

How do I install Video To 4k in Claude Code?

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

How do I install Video To 4k in Codex?

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

Can I use Video To 4k 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 video-to-4k -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/video-to-4k, .gemini/skills/video-to-4k, .github/skills/video-to-4k and .opencode/skills/video-to-4k in your project.

What does Video To 4k need to run?

Going by SKILL.md and its folder, Video To 4k needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Video To 4k access the network?

SKILL.md names 2 domains. As links in the text: github.com and docs.video2x.org. This is read from the text; nothing was executed.

Is Video To 4k 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 Video To 4k use?

Video To 4k 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 Video To 4k use?

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

Skills that share tags, products or a category with Video To 4k: Vox Director (Alisa0808/vox-director, 2.2k stars), Ffmpeg Skill (kajisho5/ffmpeg-skill, 1.9k stars), OpenStoryline Install Helper (FireRedTeam/FireRed-OpenStoryline, 3.5k stars) and Cassette Video Edit (Cassette-Editor/oh-my-cassette, 119 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Video To 4k?

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.