Agent skill

Fal Upscale

Upscale and enhance image resolution using AI. An agent skill from CraftOS-dev/CraftBot.

Install Fal Upscale

skills CLI

$ npx skills add CraftOS-dev/CraftBot --skill fal-upscale -a claude-code

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

GitHub CLI

$ gh skill install CraftOS-dev/CraftBot fal-upscale --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/CraftOS-dev/CraftBot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/fal-upscale .claude/skills/fal-upscale && 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/

Paste into Claude Code

Install the "fal-upscale" agent skill from https://github.com/CraftOS-dev/CraftBot/tree/main/skills/fal-upscale into .claude/skills/fal-upscale/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "fal-upscale", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/CraftOS-dev/CraftBot/tree/main/skills/fal-upscale

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add CraftOS-dev/CraftBot --skill fal-upscale -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install CraftOS-dev/CraftBot fal-upscale --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/CraftOS-dev/CraftBot.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/fal-upscale .agents/skills/fal-upscale && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "fal-upscale" agent skill from https://github.com/CraftOS-dev/CraftBot/tree/main/skills/fal-upscale into .agents/skills/fal-upscale/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "fal-upscale", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add CraftOS-dev/CraftBot --skill fal-upscale -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install CraftOS-dev/CraftBot fal-upscale --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/CraftOS-dev/CraftBot.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/fal-upscale .cursor/skills/fal-upscale && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "fal-upscale" agent skill from https://github.com/CraftOS-dev/CraftBot/tree/main/skills/fal-upscale into .cursor/skills/fal-upscale/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "fal-upscale", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/CraftOS-dev/CraftBot.git --path skills/fal-upscale

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add CraftOS-dev/CraftBot --skill fal-upscale -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install CraftOS-dev/CraftBot fal-upscale --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/CraftOS-dev/CraftBot.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/fal-upscale .gemini/skills/fal-upscale && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "fal-upscale" agent skill from https://github.com/CraftOS-dev/CraftBot/tree/main/skills/fal-upscale into .gemini/skills/fal-upscale/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "fal-upscale", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install CraftOS-dev/CraftBot fal-upscale

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add CraftOS-dev/CraftBot --skill fal-upscale -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/CraftOS-dev/CraftBot.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/fal-upscale .github/skills/fal-upscale && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "fal-upscale" agent skill from https://github.com/CraftOS-dev/CraftBot/tree/main/skills/fal-upscale into .github/skills/fal-upscale/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "fal-upscale", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add CraftOS-dev/CraftBot --skill fal-upscale -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install CraftOS-dev/CraftBot fal-upscale --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/CraftOS-dev/CraftBot.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/fal-upscale .opencode/skills/fal-upscale && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "fal-upscale" agent skill from https://github.com/CraftOS-dev/CraftBot/tree/main/skills/fal-upscale into .opencode/skills/fal-upscale/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "fal-upscale", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: fal-upscale
GitHub stars: 392
Token cost: ~953 tokens
SKILL.md length: 180 words
Files: 2 (incl. scripts)
Skills in repo: 89
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Upscale and enhance image resolution using AI. An agent skill from CraftOS-dev/CraftBot.

Works in 4 steps: User provides image URL and optional… → Script selects appropriate upscaling model → Sends request to fal.ai API → …
The user requests Upscale image
SKILL.md covers How It Works, Image Upscale Models, Video Upscale Models and Usage, plus 5 more sections
Runs Shell scripts from its folder; calls bash and make; reaches v3.fal.media and fal.ai; needs FAL_KEY

What it does

Fal Upscale is an agent skill from CraftOS-dev/CraftBot. Upscale and enhance image resolution using AI. Use when the user requests "Upscale image", "Enhance resolution", "Make image bigger", "Increase quality", or similar upscaling tasks.

