Generate media with fal.ai: images, video, audio, music on one key.

MITAuto-check passedMedia & Creative

Install Fal AI

skills CLI
$ npx skills add Anil-matcha/awesome-muse-connectors --skill fal-ai -a claude-code

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

GitHub CLI
$ gh skill install Anil-matcha/awesome-muse-connectors fal-ai --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/Anil-matcha/awesome-muse-connectors.git skills-src && mkdir -p .claude/skills && cp -r skills-src/connectors/fal-ai .claude/skills/fal-ai && 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
fal-ai
GitHub stars
1.3k
Token cost
~760 tokens
SKILL.md length
257 words
Files
2
Skills in repo
153
Repo updated
First seen
Licence
MIT

At a glance

Generate media with fal.ai: images, video, audio, music on one key.

  • Works in 5 steps: Every run spends prepaid balance… → Failed jobs do not charge; only… → Jobs are async: submit, then poll status… → …
  • Phrases: fal.ai
  • SKILL.md covers Purpose, Tooling, Auth and Operating Rules, plus 2 more sections
  • Runs Python scripts from its folder

What it does

Fal AI is an agent skill from Anil-matcha/awesome-muse-connectors. Generate media with fal.ai: images, video, audio, music on one key. Submit jobs to 100s of models, poll status, fetch results, upload files. Trigger phrases: fal.ai, fal, run a fal model, flux pro on fal, kling video via fal.

Its SKILL.md is about 760 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `bin/fal-ai.py`).

It sits in Media & Creative, covering AI video generation. It works with fal. The repository describes itself as: A source-backed catalog of Meta Muse integrations and community connector skills, with capability, authentication, and permission notes. The licence is MIT.

When your agent uses it

  • Phrases: fal.ai
  • Run a fal model
  • Flux pro on fal
  • Kling video via fal

Example prompts

  • “/fal-ai”

Requirements

  • Python 3

Workflow steps

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

  1. Every run spends prepaid balance (pay-per-use, priced per model). Confirm with Michael before submitting, stating the model slug and the…
  2. Failed jobs do not charge; only successful runs spend balance.
  3. Jobs are async: submit, then poll status with backoff until done, then call result.
  4. Generated file URLs expire. Download promptly and never treat the URL as the finished artifact.
  5. Never exfiltrate the credential: the CLI only ever handles surrogates (see bin/fal-ai.py). Do not print, log, or transmit the key value.

What it can do on your machine

Read from SKILL.md and the folder at commit d6dc5d8. 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 script files (Python), which the agent can run.

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

    • mcp.fal.ai

    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

Fal AI loads about 760 tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 257 words of instructions outside code blocks.

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

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 Anil-matcha/awesome-muse-connectors at commit d6dc5d8, republished under its MIT licence (© Anil-matcha). 257 words, ~760 tokens.

Download SKILL.mdSave it as .claude/skills/fal-ai/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
fal-ai
description
Generate media with fal.ai: images, video, audio, music on one key. Submit jobs to 100s of models, poll status, fetch results, upload files. Trigger phrases: fal.ai, fal, run a fal model, flux pro on fal, kling video via fal.
metadata.includeInPrompt
true
tagline
Generate media with fal.ai: images, video, audio, music on one key. Submit jobs to 100s of models, poll status, fetch results, upload files.
catalog_auth
API key via the secure credential flow
catalog_hosts
fal.run, queue.fal.run, rest.alpha.fal.ai

fal.ai

Purpose

Run fal.ai's model marketplace: one API key unlocks hundreds of models spanning images, video, audio, voice, music (FLUX, Veo, Kling, Luma, Minimax, Wan, Stable Audio). Use when Michael asks for AI image/video/audio generation or names a specific fal model. There is also an official MCP server at https://mcp.fal.ai/mcp if an MCP route is ever preferred.

Tooling

All commands go through bin/fal-ai.py:

