ericrisco/rsc-harness / skills/fal
fal
VerifiedUse when calling a fal.ai endpoint by id to generate image, audio, or video from JS/Python/curl: subscribe vs submit, queue states, ED25519 webhook signature verification, per-call cost, or migrating off @fal-ai/serverless-client. NOT which model or art direction (that is ai-media); NOT the same models on another platform (that is replicate).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.5 KB |
| evals/README.md | markdown | 1.1 KB |
| evals/cases.yaml | config | 2.4 KB |
| references/models-and-cost.md | markdown | 2.7 KB |
| references/queue-and-webhooks.md | markdown | 6.0 KB |
| scripts/verify.shexecutable | script | 3.1 KB |
evals/cases.yaml
View on GitHubskill: fal
should_trigger:
- prompt: "Generate an image with fal-ai/flux/dev from this prompt and save the output URL"
why: Core synchronous generation against a fal endpoint id — the central use case.
- prompt: "Should I use subscribe or submit for a 30-second Veo video on fal?"
why: Call-mode decision; non-obvious — the right answer is submit + webhook, not subscribe or run.
- prompt: "My fal webhook signature verification keeps failing"
why: ED25519 / JWKS verification path; non-obvious failure that lives entirely in this skill.
- prompt: "How much will 500 Seedream images cost on fal, and is batch cheaper?"
why: Per-unit pricing estimate plus the 50% batch path.
- prompt: "Genera un vídeo con fal y recíbelo por webhook verificando la firma"
why: Spanish; submit + webhook + signature verification end to end.
- prompt: "Migrate our code off @fal-ai/serverless-client to the current fal client"
why: Deprecated-client migration is an explicit in-scope task.
should_not_trigger:
- prompt: "Which video model gives the best cinematic look for our ad?"
route_to: ai-media
why: Model choice and art direction, not the fal call mechanics.
- prompt: "Run this same FLUX model on Replicate instead"
route_to: replicate
why: Different platform with a different API (replicate.run / predictions).
- prompt: "Spin up an A100 pod I can SSH into and train on"
route_to: runpod
why: Raw GPU rental, not endpoint inference.
- prompt: "Deploy my own Python inference function as an autoscaling endpoint"
route_to: modal
why: Serving your own code, not calling fal's hosted endpoints.
capability:
- scenario: >
Given a FAL_KEY, a prompt, and a requirement to generate a long video and
receive it via webhook, produce the end-to-end flow.
must_include:
- "@fal-ai/client (or fal-client) install + FAL_KEY auth"
- "submit with webhook_url for the long job — NOT run/subscribe — with the why (no held connection / drop risk)"
- "webhook payload shape: request_id, status (OK/ERROR), payload (and payload_error case)"
- "ED25519 signature verification using the four X-Fal-Webhook-* headers and JWKS at rest.fal.ai/.well-known/jwks.json"
- "idempotent handler tolerating the 10-retries-over-2h duplicate deliveries (dedupe on request_id)"
- "reading the output URL from the result payload"
- "a per-second cost estimate and mention of the 50% batch path"
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |