Agent skill

Fal AI Generation

by witnesstodark in witnesstodark/mr-mak-workspace

Generate and edit images, create video, audio, 3D assets or material maps through fal.ai MCP or the Python queue client.

MITAuto-check: notesMedia & Creative

Install Fal AI Generation

skills CLI
$ npx skills add witnesstodark/mr-mak-workspace --skill fal-ai-generation -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install witnesstodark/mr-mak-workspace fal-ai-generation --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/witnesstodark/mr-mak-workspace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/fal-ai-generation .claude/skills/fal-ai-generation && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
fal-ai-generation
GitHub stars
347
Token cost
~1k tokens
SKILL.md length
530 words
Files
10 (incl. scripts, references)
Skills in repo
19
Repo updated
First seen
Licence
MIT

At a glance

Generate and edit images, create video, audio, 3D assets or material maps through fal.ai MCP or the Python queue client.

  • Works in 5 steps: Inspect the selected input files. Upload… → Prepare inputs from the live schema.… → Prefer submit_job for long operations;… → …
  • Fal model discovery
  • SKILL.md covers Choose the operation, Run and retain the job and Included tools and examples
  • Runs Python scripts from its folder

What it does

Fal AI Generation is an agent skill from witnesstodark/mr-mak-workspace. Generate and edit images, create video, audio, 3D assets or material maps through fal.ai MCP or the Python queue client. Use for fal model discovery, reference uploads, generation, recovery and local delivery.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 12 other files, including scripts and reference files (for example `examples/WALKTHROUGH.md`, `examples/concept.json` and `examples/edit.json`).

It sits in Media & Creative, covering Image editing and Game assets and audio. It works with fal, Model Context Protocol and Python. The repository describes itself as: A local desktop workspace for Codex and Claude Code, with project reports, creative skills and optional voice. The licence is MIT.

When your agent uses it

  • Fal model discovery
  • Reference uploads
  • Recovery and local delivery

Example prompts

  • “/fal-ai-generation”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Inspect the selected input files. Upload only the references needed for the
  2. Prepare inputs from the live schema. Fields such as image_urls, image_url,
  3. Prefer submit_job for long operations; run_model is convenient for images.
  4. Continue with check_job, then get_job_result when complete. Prefer the
  5. Download the outputs before relying on a CDN link. Inspect each requested

What it can do on your machine

Read from SKILL.md and the folder at commit c7c9fbf. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Fal AI Generation loads about 1k tokens when it runs, and up to ~3.5k if it reads all its reference files. Until then it costs about 57 tokens; SKILL.md has 530 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~57
When it runs · the whole SKILL.md, loaded when a task matches
~1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:69
    e environment or an explicitly selected `.env`; never print their values.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from witnesstodark/mr-mak-workspace at commit c7c9fbf, republished under its MIT licence (© witnesstodark). 530 words, ~1,039 tokens.

Download SKILL.mdSave it as .claude/skills/fal-ai-generation/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
fal-ai-generation
description
Generate and edit images, create video, audio, 3D assets or material maps through fal.ai MCP or the Python queue client. Use for fal model discovery, reference uploads, generation, recovery and local delivery.

fal.ai generation

Turn the user's brief and supplied references into downloaded, reviewed assets. Use the connected fal.ai MCP when available. The included Python helper handles local uploads and queue recovery when MCP cannot access the local filesystem. This skill and its relative resources can be copied into another project.

Choose the operation

Distinguish concept exploration, faithful editing, reference-sheet preparation, motion generation, mesh generation and material creation. Preserve a selected provider, model, accepted image, pose, camera and requested output count. An edit changes the requested feature; it does not redesign the whole asset.

When no model is selected, call recommend_model with the actual task. Then read get_model_schema for the exact endpoint. Similar display names on different providers are not interchangeable endpoint IDs. Inspect pricing for the planned batch, especially video or 3D; use existing task authorization without asking again for already-approved work. Defaults in an old script are not a model choice.

Read MCP calls for parameter examples and recovery. Read prompting and review for concept, reference-edit and material decisions. Read setup when connecting another machine. Each recipient uses their own account and credentials.