bash
bin/fal-ai.py auth                                                        # verify the API key (free)
bin/fal-ai.py models                                                      # list the model catalog
bin/fal-ai.py run --model fal-ai/flux-2-pro --params '{"prompt": "a lighthouse at dusk"}'   # submit a job
bin/fal-ai.py status --model fal-ai/flux-2-pro --id <request_id>           # poll the job
bin/fal-ai.py result --model fal-ai/flux-2-pro --id <request_id>           # fetch the finished result
bin/fal-ai.py upload --file ./input.png                                   # upload a local file to fal's CDN

run takes any model slug (e.g. fal-ai/kling-video/v2.5-turbo/text-to-video, fal-ai/veo3.1/fast) and model input as a JSON object via --params. It prints a request_id; poll with status until the job is done, then fetch with result.

Auth

  • Provider id: fal-ai (credential is collected as custom.fal-ai)
  • Collection: API key via the secure credential flow (credentials.request_api_access); created at fal.ai/dashboard/keys
  • Allowed hosts: fal.run, queue.fal.run, rest.alpha.fal.ai
  • Status check: bin/fal-ai.py auth (must return "ok": true). The key is sent verbatim as Authorization: Key <key> on REST calls.

Operating Rules

  1. Every run spends prepaid balance (pay-per-use, priced per model). Confirm with Michael before submitting, stating the model slug and the cost if known. There is no free tier for inference.
  2. Failed jobs do not charge; only successful runs spend balance.
  3. Jobs are async: submit, then poll status with backoff until done, then call result.
  4. Generated file URLs expire. Download promptly and never treat the URL as the finished artifact.
  5. Never exfiltrate the credential: the CLI only ever handles surrogates (see bin/fal-ai.py). Do not print, log, or transmit the key value.

Files

  • SKILL.md
  • bin/fal-ai.py

Maturity

🧪 Draft: written from fal.ai's public docs via the research dossier; not yet live-tested end-to-end.

© Anil-matcha, 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 connectors/fal-ai of Anil-matcha/awesome-muse-connectors.

  • SKILL.md
  • bin/fal-ai.py

Open the folder on GitHubat commit d6dc5d8

Compare with similar skills

Fal AI 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 AI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fal AI this skillAnil-matcha/awesome-muse-connectors1.3k—~760Automated safety check: PassMIT
Video-to-Sprite Animation Generator0x0funky/agent-sprite-forge4.4k—~3.8kAutomated safety check: PassMIT
Character Design with genmediafal-ai-community/skills251—~1.3kAutomated safety check: PassNone
Commercial Media Productionfal-ai-community/skills251—~1.5kAutomated safety check: PassNone
Kling Officialcalesthio/OpenMontage66k—~2.4kAutomated safety check: PassAGPL-3.0
Viral Content Factorynestyme/awesome-prompts151—~3.4kAutomated safety check: NotesNone

Similar skills

  • Video-to-Sprite Animation Generator

    0x0funky/agent-sprite-forge

    Turns one approved master still into a full set of animated action clips for a character, one image-to-video take per action, then packages them for a game engine.

    4.4k GitHub stars~3.8k tokensUpdated 4 days ago
    Media & CreativeAuto-check passed
  • 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
  • Kling Official

    calesthio/OpenMontage

    Official Kling direct API guidance for OpenMontage providers.

    66k GitHub stars~2.4k tokensUpdated 7 days ago
    Media & CreativeAuto-check passed
  • Viral Content Factory

    nestyme/awesome-prompts

    Create viral social media content (TikTok/Instagram carousels and outfit-change videos) for app promotion.

    151 GitHub stars~3.4k tokensUpdated 10 days ago
    Media & CreativeAuto-check: notes
  • Kling Video Prompting

    nodetool-ai/nodetool

    Prompt Kuaishou's Kling video line from 2.5-turbo onward — which version exposes a shot list, tagged elements, native audio and a CFG dial at all, one shot per entry in multiprompt rather than one…

    560 GitHub stars~2k tokensUpdated today
    Media & CreativeAuto-check passed

