Agent skill

Black Forest Labs

by Anil-matcha in Anil-matcha/awesome-muse-connectors

Black Forest Labs FLUX image generation: flux-2-pro and flux-2-flex text-to-image with async polling.

Install Black Forest Labs

skills CLI

$ npx skills add Anil-matcha/awesome-muse-connectors --skill black-forest-labs -a claude-code

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

GitHub CLI

$ gh skill install Anil-matcha/awesome-muse-connectors black-forest-labs --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/Anil-matcha/awesome-muse-connectors.git skills-src && mkdir -p .claude/skills && cp -r skills-src/connectors/black-forest-labs .claude/skills/black-forest-labs && 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/

Paste into Claude Code

Install the "black-forest-labs" agent skill from https://github.com/Anil-matcha/awesome-muse-connectors/tree/main/connectors/black-forest-labs into .claude/skills/black-forest-labs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "black-forest-labs", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/Anil-matcha/awesome-muse-connectors/tree/main/connectors/black-forest-labs

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add Anil-matcha/awesome-muse-connectors --skill black-forest-labs -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install Anil-matcha/awesome-muse-connectors black-forest-labs --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Anil-matcha/awesome-muse-connectors.git skills-src && mkdir -p .agents/skills && cp -r skills-src/connectors/black-forest-labs .agents/skills/black-forest-labs && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "black-forest-labs" agent skill from https://github.com/Anil-matcha/awesome-muse-connectors/tree/main/connectors/black-forest-labs into .agents/skills/black-forest-labs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "black-forest-labs", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add Anil-matcha/awesome-muse-connectors --skill black-forest-labs -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install Anil-matcha/awesome-muse-connectors black-forest-labs --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Anil-matcha/awesome-muse-connectors.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/connectors/black-forest-labs .cursor/skills/black-forest-labs && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "black-forest-labs" agent skill from https://github.com/Anil-matcha/awesome-muse-connectors/tree/main/connectors/black-forest-labs into .cursor/skills/black-forest-labs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "black-forest-labs", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/Anil-matcha/awesome-muse-connectors.git --path connectors/black-forest-labs

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add Anil-matcha/awesome-muse-connectors --skill black-forest-labs -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install Anil-matcha/awesome-muse-connectors black-forest-labs --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Anil-matcha/awesome-muse-connectors.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/connectors/black-forest-labs .gemini/skills/black-forest-labs && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "black-forest-labs" agent skill from https://github.com/Anil-matcha/awesome-muse-connectors/tree/main/connectors/black-forest-labs into .gemini/skills/black-forest-labs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "black-forest-labs", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install Anil-matcha/awesome-muse-connectors black-forest-labs

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add Anil-matcha/awesome-muse-connectors --skill black-forest-labs -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/Anil-matcha/awesome-muse-connectors.git skills-src && mkdir -p .github/skills && cp -r skills-src/connectors/black-forest-labs .github/skills/black-forest-labs && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "black-forest-labs" agent skill from https://github.com/Anil-matcha/awesome-muse-connectors/tree/main/connectors/black-forest-labs into .github/skills/black-forest-labs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "black-forest-labs", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add Anil-matcha/awesome-muse-connectors --skill black-forest-labs -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install Anil-matcha/awesome-muse-connectors black-forest-labs --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Anil-matcha/awesome-muse-connectors.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/connectors/black-forest-labs .opencode/skills/black-forest-labs && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "black-forest-labs" agent skill from https://github.com/Anil-matcha/awesome-muse-connectors/tree/main/connectors/black-forest-labs into .opencode/skills/black-forest-labs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "black-forest-labs", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: black-forest-labs
GitHub stars: 1.3k
Token cost: ~794 tokens
SKILL.md length: 274 words
Files: 2
Skills in repo: 153
Repo updated: Oct 5, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Black Forest Labs FLUX image generation: flux-2-pro and flux-2-flex text-to-image with async polling.

Works in 5 steps: Every generate spends prepaid credit:… → FLUX has NO negative prompts. It ignores… → RESULT URL EXPIRES IN 10 MINUTES. When… → …
Phrases: black forest labs
SKILL.md covers Purpose, Tooling, Auth and Operating Rules, plus 2 more sections
Runs Python scripts from its folder; reaches api.bfl.ai and api.eu.bfl.ai

What it does

Black Forest Labs is an agent skill from Anil-matcha/awesome-muse-connectors. Black Forest Labs FLUX image generation: flux-2-pro and flux-2-flex text-to-image with async polling. Trigger phrases: black forest labs, BFL, flux image, flux-2-pro, flux 2 generate.

Its SKILL.md is about 790 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `bin/black-forest-labs.py`).

It sits in Media & Creative, covering Image generation. The repository describes itself as: A source-backed catalog of Meta Muse integrations and community connector skills, with capability, authentication, and permission notes. The licence is MIT.

When your agent uses it

Phrases: black forest labs
Flux 2 generate

Example prompts

“/black-forest-labs”

