Skip to content

ericrisco/rsc-harness / skills/fal

Use 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).

FileKindSize
SKILL.mdskill md8.5 KB
evals/README.mdmarkdown1.1 KB
evals/cases.yamlconfig2.4 KB
references/models-and-cost.mdmarkdown2.7 KB
references/queue-and-webhooks.mdmarkdown6.0 KB
scripts/verify.shexecutablescript3.1 KB

evals/cases.yaml

View on GitHub
skill: 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"
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 implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall