Agent skill

Fal Text To Image

by LeoYeAI in LeoYeAI/openclaw-master-skills

Generate, remix, and edit images using fal.ai's AI models. An agent skill from LeoYeAI/openclaw-master-skills.

Install Fal Text To Image

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill fal-text-to-image -a claude-code

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

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills fal-text-to-image --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/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/fal-text-to-image .claude/skills/fal-text-to-image && 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-text-to-image" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/fal-text-to-image into .claude/skills/fal-text-to-image/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "fal-text-to-image", 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/LeoYeAI/openclaw-master-skills/tree/main/skills/fal-text-to-image

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 LeoYeAI/openclaw-master-skills --skill fal-text-to-image -a codex

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

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills fal-text-to-image --agent codex

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

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/fal-text-to-image .agents/skills/fal-text-to-image && 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-text-to-image" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/fal-text-to-image into .agents/skills/fal-text-to-image/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "fal-text-to-image", 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 LeoYeAI/openclaw-master-skills --skill fal-text-to-image -a cursor

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

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills fal-text-to-image --agent cursor

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

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/fal-text-to-image .cursor/skills/fal-text-to-image && 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-text-to-image" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/fal-text-to-image into .cursor/skills/fal-text-to-image/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "fal-text-to-image", 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/LeoYeAI/openclaw-master-skills.git --path skills/fal-text-to-image

--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 LeoYeAI/openclaw-master-skills --skill fal-text-to-image -a gemini-cli

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

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills fal-text-to-image --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/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/fal-text-to-image .gemini/skills/fal-text-to-image && 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-text-to-image" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/fal-text-to-image into .gemini/skills/fal-text-to-image/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "fal-text-to-image", 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 LeoYeAI/openclaw-master-skills fal-text-to-image

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 LeoYeAI/openclaw-master-skills --skill fal-text-to-image -a github-copilot

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

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/fal-text-to-image .github/skills/fal-text-to-image && 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-text-to-image" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/fal-text-to-image into .github/skills/fal-text-to-image/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "fal-text-to-image", 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 LeoYeAI/openclaw-master-skills --skill fal-text-to-image -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 LeoYeAI/openclaw-master-skills fal-text-to-image --agent opencode

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

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/fal-text-to-image .opencode/skills/fal-text-to-image && 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-text-to-image" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/fal-text-to-image into .opencode/skills/fal-text-to-image/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "fal-text-to-image", 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-text-to-image
GitHub stars: 2.2k
Token cost: ~5k tokens
SKILL.md length: 1,433 words
Files: 7 (incl. references)
Skills in repo: 1,235
Repo updated: Jul 20, 2026
First seen: Oct 9, 2026
Licence: MIT

At a glance

Generate, remix, and edit images using fal.ai's AI models. An agent skill from LeoYeAI/openclaw-master-skills.

Works in 3 steps: Text-to-Image (fal-text-to-image) → Image Remix (fal-image-remix) → Image Edit (fal-image-edit)
Tasks that involve Image generation
SKILL.md covers Three Modes of Operation, When to Use This Skill, Quick Start and Model Selection Guide, plus 6 more sections
Calls uv; needs FAL_KEY

What it does

Fal Text To Image is an agent skill from LeoYeAI/openclaw-master-skills. Generate, remix, and edit images using fal.ai's AI models. Supports text-to-image generation, image-to-image remixing, and targeted inpainting/editing.

Its SKILL.md is about 5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `CHEATSHEET.md`, `README.md` and `_meta.json`).

It sits in Media & Creative, covering Image generation. It works with fal. The repository describes itself as: 🧠 Curated collection of 1209+ best OpenClaw skills — weekly updated by MyClaw.ai. The licence is MIT.

When your agent uses it

Tasks that involve Image generation

Example prompts

“/fal-text-to-image”

Requirements

Python 3
A credential in FAL_KEY

Workflow steps

3 steps, taken from the step headings in SKILL.md.

Text-to-Image (fal-text-to-image)
Image Remix (fal-image-remix)
Image Edit (fal-image-edit)

What it can do on your machine

Read from SKILL.md and the folder at commit e5199b5. 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:
- uv
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):
- fal.ai
- docs.fal.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 Text To Image loads about 5k tokens when it runs, and up to ~8.9k if it reads all its reference files. Until then it costs about 42 tokens; SKILL.md has 1,433 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~42
When it runs · the whole SKILL.md, loaded when a task matches: ~5k
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~8.9k

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

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NoteMentions a .env fileSKILL.md:160