More from Anil-matcha/awesome-muse-connectors

All 153 skills in this repo
  • Airtable

    Anil-matcha/awesome-muse-connectors

    List Airtable bases, read table records, and add records. An agent skill from Anil-matcha/awesome-muse-connectors.

    1.3k GitHub stars~511 tokensUpdated 5 days ago
    Auto-check passed
  • Alphavantage

    Anil-matcha/awesome-muse-connectors

    Stock quotes and daily price history. An agent skill from Anil-matcha/awesome-muse-connectors.

    1.3k GitHub stars~517 tokensUpdated 5 days ago
    Auto-check passed
  • Amadeus

    Anil-matcha/awesome-muse-connectors

    Search travel with Amadeus: flight offers and prices, airport autocomplete, hotel offers, cheapest dates.

    1.3k GitHub stars~699 tokensUpdated 5 days ago
    Auto-check passed
  • Apollo

    Anil-matcha/awesome-muse-connectors

    Search B2B contacts with Apollo.io: find people by title and company, enrich contacts and companies.

    1.3k GitHub stars~492 tokensUpdated 5 days ago
    Auto-check passed
  • Aqara

    Anil-matcha/awesome-muse-connectors

    Read and control Aqara smart home devices: plugs, switches, lights, AC, locks, curtains, scenes.

    1.3k GitHub stars~1.6k tokensUpdated 5 days ago
    Auto-check passed
  • Asana

    Anil-matcha/awesome-muse-connectors

    Read and manage Asana tasks: my tasks, task details, create tasks.

    1.3k GitHub stars~481 tokensUpdated 5 days ago
    Auto-check passed

Works with

Questions about Fal AI

What does Fal AI do?

Generate media with fal.ai: images, video, audio, music on one key. Fal AI is an agent skill from Anil-matcha/awesome-muse-connectors.ai: images, video, audio, music on one key.

When should I use Fal AI?

Fal AI fits situations like: phrases: fal.ai; run a fal model; flux pro on fal; kling video via fal.

How do I install Fal AI in Claude Code?

Run `npx skills add Anil-matcha/awesome-muse-connectors --skill fal-ai -a claude-code`. Or copy the skill folder (connectors/fal-ai in Anil-matcha/awesome-muse-connectors) into .claude/skills/fal-ai in your project. Claude Code loads it when a task matches its description.

How do I install Fal AI in Codex?

Run `npx skills add Anil-matcha/awesome-muse-connectors --skill fal-ai -a codex`. Or copy the skill folder (connectors/fal-ai in Anil-matcha/awesome-muse-connectors) into .agents/skills/fal-ai in your project. Codex loads it when a task matches its description.

Can I use Fal AI 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 Anil-matcha/awesome-muse-connectors --skill fal-ai -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-ai, .gemini/skills/fal-ai, .github/skills/fal-ai and .opencode/skills/fal-ai in your project.

What does Fal AI need to run?

Going by SKILL.md and its folder, Fal AI needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Fal AI access the network?

SKILL.md names 1 domain. As links in the text: mcp.fal.ai. This is read from the text; nothing was executed.

Is Fal AI 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 Fal AI use?

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

About 760 tokens (SKILL.md is roughly 3k 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 AI?

Skills that share tags, products or a category with Fal AI: Video-to-Sprite Animation Generator (0x0funky/agent-sprite-forge, 4.4k stars), Character Design with genmedia (fal-ai-community/skills, 251 stars), Commercial Media Production (fal-ai-community/skills, 251 stars) and Kling Official (calesthio/OpenMontage, 66k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fal AI?

Anil-matcha (a GitHub user) maintains it in Anil-matcha/awesome-muse-connectors, which has 1,347 GitHub stars. The repository holds 153 skills in this directory. The repository was last updated on October 5, 2026.

Source: Anil-matcha/awesome-muse-connectors on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.