fal.ai Skills
Agent skills for fal.ai. The default execution path is thegenmedia CLI: discover anendpoint, inspect its schema, run it, poll status when needed, and downloadoutputs. Most skills in this repo are knowledge layers that tell an agent whichendpoint 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.mdwithnameanddescriptionfrontmatter. - Larger skills may add
references/files for prompt patterns, endpointnotes, examples, or workflows. skills/index.jsonis the generated registry for the current skill folders.- User-facing model execution should go through
genmediaunless a skillexplicitly 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. |
Install
Use the one-command installation guide for Codex, Claude Codeand Cursor. It also documents hybrid MCP packages for Codex, Cursor and supportedGrok hosts: the fal router, five outcome workflows and live guidance on demand.The complete 36-skill library remains available for project installation and fullpackage builds. Claude MCP packages retain a full bundle by default.
Install the published Gemini CLI extension:
gemini extensions install https://github.com/fal-ai-community/fal-gemini-extension
The v0.1.0 releaseprovides complete Claude, CLI, Gemini and OpenClaw archives with checksums.The Grok/Cursor v0.2.0 releaseprovides the compact plugin; marketplace synchronization or review remains pending.
The official Registry entry, io.github.fal-ai-community/mcp,is active at version 0.1.0. Gemini gallery indexing remains pending.The Cline submissionawaits marketplace review. ClawHub publication awaits publisher sign-in andownership confirmation; no ClawHub package is published yet.
See the distribution guide for installation, publicationstatus and local bundle builds. The Cline guide covers its remoteconnection. Builders only export files; publication uses separate manual steps.
Complete creative outcomes
| Skill | Deliverable |
|---|---|
| product-ad-campaign | Hero art, channel variants, motion ads and campaign manifest |
| game-asset-production | Transparent frames, atlas, animation preview and engine import metadata |
| storyboard-to-short-film | Rendered film, clean cut, shot table and audio stems |
| ecommerce-product-photography | Consistent hero, detail and lifestyle images by SKU |
| localize-and-repurpose | Localized speech, timed captions and channel cuts |
Each includes a stage plan for the shared resumable runner in genmedia/scripts/.Production guidance imported from the fal agent lives with its version-pinnedreferences. See the source and compatibility inventory.The generated registry is the full skill list.
Development checks
python3 -m venv .venv
.venv/bin/pip install -r requirements-dev.txt
.venv/bin/python scripts/build-skills-index.py --check
.venv/bin/python -m unittest discover -s tests -v
Validation CI checks metadata, hashes, packaging, isolated installation, candidateschema fixtures and submission recovery. It publishes no release and runs no paidjobs. Registry publication uses a separate manual workflow.
Skill format
skills/
└── skill-name/
├── SKILL.md # YAML frontmatter (name, description) + body
└── references/ # optional, for umbrellas
└── *.md
License
MIT