Or create a `.env` file in the skill directory:

NoteMentions a .env fileSKILL.md:221

t FAL_KEY environment variable or create .env file |

NoteMentions a .env fileSKILL.md:525

_KEY not set` | Export FAL_KEY or create .env file | All |

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 LeoYeAI/openclaw-master-skills at commit e5199b5, republished under its MIT licence (© LeoYeAI). 1,433 words, ~5,024 tokens.

Download SKILL.mdSave it as .claude/skills/fal-text-to-image/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.

name: fal-text-to-image
description: Generate, remix, and edit images using fal.ai's AI models. Supports text-to-image generation, image-to-image remixing, and targeted inpainting/editing.

fal.ai Image Generation & Editing Skill

Professional AI-powered image workflows using fal.ai's state-of-the-art models including FLUX, Recraft V3, Imagen4, and more.

Three Modes of Operation

1. Text-to-Image (fal-text-to-image)

Generate images from scratch using text prompts

2. Image Remix (fal-image-remix)

Transform existing images while preserving composition

3. Image Edit (fal-image-edit)

Targeted inpainting and masked editing

When to Use This Skill

Trigger when user:

Requests image generation from text descriptions
Wants to transform/remix existing images with AI
Needs to edit specific regions of images (inpainting)
Wants to create images with specific styles (vector, realistic, typography)
Needs high-resolution professional images (up to 2K)
Wants to use a reference image for style transfer
Mentions specific models like FLUX, Recraft, or Imagen
Asks for logo, poster, or brand-style image generation
Needs object removal or targeted modifications

Quick Start

Text-to-Image: Generate from Scratch

bash

# Basic generation
uv run python fal-text-to-image "A cyberpunk city at sunset with neon lights"

# With specific model
uv run python fal-text-to-image -m flux-pro/v1.1-ultra "Professional headshot"

# With style reference
uv run python fal-text-to-image -i reference.jpg "Mountain landscape" -m flux-2/lora/edit

Image Remix: Transform Existing Images

bash

# Transform style while preserving composition
uv run python fal-image-remix input.jpg "Transform into oil painting"

# With strength control (0.0=original, 1.0=full transformation)
uv run python fal-image-remix photo.jpg "Anime style character" --strength 0.6

# Premium quality remix
uv run python fal-image-remix -m flux-1.1-pro image.jpg "Professional portrait"

Image Edit: Targeted Modifications

bash

# Edit with mask image (white=edit area, black=preserve)
uv run python fal-image-edit input.jpg mask.png "Replace with flowers"

# Auto-generate mask from text
uv run python fal-image-edit input.jpg --mask-prompt "sky" "Make it sunset"

# Remove objects
uv run python fal-image-edit photo.jpg mask.png "Remove object" --strength 1.0

# General editing (no mask)
uv run python fal-image-edit photo.jpg "Enhance lighting and colors"

Model Selection Guide

The script intelligently selects the best model based on task context:

flux-pro/v1.1-ultra (Default for High-Res)

Best for: Professional photography, high-resolution outputs (up to 2K)
Strengths: Photo realism, professional quality
Use when: User needs publication-ready images
Endpoint: fal-ai/flux-pro/v1.1-ultra

recraft/v3/text-to-image (SOTA Quality)

Best for: Typography, vector art, brand-style images, long text
Strengths: Industry-leading benchmark scores, precise text rendering
Use when: Creating logos, posters, or text-heavy designs
Endpoint: fal-ai/recraft/v3/text-to-image

flux-2 (Best Balance)

Best for: General-purpose image generation
Strengths: Enhanced realism, crisp text, native editing
Use when: Standard image generation needs
Endpoint: fal-ai/flux-2

flux-2/lora (Custom Styles)

Best for: Domain-specific styles, fine-tuned variations
Strengths: Custom style adaptation
Use when: User wants specific artistic styles
Endpoint: fal-ai/flux-2/lora

flux-2/lora/edit (Style Transfer)

Best for: Image-to-image editing with style references
Strengths: Specialized style transfer
Use when: User provides reference image with -i flag
Endpoint: fal-ai/flux-2/lora/edit

imagen4/preview (Google Quality)

Best for: High-quality general images
Strengths: Google's highest quality model
Use when: User specifically requests Imagen or Google models
Endpoint: fal-ai/imagen4/preview

stable-diffusion-v35-large (Typography & Style)

Best for: Complex prompts, typography, style control
Strengths: Advanced prompt understanding, resource efficiency
Use when: Complex multi-element compositions
Endpoint: fal-ai/stable-diffusion-v35-large

ideogram/v2 (Typography Specialist)

Best for: Posters, logos, text-heavy designs
Strengths: Exceptional typography, realistic outputs
Use when: Text accuracy is critical
Endpoint: fal-ai/ideogram/v2

bria/text-to-image/3.2 (Commercial Safe)

Best for: Commercial projects requiring licensed training data
Strengths: Safe for commercial use, excellent text rendering
Use when: Legal/licensing concerns matter
Endpoint: fal-ai/bria/text-to-image/3.2

Command-Line Interface

bash

uv run python fal-text-to-image [OPTIONS] PROMPT

Arguments:
  PROMPT                    Text description of the image to generate

Options:
  -m, --model TEXT         Model to use (see model list above)
  -i, --image TEXT         Path or URL to reference image for style transfer
  -o, --output TEXT        Output filename (default: generated_image.png)
  -s, --size TEXT          Image size (e.g., "1024x1024", "landscape_16_9")
  --seed INTEGER           Random seed for reproducibility
  --steps INTEGER          Number of inference steps (model-dependent)
  --guidance FLOAT         Guidance scale (higher = more prompt adherence)
  --help                   Show this message and exit

Authentication Setup

Before first use, set your fal.ai API key:

bash

export FAL_KEY="your-api-key-here"

Or create a .env file in the skill directory:

env

FAL_KEY=your-api-key-here

Get your API key from: https://fal.ai/dashboard/keys

Advanced Examples

High-Resolution Professional Photo

bash

uv run python fal-text-to-image \
  -m flux-pro/v1.1-ultra \
  "Professional headshot of a business executive in modern office" \
  -s 2048x2048

Logo/Typography Design

bash

uv run python fal-text-to-image \
  -m recraft/v3/text-to-image \
  "Modern tech startup logo with text 'AI Labs' in minimalist style"

Style Transfer from Reference

bash

uv run python fal-text-to-image \
  -m flux-2/lora/edit \
  -i artistic_style.jpg \
  "Portrait of a woman in a garden"

Reproducible Generation

bash

uv run python fal-text-to-image \
  -m flux-2 \
  --seed 42 \
  "Futuristic cityscape with flying cars"

Model Selection Logic

The script automatically selects the best model when -m is not specified:

If -i provided: Uses flux-2/lora/edit for style transfer
If prompt contains typography keywords (logo, text, poster, sign): Uses recraft/v3/text-to-image
If prompt suggests high-res needs (professional, portrait, headshot): Uses flux-pro/v1.1-ultra
If prompt mentions vector/brand: Uses recraft/v3/text-to-image
Default: Uses flux-2 for general purpose

Output Format

Generated images are saved with metadata:

Filename includes timestamp and model name
EXIF data stores prompt, model, and parameters
Console displays generation time and cost estimate

Troubleshooting

Problem	Solution
`FAL_KEY not set`	Export FAL_KEY environment variable or create .env file
`Model not found`	Check model name against supported list
`Image reference fails`	Ensure image path/URL is accessible
`Generation timeout`	Some models take longer; wait or try faster model
`Rate limit error`	Check fal.ai dashboard for usage limits

Cost Optimization

Free tier: FLUX.2 offers 100 free requests (expires Dec 25, 2025)
Pay per use: FLUX Pro charges per megapixel
Budget option: Use flux-2 or stable-diffusion-v35-large for general use
Premium: Use flux-pro/v1.1-ultra only when high-res is required

Image Remix: Model Selection Guide

Available models for image-to-image remixing:

flux-2/dev (Default, Free)

Best for: General remixing, style transfer, fast iteration
Strengths: Balanced quality/speed, 100 free requests
Use when: Standard remixing needs
Endpoint: fal-ai/flux/dev/image-to-image

flux-pro (Premium Quality)

Best for: Professional remixing, high-quality outputs
Strengths: Superior quality, realistic transformations
Use when: Professional or publication-ready remixes
Endpoint: fal-ai/flux-pro

flux-1.1-pro (Ultra Premium)

Best for: Highest quality remixing with maximum detail
Strengths: Ultra-high quality, exceptional detail preservation
Use when: Premium projects requiring best possible output
Endpoint: fal-ai/flux-pro/v1.1

recraft/v3 (Vector/Illustration)

Best for: Vector style, brand imagery, illustration remixing
Strengths: Clean vector outputs, brand-style transformations
Use when: Converting to illustration or vector style
Endpoint: fal-ai/recraft/v3/text-to-image

stable-diffusion-v35 (Artistic)

Best for: Artistic styles, painting effects, creative remixing
Strengths: Strong artistic style application
Use when: Artistic or stylized transformations
Endpoint: fal-ai/stable-diffusion-v35-large

Image Remix: Command-Line Interface

bash

uv run python fal-image-remix [OPTIONS] INPUT_IMAGE PROMPT

Arguments:
  INPUT_IMAGE               Path or URL to source image
  PROMPT                    How to transform the image

Options:
  -m, --model TEXT         Model to use (auto-selected if not specified)
  -o, --output TEXT        Output filename (default: remixed_TIMESTAMP.png)
  -s, --strength FLOAT     Transformation strength 0.0-1.0 (default: 0.75)
                           0.0 = preserve original, 1.0 = full transformation
  --guidance FLOAT         Guidance scale (default: 7.5)
  --seed INTEGER           Random seed for reproducibility
  --steps INTEGER          Number of inference steps
  --help                   Show help

Remix Strength Guide

The --strength parameter controls transformation intensity:

Strength	Effect	Use Case
0.3-0.5	Subtle changes	Minor color adjustments, lighting tweaks
0.5-0.7	Moderate changes	Style hints while preserving details
0.7-0.85	Strong changes	Clear style transfer, significant transformation
0.85-1.0	Maximum changes	Complete style overhaul, dramatic transformation

Remix Examples

bash

# Subtle artistic style (low strength)
uv run python fal-image-remix photo.jpg "Oil painting style" --strength 0.4

# Balanced transformation (default)
uv run python fal-image-remix input.jpg "Cyberpunk neon aesthetic"

# Strong transformation (high strength)
uv run python fal-image-remix portrait.jpg "Anime character" --strength 0.9

# Vector conversion
uv run python fal-image-remix -m recraft/v3 logo.png "Clean vector illustration"

# Premium quality remix
uv run python fal-image-remix -m flux-1.1-pro photo.jpg "Professional studio portrait"

Image Edit: Model Selection Guide

Available models for targeted editing and inpainting:

flux-2/redux (General Editing)

Best for: General image editing without masks
Strengths: Fast, balanced, good for overall adjustments
Use when: No specific region targeting needed
Endpoint: fal-ai/flux-2/redux

flux-2/fill (Inpainting, Default)

Best for: Masked region editing, object removal, filling
Strengths: Seamless inpainting, natural blending
Use when: Editing specific masked regions
Endpoint: fal-ai/flux-2/fill

flux-pro-v11/fill (Premium Inpainting)

Best for: Professional inpainting with highest quality
Strengths: Superior quality, professional results
Use when: Premium quality inpainting required
Endpoint: fal-ai/flux-pro-v11/fill

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

stable-diffusion-v35/inpainting (Artistic Inpainting)

Best for: Artistic edits, creative inpainting
Strengths: Strong artistic control, detailed generation
Use when: Artistic or stylized edits
Endpoint: fal-ai/stable-diffusion-v35-large/inpainting

ideogram/v2/edit (Realistic Editing)

Best for: Realistic modifications, precise edits
Strengths: High realism, precise control
Use when: Realistic edits required
Endpoint: fal-ai/ideogram/v2/edit

recraft/v3/svg (Vector Editing)

Best for: Vector style edits, clean illustrations
Strengths: Clean vector outputs, illustration style
Use when: Vector or illustration edits
Endpoint: fal-ai/recraft/v3/svg

Image Edit: Command-Line Interface

bash

uv run python fal-image-edit [OPTIONS] INPUT_IMAGE [MASK_IMAGE] PROMPT

Arguments:
  INPUT_IMAGE               Path or URL to source image
  MASK_IMAGE                Path or URL to mask (white=edit, black=preserve) [optional]
  PROMPT                    How to edit the masked region

Options:
  -m, --model TEXT         Model to use (auto-selected if not specified)
  -o, --output TEXT        Output filename (default: edited_TIMESTAMP.png)
  --mask-prompt TEXT       Generate mask from text (no mask image needed)
  -s, --strength FLOAT     Edit strength 0.0-1.0 (default: 0.95)
  --guidance FLOAT         Guidance scale (default: 7.5)
  --seed INTEGER           Random seed for reproducibility
  --steps INTEGER          Number of inference steps
  --help                   Show help

Edit Strength Guide

The --strength parameter controls edit intensity:

Strength	Effect	Use Case
0.5-0.7	Subtle edits	Minor touch-ups, color adjustments
0.7-0.9	Moderate edits	Clear modifications while blending naturally
0.9-1.0	Strong edits	Complete replacement, object removal

Creating Mask Images

Mask images define edit regions:

White (255): Areas to edit/modify
Black (0): Areas to preserve unchanged
Gray: Partial blending (proportional to brightness)

Create masks using:

Image editors (GIMP, Photoshop, Krita)
Paint tools (select and fill with white/black)
Text-based prompts (--mask-prompt flag)

Edit Examples

bash

# Edit with mask image
uv run python fal-image-edit photo.jpg mask.png "Replace with beautiful garden"

# Auto-generate mask from text
uv run python fal-image-edit landscape.jpg --mask-prompt "sky" "Make it sunset with clouds"

# Remove objects
uv run python fal-image-edit photo.jpg object_mask.png "Remove completely" --strength 1.0

# Seamless object insertion
uv run python fal-image-edit room.jpg region_mask.png "Add modern sofa" --strength 0.85

# General editing (no mask)
uv run python fal-image-edit -m flux-2/redux photo.jpg "Enhance lighting and saturation"

# Premium quality inpainting
uv run python fal-image-edit -m flux-pro-v11/fill image.jpg mask.png "Professional portrait background"

# Artistic modification
uv run python fal-image-edit -m stable-diffusion-v35/inpainting photo.jpg mask.png "Van Gogh style"

File Structure

fal-text-to-image/
├── SKILL.md                    # This file
├── README.md                   # Quick reference
├── pyproject.toml              # Dependencies (uv)
├── fal-text-to-image           # Text-to-image generation script
├── fal-image-remix             # Image-to-image remixing script
├── fal-image-edit              # Image editing/inpainting script
├── references/
│   └── model-comparison.md     # Detailed model benchmarks
└── outputs/                    # Generated images (created on first run)

Dependencies

Managed via uv:

fal-client: Official fal.ai Python SDK
python-dotenv: Environment variable management
pillow: Image handling and EXIF metadata
click: CLI interface

Best Practices

General

Model Selection: Let scripts auto-select unless you have specific needs
Prompt Engineering: Be specific and descriptive for better outputs
Cost Awareness: Monitor usage on fal.ai dashboard
Reproducibility: Use --seed for consistent results during iteration

Text-to-Image

Reference Images: Use high-quality references for best style transfer results
Size Selection: Match aspect ratio to intended use (square, landscape, portrait)
Model Choice: Use recraft/v3 for typography, flux-pro for professional photography

Image Remix

Strength Tuning: Start with default (0.75), adjust based on desired transformation
Source Quality: Higher quality source images produce better remixes
Iteration: Use --seed to iterate on same generation with different prompts
Balance: Lower strength preserves more detail, higher creates more dramatic changes

Image Edit

Mask Quality: Clean, well-defined masks produce better results
Mask Creation: Use image editors for precise control, --mask-prompt for quick tests
Blending: Use gray tones in masks for smooth transitions
Edit Strength: Use 0.95+ for object removal, 0.7-0.9 for modifications
Test First: Try --mask-prompt before creating detailed masks
Multiple Edits: Edit in stages rather than all at once for complex modifications

Resources

fal.ai Documentation: https://docs.fal.ai/
Model Playground: https://fal.ai/explore/search
API Keys: https://fal.ai/dashboard/keys
Pricing: https://fal.ai/pricing

Workflow Examples

Complete Image Creation Pipeline

bash

# 1. Generate base image
uv run python fal-text-to-image -m flux-2 "Modern office space, minimalist" -o base.png

# 2. Remix to different style
uv run python fal-image-remix base.png "Cyberpunk aesthetic with neon" -o styled.png

# 3. Edit specific region
uv run python fal-image-edit styled.png --mask-prompt "desk" "Add holographic display"

bash

# Generate with seed for reproducibility
uv run python fal-text-to-image "Mountain landscape" --seed 42 -o v1.png

# Remix with same seed, different style
uv run python fal-image-remix v1.png "Oil painting style" --seed 42 -o v2.png

# Fine-tune with editing
uv run python fal-image-edit v2.png --mask-prompt "sky" "Golden hour lighting" --seed 42

Object Removal and Replacement

bash

# 1. Remove unwanted object
uv run python fal-image-edit photo.jpg object_mask.png "Remove" --strength 1.0 -o removed.png

# 2. Fill with new content
uv run python fal-image-edit removed.png region_mask.png "Beautiful flowers" --strength 0.9

Troubleshooting

Problem	Solution	Tool
`FAL_KEY not set`	Export FAL_KEY or create .env file	All
`Model not found`	Check model name in documentation	All
`Image upload fails`	Check file exists and is readable	Remix, Edit
`Mask not working`	Verify mask is grayscale PNG (white=edit)	Edit
`Transformation too strong`	Reduce --strength value	Remix, Edit
`Transformation too weak`	Increase --strength value	Remix, Edit
`Mask-prompt not precise`	Create manual mask in image editor	Edit
`Generation timeout`	Try faster model or wait longer	All
`Rate limit error`	Check fal.ai dashboard usage limits	All

Limitations

General

Requires active fal.ai API key
Subject to fal.ai rate limits and quotas
Internet connection required
Some models have usage costs (check pricing)

Text-to-Image

Image reference features limited to specific models
Typography quality varies by model

Image Remix

Source image quality affects output quality
Extreme strength values may introduce artifacts
Some styles work better with specific models

Image Edit

Mask quality critical for seamless results
Auto-generated masks (--mask-prompt) less precise than manual masks
Complex edits may require multiple passes
Some models don't support all editing features

Files

SKILL.md and 6 other files (references) in skills/fal-text-to-image of LeoYeAI/openclaw-master-skills.

SKILL.md
CHEATSHEET.md
README.md
_meta.json
pyproject.toml
references/model-comparison.md
references/usage-examples.md

Open the folder on GitHubat commit e5199b5

Compare with similar skills

Fal Text To Image 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 Text To Image compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Fal Text To Image this skillLeoYeAI/openclaw-master-skills	2.2k	—	~5k	Automated safety check: Notes	MIT	2 mo ago
Character Design with genmediafal-ai-community/skills	251	—	~1.3k	Automated safety check: Pass	None	12 days ago
Commercial Media Productionfal-ai-community/skills	251	—	~1.5k	Automated safety check: Pass	None	12 days ago
Fal Imagerefly-ai/refly-skills	204	—	~847	Automated safety check: Pass	None	2 mo ago
Fal Promptingfal-ai-community/skills	251	—	~688	Automated safety check: Pass	None	12 days ago
Fal Kling O3nexu-io/open-design	100k	—	~275	Automated safety check: Pass	Apache-2.0	yesterday

Similar skills

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.
251 GitHub stars~1.3k tokensUpdated 12 days ago
Media & CreativeAuto-check passed
Commercial Media Production
fal-ai-community/skills
Plans and runs commercial image and video production with the genmedia CLI: product shots, ads, e-commerce batches, product reveals and background replacement.
251 GitHub stars~1.5k tokensUpdated 12 days ago
Media & CreativeAuto-check passed
Fal Image
refly-ai/refly-skills
Generate AI images using Fal.ai Flux models. An agent skill from refly-ai/refly-skills.
204 GitHub stars~847 tokensUpdated 2 mo ago
Media & CreativeAuto-check passed
Fal Prompting
fal-ai-community/skills
Model-family-specific prompt craft for fal.ai endpoints. An agent skill from fal-ai-community/skills.
251 GitHub stars~688 tokensUpdated 12 days ago
Media & CreativeAuto-check passed
Fal Kling O3
nexu-io/open-design
Generate images and videos with Kling O3 — Kling's most powerful model family — via fal.ai.
100k GitHub stars~275 tokensUpdated yesterday
Media & CreativeAuto-check passed
Fal Realtime
nexu-io/open-design
Real-time and streaming AI image generation via fal.ai. An agent skill from nexu-io/open-design.
100k GitHub stars~302 tokensUpdated yesterday
Media & CreativeAuto-check passed

Questions about Fal Text To Image

What does Fal Text To Image do?

Generate, remix, and edit images using fal.ai's AI models. An agent skill from LeoYeAI/openclaw-master-skills. Fal Text To Image is an agent skill from LeoYeAI/openclaw-master-skills.ai's AI models.

When should I use Fal Text To Image?

Fal Text To Image fits situations like: tasks that involve Image generation.

How do I install Fal Text To Image in Claude Code?

Run `npx skills add LeoYeAI/openclaw-master-skills --skill fal-text-to-image -a claude-code`. Or copy the skill folder (skills/fal-text-to-image in LeoYeAI/openclaw-master-skills) into .claude/skills/fal-text-to-image in your project. Claude Code loads it when a task matches its description.

How do I install Fal Text To Image in Codex?

Run `npx skills add LeoYeAI/openclaw-master-skills --skill fal-text-to-image -a codex`. Or copy the skill folder (skills/fal-text-to-image in LeoYeAI/openclaw-master-skills) into .agents/skills/fal-text-to-image in your project. Codex loads it when a task matches its description.

Can I use Fal Text To Image 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 LeoYeAI/openclaw-master-skills --skill fal-text-to-image -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-text-to-image, .gemini/skills/fal-text-to-image, .github/skills/fal-text-to-image and .opencode/skills/fal-text-to-image in your project.

What does Fal Text To Image need to run?

Going by SKILL.md and its folder, Fal Text To Image needs the command-line tools its instructions call (uv) and credentials named FAL_KEY. Our summary lists: Python 3; A credential in FAL_KEY.

Does Fal Text To Image access the network?

SKILL.md names 2 domains. As links in the text: fal.ai and docs.fal.ai. This is read from the text; nothing was executed.

Is Fal Text To Image safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Fal Text To Image use?

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

About 5k tokens (SKILL.md is roughly 20k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.8k tokens, read only when the agent opens those files.

What are the alternatives to Fal Text To Image?

Skills that share tags, products or a category with Fal Text To Image: Character Design with genmedia (fal-ai-community/skills, 251 stars), Commercial Media Production (fal-ai-community/skills, 251 stars), Fal Image (refly-ai/refly-skills, 204 stars) and Fal Prompting (fal-ai-community/skills, 251 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fal Text To Image?

LeoYeAI (a GitHub user) maintains it in LeoYeAI/openclaw-master-skills, which has 2,161 GitHub stars. The repository holds 1,235 skills in this directory. The repository was last updated on July 20, 2026.

Source: LeoYeAI/openclaw-master-skills 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 Text To Image

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 Image Generation & Editing Skill

Three Modes of Operation

1. Text-to-Image (fal-text-to-image)

2. Image Remix (fal-image-remix)

3. Image Edit (fal-image-edit)

When to Use This Skill

Quick Start

Text-to-Image: Generate from Scratch

Image Remix: Transform Existing Images

Image Edit: Targeted Modifications

Model Selection Guide

flux-pro/v1.1-ultra (Default for High-Res)

recraft/v3/text-to-image (SOTA Quality)

flux-2 (Best Balance)

flux-2/lora (Custom Styles)

flux-2/lora/edit (Style Transfer)

imagen4/preview (Google Quality)

stable-diffusion-v35-large (Typography & Style)

ideogram/v2 (Typography Specialist)

bria/text-to-image/3.2 (Commercial Safe)

Command-Line Interface

Authentication Setup

Advanced Examples

High-Resolution Professional Photo

Logo/Typography Design

Style Transfer from Reference

Reproducible Generation

Model Selection Logic

Output Format

Troubleshooting

Cost Optimization

Image Remix: Model Selection Guide

flux-2/dev (Default, Free)

flux-pro (Premium Quality)

flux-1.1-pro (Ultra Premium)

recraft/v3 (Vector/Illustration)

stable-diffusion-v35 (Artistic)

Image Remix: Command-Line Interface

Remix Strength Guide

Remix Examples

Image Edit: Model Selection Guide

flux-2/redux (General Editing)

flux-2/fill (Inpainting, Default)

flux-pro-v11/fill (Premium Inpainting)

stable-diffusion-v35/inpainting (Artistic Inpainting)

ideogram/v2/edit (Realistic Editing)

recraft/v3/svg (Vector Editing)

Image Edit: Command-Line Interface

Edit Strength Guide

Creating Mask Images

Edit Examples

File Structure

Dependencies

Best Practices

General

Text-to-Image

Image Remix

Image Edit

Resources

Workflow Examples

Complete Image Creation Pipeline

Iterative Refinement

Object Removal and Replacement

Troubleshooting