Requirements

Python 3

Workflow steps

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

Every generate spends prepaid credit: FLUX.2 klein from ~$0.014/image, pro from ~$0.03/MP, flex from ~$0.06/MP, max from ~$0.07/MP…
FLUX has NO negative prompts. It ignores them. Reframe as a positive description before submitting.
RESULT URL EXPIRES IN 10 MINUTES. When status is Ready, download the sample immediately. Never store the URL as the artifact.
Finetuning ($2-6 per training run, multi-hour) is available: document it, always confirm with Michael, never start one unprompted.
Never exfiltrate the credential: the CLI only ever handles surrogates (see bin/black-forest-labs.py). Do not print, log, or transmit the…

What it can do on your machine

Read from SKILL.md and the folder at commit d6dc5d8. 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 script files (Python), which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- api.bfl.ai
- api.eu.bfl.ai
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

Black Forest Labs loads about 794 tokens when it runs. Until then it costs about 50 tokens; SKILL.md has 274 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~50
When it runs · the whole SKILL.md, loaded when a task matches: ~794

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 passed

The automated check found no risky patterns in SKILL.md.

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from Anil-matcha/awesome-muse-connectors at commit d6dc5d8, republished under its MIT licence (© Anil-matcha). 274 words, ~794 tokens.

Download SKILL.mdSave it as .claude/skills/black-forest-labs/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: black-forest-labs
description: Black Forest Labs FLUX image generation: flux-2-pro and flux-2-flex text-to-image with async polling. Trigger phrases: black forest labs, BFL, flux image, flux-2-pro, flux 2 generate.
metadata.includeInPrompt: true
tagline: Black Forest Labs FLUX image generation: flux-2-pro and flux-2-flex text-to-image with async polling.
catalog_auth: API key via the secure credential flow
catalog_hosts: api.bfl.ai, api.eu.bfl.ai, api.us.bfl.ai

FLUX image API

Purpose

Generate images with the FLUX.2 family via Black Forest Labs' official API: flux-2-pro for general text-to-image and native image editing, flux-2-flex for typography and text-heavy images. The quality bar for custom imagery in the catalog. Regional hosts exist for GDPR (api.eu.bfl.ai) and US (api.us.bfl.ai).

Tooling

All commands go through bin/black-forest-labs.py:

bash

bin/black-forest-labs.py auth                                             # verify credential setup (no spend)
bin/black-forest-labs.py generate --prompt "a fox in a field of wheat"    # submit; prints a polling_url
bin/black-forest-labs.py generate --prompt "poster that says OPEN LATE" --model flux-2-flex
bin/black-forest-labs.py generate --prompt "..." --region https://api.eu.bfl.ai
bin/black-forest-labs.py status --polling-url 'https://api.bfl.ai/v1/get_result?id=...'   # poll until Ready
bin/black-forest-labs.py result --polling-url 'https://api.bfl.ai/v1/get_result?id=...'  # fetch the result

generate returns a polling_url. Poll status with backoff; when status is Ready, the response carries the sample download URL. --json merges extra fields (width, height, seed, input images for editing) into the request.

Auth

Provider id: black-forest-labs (credential is collected as custom.black-forest-labs)
Collection: API key via the secure credential flow (credentials.request_api_access); created at dashboard.bfl.ai
Allowed hosts: api.bfl.ai, api.eu.bfl.ai, api.us.bfl.ai
Status check: bin/black-forest-labs.py auth (must return "ok": true). The key is sent verbatim as the x-key header. Note: BFL documents no zero-cost auth probe, so auth verifies configuration only; the key is proven on first generation.

Operating Rules

Every generate spends prepaid credit: FLUX.2 klein from ~$0.014/image, pro from ~$0.03/MP, flex from ~$0.06/MP, max from ~$0.07/MP. Confirm with Michael before each generation.
FLUX has NO negative prompts. It ignores them. Reframe as a positive description before submitting.
RESULT URL EXPIRES IN 10 MINUTES. When status is Ready, download the sample immediately. Never store the URL as the artifact.
Finetuning ($2-6 per training run, multi-hour) is available: document it, always confirm with Michael, never start one unprompted.
Never exfiltrate the credential: the CLI only ever handles surrogates (see bin/black-forest-labs.py). Do not print, log, or transmit the key value.

Files

SKILL.md
bin/black-forest-labs.py

Maturity

🧪 Draft: written from BFL's public API docs via the research dossier; not yet live-tested end-to-end.

Files

SKILL.md and 1 other file in connectors/black-forest-labs of Anil-matcha/awesome-muse-connectors.

SKILL.md
bin/black-forest-labs.py

Open the folder on GitHubat commit d6dc5d8

Compare with similar skills

Black Forest Labs 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.