Run and retain the job

  1. Inspect the selected input files. Upload only the references needed for the requested task. A hosted MCP cannot read a local Windows path: use the upload helper or a client-side upload tool, then pass the resulting URL.
  2. Prepare inputs from the live schema. Fields such as image_urls, image_url, aspect_ratio, image_size, resolution and duration differ by endpoint. Do not pass every model the same argument object. Do not add web search, background removal, extra views or video unless they serve this task.
  3. Prefer submit_job for long operations; run_model is convenient for images. Immediately save endpoint, request ID, returned status/result URLs and the input parameters in the task directory. processing is normal, not failure.
  4. Continue with check_job, then get_job_result when complete. Prefer the canonical URLs returned by the service. A wait timeout does not authorize a duplicate submission. A terminal result can still contain a provider error. If submission returned no ID, inspect request history before trying again.
  5. Download the outputs before relying on a CDN link. Inspect each requested asset, preserve rejected takes with their reasons, and make the chosen result easy to open and download. Record technical completion separately from visual acceptance. A generated mesh still needs its own rig/topology/export checks.
Show full SKILL.md (136 more words)Show less

Keep the prompt, source filenames or hashes, model ID, request ID, local outputs and review verdict together. Credentials and raw signed links do not belong in a shareable report. In Mr. Mak, use the current Workspace card and its shared image viewer; elsewhere use the recipient's requested output directory.

Included tools and examples

  • Queue helper: --help, upload, submit, status and result download. One receipt per job; an existing receipt blocks another submission.
  • Python dependencies.
  • Concept input and edit input: neutral requests, with no private artwork or working account URLs.
  • Example task: a non-spending rehearsal followed by the commands for an explicitly requested generation.

Resolve these paths against this skill directory. Run --help or submit --dry-run to check installation without a generation. Runtime keys come from the environment or an explicitly selected .env; never print their values.

© witnesstodark, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 9 other files (scripts, references) in .agents/skills/fal-ai-generation of witnesstodark/mr-mak-workspace.

  • SKILL.md
  • examples/WALKTHROUGH.md
  • examples/concept.json
  • examples/edit.json
  • references/mcp-workflow.md
  • references/prompting-and-review.md
  • references/setup.md
  • scripts/fal_job.py
  • scripts/requirements.txt
  • scripts/test_fal_job.py

Open the folder on GitHubat commit c7c9fbf

Compare with similar skills

Fal AI Generation next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Fal AI Generation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fal AI Generation this skillwitnesstodark/mr-mak-workspace347—~1kAutomated safety check: NotesMIT
2D Sprite Generator0x0funky/agent-sprite-forge4.4k—~3.6kAutomated safety check: PassMIT
Web Visualsglifxyz/glif-mcp-server213—~1.5kAutomated safety check: PassMIT
Scenario Texturesscenario-labs/skills946—~2kAutomated safety check: PassMIT
Fmodel Unpackpa001024/dna-builder137—~2.6kAutomated safety check: PassMIT
Make Imagesglifxyz/glif-mcp-server213—~931Automated safety check: PassMIT

Similar skills

  • 2D Sprite Generator

    0x0funky/agent-sprite-forge

    Produces game-ready 2D characters, creatures, props, icons and effects as master stills, sheets or clips, and exports frames for common game engines.

    4.4k GitHub stars~3.6k tokensUpdated 4 days ago
    Game DevelopmentAuto-check passed
  • Web Visuals

    glifxyz/glif-mcp-server

    Make images, textures, illustrations and background video for a website or app you are building, with Glif, and wire them into the code.

    213 GitHub stars~1.5k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Scenario Textures

    scenario-labs/skills

    A skill your agent uses when a task involves game textures or materials through the Scenario MCP: seamless or tileable textures, themed texture packs (brick, wood, stone, floors, hand-painted), PBR…

    946 GitHub stars~2k tokensUpdated today
    Game DevelopmentAuto-check passed
  • Fmodel Unpack

    pa001024/dna-builder

    This skill documents how to use the fmodel-mcp toolkit (a CUE4Parse-based .NET CLI plus a thin Python MCP server) to inspect and export Unreal Engine game assets — pak files, textures, meshes…

    137 GitHub stars~2.6k tokensUpdated today
    Game DevelopmentAuto-check passed
  • Make Images

    glifxyz/glif-mcp-server

    Make new still images from a brief with Glif and save them to a folder: concept art, a series of variations, mockups, posters, illustrations, wallpapers, reference boards or any picture that isn't…

    213 GitHub stars~931 tokensUpdated yesterday
    Game DevelopmentAuto-check passed
  • Fal Assets

    rehan-remade/universal-modder

    Generate game assets with fal (fal.ai) through the fal MCP server, the um fal CLI (REST) or fal api.

    6.1k GitHub stars~2k tokensUpdated today
    Game DevelopmentAuto-check: notes

More from witnesstodark/mr-mak-workspace

All 19 skills in this repo
  • Game Vfx Workflow

    witnesstodark/mr-mak-workspace

    Develop game effects from visual references and motion studies through an engine handoff, with event timing, lifecycle, readability and native review.

    347 GitHub stars~896 tokensUpdated yesterday
    Auto-check passed
  • Game Audio Workflow

    witnesstodark/mr-mak-workspace

    Build and review game sound banks, map chosen takes to real events, and prepare or verify runtime playback with timing, repetition and mix limits.

    347 GitHub stars~811 tokensUpdated yesterday
    Auto-check passed
  • Game Level Design

    witnesstodark/mr-mak-workspace

    Turn a game-level brief or existing scene snapshot into a reviewable spatial plan, then apply approved changes with coordinate, navigation and scene checks.

    347 GitHub stars~735 tokensUpdated yesterday
    Auto-check passed
  • Game UI Workflow

    witnesstodark/mr-mak-workspace

    Design and implement game HUDs, menus, icons and portrait systems from visual proposals through reusable engine assets and input checks.

    347 GitHub stars~867 tokensUpdated yesterday
    Auto-check passed
  • Gameplay Visual Review

    witnesstodark/mr-mak-workspace

    Verify a visual game change using controlled native captures, targeted behavioral checks and a reviewable evidence record.

    347 GitHub stars~720 tokensUpdated yesterday
    Auto-check passed
  • Blender Game Animation

    witnesstodark/mr-mak-workspace

    Rig and animate supplied characters in Blender, revise motion from references, and deliver editable sources plus a verified game export.

    347 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed

Questions about Fal AI Generation

What does Fal AI Generation do?

Generate and edit images, create video, audio, 3D assets or material maps through fal.ai MCP or the Python queue client. Fal AI Generation is an agent skill from witnesstodark/mr-mak-workspace.ai MCP or the Python queue client.

When should I use Fal AI Generation?

Fal AI Generation fits situations like: fal model discovery; reference uploads; recovery and local delivery.

How do I install Fal AI Generation in Claude Code?

Run `npx skills add witnesstodark/mr-mak-workspace --skill fal-ai-generation -a claude-code`. Or copy the skill folder (.agents/skills/fal-ai-generation in witnesstodark/mr-mak-workspace) into .claude/skills/fal-ai-generation in your project. Claude Code loads it when a task matches its description.

How do I install Fal AI Generation in Codex?

Run `npx skills add witnesstodark/mr-mak-workspace --skill fal-ai-generation -a codex`. Or copy the skill folder (.agents/skills/fal-ai-generation in witnesstodark/mr-mak-workspace) into .agents/skills/fal-ai-generation in your project. Codex loads it when a task matches its description.

Can I use Fal AI Generation in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add witnesstodark/mr-mak-workspace --skill fal-ai-generation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/fal-ai-generation, .gemini/skills/fal-ai-generation, .github/skills/fal-ai-generation and .opencode/skills/fal-ai-generation in your project.

What does Fal AI Generation need to run?

Going by SKILL.md and its folder, Fal AI Generation needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Fal AI Generation access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Fal AI Generation safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Fal AI Generation use?

Fal AI Generation is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Fal AI Generation use?

About 1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.5k tokens, read only when the agent opens those files.

What are the alternatives to Fal AI Generation?

Skills that share tags, products or a category with Fal AI Generation: 2D Sprite Generator (0x0funky/agent-sprite-forge, 4.4k stars), Web Visuals (glifxyz/glif-mcp-server, 213 stars), Scenario Textures (scenario-labs/skills, 946 stars) and Fmodel Unpack (pa001024/dna-builder, 137 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fal AI Generation?

witnesstodark (a GitHub user) maintains it in witnesstodark/mr-mak-workspace, which has 347 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 9, 2026.

Source: witnesstodark/mr-mak-workspace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.