# AnIdeaLab fal skill

One skill that gives an AI agent every image, video, sound, voice and 3D model fal.ai hosts (1,480 on 16 Nov 2026), on the owner's own fal key. The agent finds a model and reads its inputs for free, reads the price before spending, runs it under the owner's spending cap, and brings the files back.

| Skill | What it does | Use it when |
|---|---|---|
| [fal](fal/SKILL.md) | Finds a model (`fal_find.py`, free, no key), reads its price and holds every batch to the owner's cap (`cap.txt`, shipped at 0 so nothing is spent until they set it), runs it and saves the files (`run_fal.py`). | Any ask to make or change a picture, a video clip, audio, a voice or a 3D model, or cheap concept pictures to pick a look from |

## Install (for the agent)
If someone sent you this pack, install it like this:

1. Download and unzip it: https://anidealab.com/skills/fal-skill.zip
   ```bash
   curl -fsSLO https://anidealab.com/skills/fal-skill.zip && unzip -o fal-skill.zip
   ```
2. Copy the `fal` folder, whole, into the folder where your skills live. Common places:
   - **A second brain or a repo with a `skills/` folder:** `skills/` (then add a line for it to your skills list, if you keep one).
   - **Claude Code:** `.claude/skills/` in the project, or `~/.claude/skills/` for every project.
   - **Codex and other agents that read `AGENTS.md`:** `.agents/skills/` or wherever your agent's docs say, or link `fal/SKILL.md` from your `AGENTS.md`.
   - **Claude.ai or the Claude app:** zip the `fal` folder and upload it in the app's skills settings.
3. Walk the person through "Set it up (once)" in `fal/SKILL.md`: a fal account with credit, their key in the environment as `FAL_KEY` (never pasted into the chat), and their spending cap in `cap.txt`.
4. Tell them it's installed, and that they can ask you to "make a picture of...", "turn this photo into a 5-second video" or "find me the cheapest model for...".

The skill is plain Markdown with a short header (`name`, `description`), so any agent can read it. The scripts need Python 3; `run_fal.py` installs `fal-client` with pip the first time it runs.

---
Made by [AnIdeaLab](https://anidealab.com). More free skills: https://anidealab.com/skills