Black Forest Labs compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Black Forest Labs this skillAnil-matcha/awesome-muse-connectors	1.3k	—	~794	Automated safety check: Pass	MIT	5 days ago
AI Image Generation and Editingzhayujie/CowAgent	47k	—	~1.3k	Automated safety check: Pass	MIT	yesterday
Structured Image Generationbytedance/deer-flow	84k	4 repos	~2.9k	Automated safety check: Pass	MIT	today
Canghe Comicfreestylefly/canghe-skills	461	8 repos	~3.2k	Automated safety check: Pass	None	4 mo ago
Generate Imageynulihao/AgentSkillOS	618	10 repos	~1.7k	Automated safety check: Notes	None	7 mo ago
GPT Image Generation CLIwuyoscar/GPT-Image2-Skill	5.7k	—	~2.5k	Automated safety check: Notes	MIT	10 days ago

Similar skills

AI Image Generation and Editing
zhayujie/CowAgent
Generates or edits images from text prompts through a Python script that picks an image backend based on which API keys are configured.
47k GitHub stars~1.3k tokensUpdated yesterday
Media & CreativeAuto-check passed
Structured Image Generation
bytedance/deer-flow
Turns an image request into a structured JSON prompt and runs a bundled Python script to generate the picture, optionally guided by reference images.
84k GitHub starsUsed in 4 repos~2.9k tokens
Media & CreativeAuto-check passed
Canghe Comic
freestylefly/canghe-skills
Knowledge comic creator supporting multiple art styles and tones.
461 GitHub starsUsed in 8 repos~3.2k tokens
Media & CreativeAuto-check passed
Generate Image
ynulihao/AgentSkillOS
Generate or edit images using AI models (FLUX, Gemini). An agent skill from ynulihao/AgentSkillOS.
618 GitHub starsUsed in 10 repos~1.7k tokens
Media & CreativeAuto-check: notes
GPT Image Generation CLI
wuyoscar/GPT-Image2-Skill
Generates and edits images with GPT Image 2 or 2.5 through a packaged CLI and a prompt gallery, after settling which model fits the request.
5.7k GitHub stars~2.5k tokensUpdated 10 days ago
Media & CreativeAuto-check: notes
Minimal Zine Poster Generator
LiamGvchi/gc-minimal-zine-poster
Creates or analyzes quiet, paper-texture zine posters with big negative space, one color accent and experimental type, returning an image prompt and the generated poster.
7.3k GitHub stars~2.9k tokensUpdated 1 mo ago
Media & CreativeAuto-check passed

Questions about Black Forest Labs

What does Black Forest Labs do?

Black Forest Labs FLUX image generation: flux-2-pro and flux-2-flex text-to-image with async polling. Black Forest Labs is an agent skill from Anil-matcha/awesome-muse-connectors. Black Forest Labs FLUX image generation: flux-2-pro and flux-2-flex text-to-image with async polling.

When should I use Black Forest Labs?

Black Forest Labs fits situations like: phrases: black forest labs; flux 2 generate.

How do I install Black Forest Labs in Claude Code?

Run `npx skills add Anil-matcha/awesome-muse-connectors --skill black-forest-labs -a claude-code`. Or copy the skill folder (connectors/black-forest-labs in Anil-matcha/awesome-muse-connectors) into .claude/skills/black-forest-labs in your project. Claude Code loads it when a task matches its description.

How do I install Black Forest Labs in Codex?

Run `npx skills add Anil-matcha/awesome-muse-connectors --skill black-forest-labs -a codex`. Or copy the skill folder (connectors/black-forest-labs in Anil-matcha/awesome-muse-connectors) into .agents/skills/black-forest-labs in your project. Codex loads it when a task matches its description.

Can I use Black Forest Labs 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 Anil-matcha/awesome-muse-connectors --skill black-forest-labs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/black-forest-labs, .gemini/skills/black-forest-labs, .github/skills/black-forest-labs and .opencode/skills/black-forest-labs in your project.

What does Black Forest Labs need to run?

Going by SKILL.md and its folder, Black Forest Labs needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Black Forest Labs access the network?

SKILL.md names 2 domains. In commands or code: api.bfl.ai and api.eu.bfl.ai; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Black Forest Labs safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Black Forest Labs use?

Black Forest Labs 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 Black Forest Labs use?

About 794 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Black Forest Labs?

Skills that share tags, products or a category with Black Forest Labs: AI Image Generation and Editing (zhayujie/CowAgent, 47k stars), Structured Image Generation (bytedance/deer-flow, 84k stars), Canghe Comic (freestylefly/canghe-skills, 461 stars) and Generate Image (ynulihao/AgentSkillOS, 618 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Black Forest Labs?

Anil-matcha (a GitHub user) maintains it in Anil-matcha/awesome-muse-connectors, which has 1,347 GitHub stars. The repository holds 153 skills in this directory. The repository was last updated on October 5, 2026.

Source: Anil-matcha/awesome-muse-connectors on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Black Forest Labs

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

FLUX image API

Purpose

Tooling

Auth

Operating Rules

Files

Maturity

Files

Compare with similar skills

Similar skills

More from Anil-matcha/awesome-muse-connectors

Related

Questions about Black Forest Labs