Its SKILL.md is about 950 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/upscale.sh`).

It sits in Media & Creative, covering Image editing. It works with fal. The repository describes itself as: One agent. Every kind of work. The licence is MIT.

When your agent uses it

The user requests Upscale image
Enhance resolution
Make image bigger
Increase quality

Example prompts

“Upscale image”
“Enhance resolution”
“Make image bigger”
“/fal-upscale”

Requirements

A Bash shell
A credential in FAL_KEY

Workflow steps

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

User provides image URL and optional scale factor
Script selects appropriate upscaling model
Sends request to fal.ai API
Returns upscaled image URL

What it can do on your machine

Read from SKILL.md and the folder at commit b50970c. 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
Ships 1 file in scripts/ (Shell), which the agent can run.
Shell commands in SKILL.md call:
- bash
- make
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- v3.fal.media
- fal.ai
- claude.ai
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- FAL_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Fal Upscale loads about 953 tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 180 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from CraftOS-dev/CraftBot at commit b50970c, republished under its MIT licence (© CraftOS-dev). 180 words, ~953 tokens.

Download SKILL.mdSave it as .claude/skills/fal-upscale/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: fal-upscale
description: Upscale and enhance image resolution using AI. Use when the user requests "Upscale image", "Enhance resolution", "Make image bigger", "Increase quality", or similar upscaling tasks.
metadata.author: fal-ai
metadata.version: 1.0.0

fal.ai Upscale

Upscale and enhance image resolution using state-of-the-art AI models.

How It Works

User provides image URL and optional scale factor
Script selects appropriate upscaling model
Sends request to fal.ai API
Returns upscaled image URL

Image Upscale Models

Model	Scale	Best For
`fal-ai/aura-sr`	4x	General upscaling, fast
`fal-ai/clarity-upscaler`	2-4x	Detail preservation
`fal-ai/creative-upscaler`	2-4x	Creative enhancement

Video Upscale Models

Model	Notes
`fal-ai/video-upscaler`	General purpose
`fal-ai/topaz/upscale/video`	Premium quality
`fal-ai/bria/video/increase-resolution`	Fast
`fal-ai/flashvsr`	Real-time
`fal-ai/seedvr/upscale/video`	High fidelity
`fal-ai/bytedance-upscaler`	Good balance
`fal-ai/simalabs/sima-video-upscaler-lite`	Lightweight

Usage

bash

bash /mnt/skills/user/fal-upscale/scripts/upscale.sh [options]

Arguments:

--image-url - URL of image to upscale (required)
--model - Model ID (defaults to fal-ai/aura-sr)
--scale - Upscale factor: 2 or 4 (default: 4)

Examples:

bash

# Image upscale with AuraSR (4x, fast)
bash /mnt/skills/user/fal-upscale/scripts/upscale.sh \
  --image-url "https://example.com/image.jpg"

# Image upscale with Clarity (detail preservation)
bash /mnt/skills/user/fal-upscale/scripts/upscale.sh \
  --image-url "https://example.com/image.jpg" \
  --model "fal-ai/clarity-upscaler" \
  --scale 2

# Video upscale (general purpose)
bash /mnt/skills/user/fal-upscale/scripts/upscale.sh \
  --video-url "https://example.com/video.mp4" \
  --model "fal-ai/video-upscaler"

# Video upscale (premium quality)
bash /mnt/skills/user/fal-upscale/scripts/upscale.sh \
  --video-url "https://example.com/video.mp4" \
  --model "fal-ai/topaz/upscale/video"

MCP Tool Alternative

If MCP tools are available, prefer using:

mcp__fal-ai__generate({
  modelId: "fal-ai/aura-sr",
  input: {
    image_url: "https://example.com/image.jpg"
  }
})

Output

Upscaling with fal-ai/aura-sr...
Upscale complete!

Image URL: https://v3.fal.media/files/abc123/upscaled.png
Original: 512x512
Upscaled: 2048x2048

JSON output:

json

{
  "image": {
    "url": "https://v3.fal.media/files/abc123/upscaled.png",
    "width": 2048,
    "height": 2048
  }
}

Present Results to User

Here's your upscaled image:

![Upscaled Image](https://v3.fal.media/files/...)

• 512×512 → 2048×2048 (4x)

Model Selection Guide

AuraSR (fal-ai/aura-sr)

Best for: Quick upscaling, general images
Speed: ~2 seconds
Fixed 4x scale

Clarity Upscaler (fal-ai/clarity-upscaler)

Best for: Preserving fine details
Speed: ~5 seconds
Configurable scale (2x or 4x)

Creative Upscaler (fal-ai/creative-upscaler)

Best for: Adding artistic detail
Speed: ~10 seconds
Enhances while upscaling

Troubleshooting

API Key Error

Error: FAL_KEY environment variable not set

To fix:
1. Get your API key from https://fal.ai/dashboard/keys
2. Set: export FAL_KEY=your_key_here

Image URL Error

Error: Could not fetch image from URL

Make sure:
1. The image URL is publicly accessible
2. The URL points directly to an image file
3. The image format is supported (JPEG, PNG, WebP)

Network Error

Network error. To fix on claude.ai:

1. Go to https://claude.ai/settings/capabilities
2. Add *.fal.ai to the allowed domains
3. Try again

Files

SKILL.md and 1 other file (scripts) in skills/fal-upscale of CraftOS-dev/CraftBot.

SKILL.md
scripts/upscale.sh

Open the folder on GitHubat commit b50970c

Compare with similar skills

Fal Upscale 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.

Fal Upscale compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Fal Upscale this skillCraftOS-dev/CraftBot	392	—	~953	Automated safety check: Pass	MIT	today
Fal AI Generationwitnesstodark/mr-mak-workspace	322	—	~1k	Automated safety check: Notes	MIT	2 days ago
Character Design with genmediafal-ai-community/skills	249	—	~1.3k	Automated safety check: Pass	None	8 days ago
Fal Image Editnexu-io/open-design	100k	—	~301	Automated safety check: Pass	Apache-2.0	today
Fal Upscalenexu-io/open-design	100k	—	~286	Automated safety check: Pass	Apache-2.0	today
Fal Video Editnexu-io/open-design	100k	—	~301	Automated safety check: Pass	Apache-2.0	today

Similar skills

Fal AI Generation
witnesstodark/mr-mak-workspace
Generate and edit images, create video, audio, 3D assets or material maps through fal.ai MCP or the Python queue client.
322 GitHub stars~1k tokensUpdated 2 days ago
Media & CreativeAuto-check: notes
Character Design with genmedia
fal-ai-community/skills
Builds consistent characters, reference and expression sheets, outfit variations and character-to-video shots with the genmedia CLI while keeping identity stable.
249 GitHub stars~1.3k tokensUpdated 8 days ago
Media & CreativeAuto-check passed
Fal Image Edit
nexu-io/open-design
AI-powered image editing with style transfer, background removal, object removal, and inpainting via fal.ai hosted models.
100k GitHub stars~301 tokensUpdated today
Media & CreativeAuto-check passed
Fal Upscale
nexu-io/open-design
Upscale and enhance image and video resolution using AI super-resolution models hosted on fal.ai.
100k GitHub stars~286 tokensUpdated today
Media & CreativeAuto-check passed
Fal Video Edit
nexu-io/open-design
Edit existing videos using AI — remix style, upscale, remove background, and add audio via fal.ai's hosted video models.
100k GitHub stars~301 tokensUpdated today
Media & CreativeAuto-check passed
Remix Graphic Ad From Reference
gooseworks-ai/goose-skills
Recreate a static graphic ad (Pinterest pin, IG/FB feed image, poster) from a reference image, swapping in a new brand's product and new copy while keeping the reference's layout, composition, and…
1.2k GitHub starsUsed in 1 repo~4.8k tokens
Media & CreativeAuto-check passed

Questions about Fal Upscale

What does Fal Upscale do?

Upscale and enhance image resolution using AI. An agent skill from CraftOS-dev/CraftBot. Fal Upscale is an agent skill from CraftOS-dev/CraftBot. Upscale and enhance image resolution using AI.

When should I use Fal Upscale?

Fal Upscale fits situations like: the user requests Upscale image; enhance resolution; make image bigger; increase quality.

How do I install Fal Upscale in Claude Code?

Run `npx skills add CraftOS-dev/CraftBot --skill fal-upscale -a claude-code`. Or copy the skill folder (skills/fal-upscale in CraftOS-dev/CraftBot) into .claude/skills/fal-upscale in your project. Claude Code loads it when a task matches its description.

How do I install Fal Upscale in Codex?

Run `npx skills add CraftOS-dev/CraftBot --skill fal-upscale -a codex`. Or copy the skill folder (skills/fal-upscale in CraftOS-dev/CraftBot) into .agents/skills/fal-upscale in your project. Codex loads it when a task matches its description.

Can I use Fal Upscale 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 CraftOS-dev/CraftBot --skill fal-upscale -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/fal-upscale, .gemini/skills/fal-upscale, .github/skills/fal-upscale and .opencode/skills/fal-upscale in your project.

What does Fal Upscale need to run?

Going by SKILL.md and its folder, Fal Upscale needs a shell for the scripts in its folder, the command-line tools its instructions call (bash and make) and credentials named FAL_KEY. Our summary lists: A Bash shell; A credential in FAL_KEY.

Does Fal Upscale access the network?

SKILL.md names 3 domains. In commands or code: v3.fal.media, fal.ai and claude.ai; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Fal Upscale 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Fal Upscale use?

Fal Upscale 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 Fal Upscale use?

About 953 tokens (SKILL.md is roughly 3.8k 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 Fal Upscale?

Skills that share tags, products or a category with Fal Upscale: Fal AI Generation (witnesstodark/mr-mak-workspace, 322 stars), Character Design with genmedia (fal-ai-community/skills, 249 stars), Fal Image Edit (nexu-io/open-design, 100k stars) and Fal Upscale (nexu-io/open-design, 100k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fal Upscale?

CraftOS-dev (a GitHub user) maintains it in CraftOS-dev/CraftBot, which has 392 GitHub stars. The repository holds 89 skills in this directory. The repository was last updated on October 7, 2026.

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

Install Fal Upscale

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

fal.ai Upscale

How It Works

Image Upscale Models

Video Upscale Models

Usage

MCP Tool Alternative

Output

Present Results to User

Model Selection Guide

Troubleshooting

API Key Error

Image URL Error

Network Error

Files

Compare with similar skills

Similar skills

More from CraftOS-dev/CraftBot

Related

Questions about Fal Upscale