# fal-ai

Guides your agent in configuring fal.ai serverless models for image, video, and real-time generation.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 301 repo stars
- Author: hoodini
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hoodini/ai-agents-skills/tree/HEAD/skills/fal-ai/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/fal-ai

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill fal-ai -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/fal-ai/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/fal-ai/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill fal-ai -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/fal-ai/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill fal-ai -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/fal-ai/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install hoodini/ai-agents-skills skills/fal-ai
```

2. **Manually: put the files in place**
- File: `.github/skills/fal-ai/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill fal-ai -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/hoodini/ai-agents-skills --path skills/fal-ai
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/fal-ai/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/hoodini/ai-agents-skills/tree/HEAD/skills/fal-ai/SKILL.md

## When to use it
- 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
- 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

## Similar
- [fal-generate](https://affpapa.org/en/nevibecode/skills/fal-generate.md) — skill · 2900 installs
- [fal-ai-media](https://affpapa.org/en/nevibecode/skills/fal-ai-media.md) — skill · 6400 installs
- [fal-kling-o3](https://affpapa.org/en/nevibecode/skills/fal-kling-o3.md) — skill · 2900 installs
- [fal-prompting](https://affpapa.org/en/nevibecode/skills/fal-prompting.md) — skill · 683 installs
- [fal-models-catalog](https://affpapa.org/en/nevibecode/skills/fal-models-catalog.md) — skill · 608 installs
- [invokeai-image-gen](https://affpapa.org/en/nevibecode/skills/invokeai-image-gen.md) — skill · ★ 173 repo stars

From the same set: [hoodini/ai-agents-skills](https://affpapa.org/en/nevibecode/by/hoodini/ai-agents-skills.md) — 34 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
