fal.ai Skills

Agent skills for fal.ai. The default execution path is the genmedia CLI: discover an endpoint, inspect its schema, run it, poll status when needed, and download outputs. Most skills in this repo are knowledge layers that tell an agent which endpoint to use, how to prompt it, and how to chain calls.

Compatible with Claude.ai Projects, Claude Code, and other agent platforms supporting the community skills format.

Current system

Skills live directly under skills/<name>/.
Each skill has a required SKILL.md with name and description frontmatter.
Larger skills may add references/ files for prompt patterns, endpoint notes, examples, or workflows.
skills/index.json is the generated registry for the current skill folders.
User-facing model execution should go through genmedia unless a skill explicitly documents another workflow in its own folder.

Skills

Core

Skill	Purpose
genmedia	The CLI surface. `models`, `schema`, `run`, `status`, `upload`, `pricing`, `docs`. Every other skill calls genmedia for execution.
model-routing	Endpoint-first model defaults for production skills.

Umbrellas, knowledge organized by modality, family, or use case

Skill	Purpose
fal-models-catalog	Curated endpoint picks across 10 modalities (text-to-image, image-to-image, text-to-video, image-to-video, video-to-video, text-to-3d, image-to-3d, text-to-audio, audio-to-text, image-to-text).
fal-prompting	Family-specific prompt craft (Kling, GPT Image 2, Happy Horse).
fal-recipes	Use-case pipelines (cinematography, character design, commercial, storytelling, lipsync, restoration, virtual try-on, video with audio, product shot).

Production skills

Skill	Purpose
character-design	Original characters, identity anchors, reference consistency, and character-driven media.
cinematography	Cinematic stills and video direction: shot language, lighting, lens, color, and camera movement.
commercial	Product photography, ads, e-commerce batches, product reveal videos, and brand-safe product prompts.
marketing	Campaign matrices, launch kits, paid social variants, landing-page visuals, banners, and channel-specific marketing assets.
storytelling	Multi-shot narratives, storyboards, brand films, social stories, and sequence continuity.
ugc	Creator ads, talking-head clips, testimonials, demos, unboxing, reaction, faceless voiceover, and short vertical social videos.

Workflow and vertical skills

Skill	Purpose
fal-workflow	Multi-step pipelines. Mode A authors fal.ai workflow JSON; Mode B drives genmedia CLI orchestration.
fan-cam	Personalized live sports broadcast fan-cam videos from a user photo with GPT Image 2 and Kling v3.
fal-gamedev	2D pixel-art game assets: characters, sprite sheets, parallax and isometric backgrounds.
fal-redesign	Website redesign: screenshot review, vision-driven reference image, build spec, and implementation guidance.
fal-regenerate-3d	Interactive 3D character-selector experience with Three.js, Meshy, and Seedance.
genmedia-workflow	Genmedia-oriented workflow planning, node rules, pipeline patterns, and reusable recipes.

Setup

1. Get an API key

fal.ai/dashboard/keys

2. Install genmedia

Install genmedia from fal-ai-community/genmedia-cli, then run genmedia setup.

3. Install skills

Claude.ai: upload skill .zip files to your project from skills/.

Any project with genmedia installed:

genmedia init

Installs the default skill bundle into .agents/skills/ or .claude/skills/.

Skill format

skills/
└── skill-name/
 ├── SKILL.md # YAML frontmatter (name, description) + body
 └── references/ # optional, for umbrellas
 └── *.md

License

MIT