fal-ai — Claude Code skill: what it does, how to install
Guides your agent in configuring fal.ai serverless models for image, video, and real-time generation.
no license ★ 301 updated 2026-10-23
npx skills add hoodini/ai-agents-skills --skill fal-ai -a claude-codeWhat fal-ai does
This skill equips Claude Code with ready-to-use patterns for the @fal-ai/serverless-client TypeScript library. It covers configuration schemas for popular visual models, including Flux Dev, Schnell, Pro, SDXL, and Stable Diffusion 3, alongside video synthesis with Kling and Luma Dream Machine.
Included workflows show how to handle text-to-image, image editing with masks, ControlNet structural conditioning, and background cleanup via BiRefNet. The skill also details live WebSocket streaming for near-instant rendering and Next.js App Router proxy endpoints.
Calls will fail without an active FAL_KEY credential defined in your project environment.
What it helps with
- integrate Flux or SDXL image synthesis into a TypeScript project
- build a Next.js App Router proxy route for safe client-side generation
- generate short video clips with Kling Video or Luma Dream Machine
- apply inpainting masks and background removal to existing photos
Example prompts for the agent
- Set up a Flux Schnell image generation function with fal.ai
- Create a Next.js API route that proxies fal.ai requests
- Write an inpainting call using Flux Dev and a black-and-white mask
How to install fal-ai
1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill fal-ai -a claude-code2Manually: put the files in place
~/.claude/skills/fal-ai/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/fal-ai/
1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill fal-ai -a codex2Manually: put the files in place
.agents/skills/fal-ai/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill fal-ai -a cursor2Manually: put the files in place
.cursor/skills/fal-ai/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install hoodini/ai-agents-skills skills/fal-ai2Manually: put the files in place
.github/skills/fal-ai/SKILL.md1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill fal-ai -a gemini-cli2Platform CLI
gemini skills install https://github.com/hoodini/ai-agents-skills --path skills/fal-aiManually: put the files in place
.devin/skills/fal-ai/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about fal-ai
How to install fal-ai in Claude Code?
Run npx skills add hoodini/ai-agents-skills --skill fal-ai -a claude-code in your terminal.
What does the fal-ai skill do?
It gives Claude Code the necessary parameter schemas and TypeScript snippets to invoke fal.ai image, video, and editing models.
What credentials are required to use fal.ai?
You need a valid FAL_KEY environment variable and the @fal-ai/serverless-client package installed in your codebase.