skilld
All skills
artwist-polyakov avatar

/fal-ai-image

@e6ac39c
by Aleksandr Poliakovartwist-polyakov/polyakov-claude-skills205 stars
53

Generate/edit images via fal.ai. Supports Google Nano Banana Pro and OpenAI GPT Image 2 selected from config/.env. Supports reference images and strong text rendering. ALWAYS read SKILL.md before first use.

Ask your Agent

Use this Skill: https://skilld.dev/gh/artwist-polyakov/polyakov-claude-skills/fal-ai-image

This session only. Nothing lands on disk.

referencesMODELS.md

≈399 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Model Selection

The skill supports two fal-hosted image backends behind the same FAL_KEY:

Alias family Resolved endpoint Best for
nano-banana, google, gemini fal-ai/nano-banana-pro cheaper default runs, infographics, strong text rendering
gpt, openai openai/gpt-image-2 stronger prompt adherence, photorealism, precise editing

Selection precedence

The scripts resolve the active model in this order:

  1. CLI --model
  2. FAL_IMAGE_MODEL in config/.env
  3. FAL_IMAGE_PROVIDER in config/.env
  4. fallback to fal-ai/nano-banana-pro

This means:

  • old installs with only FAL_KEY still work
  • a single request can explicitly force GPT or Nano Banana
  • the agent should use --model when the user explicitly asks for a provider/model

Agent mapping rules

Treat these phrases as equivalent:

  • GPT, OpenAI, ChatGPT Images, GPT Image -> --model gpt
  • Nano Banana, Google, Gemini -> --model gemini

If the user does not mention the model explicitly, let the config decide.

Cost guidance

Nano Banana is the safer default for exploratory runs.

GPT Image 2 cost depends on:

  • quality
  • image_size
  • edit vs generate complexity

As of April 22, 2026, fal's GPT Image 2 playground shows common high-quality outputs roughly in the $0.15-$0.22 range depending on size. For rough planning, "about $0.18" is acceptable, but do not promise a fixed price without checking the live model page first.

Reference:

Source: SKILL.md on GitHub

Third-party checks

1 warning17d4 checks · Risk SAFE
  • Gen Agent Trust Hub17d

    The skill enables image generation and editing using the fal.ai API. It supports two model providers (Google Nano Banana and OpenAI GPT Image 2) and includes scripts for uploading local images and managing generation queues. The skill is well-structured, using POSIX-compliant shell scripts and Python for data manipulation. Security analysis identifies standard surface areas for indirect prompt injection and dynamic code execution used for utility tasks, but finds no malicious intent or high-risk vulnerabilities.

  • Socket17d

    No alerts

  • Snyk17d

    Risk: LOW · No issues

  • Runlayer7mo

    7/7 files flagged

Provenance

Signed by skilld at e6ac39c. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last week.

Activeupdated 5 months ago

README badge

README badge for artwist-polyakov/polyakov-claude-skills/fal-ai-image