Agent skill

Flux 3 Prompt Doctor

by black-forest-labs in black-forest-labs/skills

A skill your agent uses when diagnosing a FLUX 3 brief before generation.

MITAuto-check passedMedia & Creative

Install Flux 3 Prompt Doctor

skills CLI
$ npx skills add black-forest-labs/skills --skill flux-3-prompt-doctor -a claude-code

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

GitHub CLI
$ gh skill install black-forest-labs/skills flux-3-prompt-doctor --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/black-forest-labs/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/flux-3-prompt-doctor .claude/skills/flux-3-prompt-doctor && 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
flux-3-prompt-doctor
GitHub stars
128
Token cost
~904 tokens
SKILL.md length
408 words
Files
3
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when diagnosing a FLUX 3 brief before generation.

  • Diagnosing a FLUX 3 brief before generation
  • SKILL.md covers Route by what must survive, Feasibility and Verdict
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Flux 3 Prompt Doctor is an agent skill from black-forest-labs/skills. Use when diagnosing a FLUX 3 brief before generation. Resolve missing, conflicting, or schema-changing requirements.

Its SKILL.md is about 900 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `metadata.json` and `templates/brief.md`).

It sits in Media & Creative. The repository describes itself as: Official agent skills from Black Forest Labs for FLUX image and video generation — prompting guides and API integration patterns for Claude Code, Codex, and any… The licence is MIT.

When your agent uses it

  • Diagnosing a FLUX 3 brief before generation

Example prompts

  • “/flux-3-prompt-doctor”

What it can do on your machine

Read from SKILL.md and the folder at commit 8907d51. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    Links to these hosts (documentation or services it may open):

    • docs.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

Flux 3 Prompt Doctor loads about 904 tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 408 words of instructions outside code blocks.

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

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 black-forest-labs/skills at commit 8907d51, republished under its MIT licence (© black-forest-labs). 408 words, ~904 tokens.

Download SKILL.mdSave it as .claude/skills/flux-3-prompt-doctor/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
flux-3-prompt-doctor
description
Use when diagnosing a FLUX 3 brief before generation. Resolve missing, conflicting, or schema-changing requirements.
metadata.author
Black Forest Labs
metadata.version
1.0.0
metadata.tags
flux, flux-3, bfl, prompt-doctor, validation, routing

FLUX 3 Prompt Doctor

Resolve the decisions that change routing, payload, or production method before a brief becomes a prompt. Ask only blocking questions; use documented defaults or label assumptions for everything else. Preserve the user's product names, exact copy, source roles, and hard constraints verbatim. This skill does not write the final prompt or call the API.

Route by what must survive

Every request names its mode and carries the matching media field:

RequirementRoute
Generate the whole clip from wordsmode: "t2v", no media
An image must appear on screen exactly as shotmode: "i2v", keyframes
Bridge an exact opening and closing framemode: "i2v", two keyframes
Pass through visual waypointsmode: "i2v", keyframes as a storyboard
Continue from an existing endingmode: "v2v", start_video
Render an approved draft without replanningmode: "draft_enhance", draft_cache

Two questions separate the image routes: must these exact pixels be on screen (keyframes)? Can the source simply be described (then attach nothing)? There is no field that carries a subject's identity without putting the source on screen; a brief that needs one either opens each shot from a keyframe containing the subject, or is a REVISE.

Feasibility

  • Action budget: one subject action and one camera move per short clip. Revise briefs demanding many sequential actions, several locations, exact mechanisms, or multiple full dialogue lines.

  • Shot structure: state one continuous unbroken take, or an explicit sequence:

    text
    SHOT ONE: wide aerial of a desert highway at dawn, a single red car speeding through.
    HARD CUT. SHOT TWO: interior close-up, the driver's hands drumming the wheel to the radio.
    HARD CUT. SHOT THREE: from the roadside, the car shrinking into the heat haze.
    Warm engine hum under one continuous music bed across all three shots.

    Consecutive shots must contrast hard (scale, location, color) or the cut blends into a continuous take; each shot needs its own beat; one music bed can run across cuts.

  • Contradictions to catch: locked-off camera plus tracking; extreme close-up plus establishing view; exact frame preservation plus major geometric change; one continuous shot plus hard cuts; production-critical generated typography with no post fallback; guaranteed speaker identity across separate generations.

  • Reserve for deterministic post when exactness is a success condition: typography, subtitles, logos; frame-accurate sync; final mixing; precise mechanisms; cross-generation speaker identity. Generation creates footage and causal intent, not a compositor or final mix.

Show full SKILL.md (75 more words)Show less

Verdict

Return exactly one state, with a reason, next action, and a compact handoff (templates/brief.md when it should be reusable):

  • READY: route, assumptions, handoff. Recommend a draft first when the concept is unproven.
  • NEEDS INFO: only the blocking questions.
  • REVISE: name the conflict and the minimum repair.

Non-blocking warnings go under Production risks, not a fourth state. Field names and limits belong to the API reference; flag intent conflicts and leave schema validation to flux-3-generate.

© black-forest-labs, 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 2 other files in skills/flux-3-prompt-doctor of black-forest-labs/skills.

  • SKILL.md
  • metadata.json
  • templates/brief.md

Open the folder on GitHubat commit 8907d51

Compare with similar skills

Flux 3 Prompt Doctor 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.

Flux 3 Prompt Doctor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Flux 3 Prompt Doctor this skillblack-forest-labs/skills128—~904Automated safety check: PassMIT
Video Scriptitwanger/toBeBetterJavaer18k—~2.2kAutomated safety check: PassNone
Benchddalcu/mlx-serve1.8k1 repos~1.1kAutomated safety check: PassCustom licence
PR Chartsddalcu/mlx-serve1.8k—~594Automated safety check: PassCustom licence
Agnes AI Supportlj1270998580-crypto/Agnes-help-skill305—~14kAutomated safety check: NotesNone
Dotty Av TestBrettKinny/dotty-stackchan113—~866Automated safety check: NotesMIT

Similar skills

  • Video Script

    itwanger/toBeBetterJavaer

    口播稿,适用于 AI 技术科普、Agent/Skill/RAG、LLM 等底层原理讲解,以及面试题拆解、工具实测、热点普及。支持两种用法:给定主题从零产出口播稿、对已有口播稿进行优化。触发关键词包括:口播、口播稿、video script。

    18k GitHub stars~2.2k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Bench

    ddalcu/mlx-serve

    mlx-serve benchmarking methodology — bench.sh/llmprobe usage, comparison-trap rules (same-methodology cells only, spec-decode variance, thermal lies, engine naming), perf-claim etiquette.

    1.8k GitHub starsUsed in 1 repo~1.1k tokens
    Media & CreativeAuto-check passed
  • PR Charts

    ddalcu/mlx-serve

    Turn llmprobe reports into the charts a perf PR embeds (one line per arm across context size, every point labelled, machine and model in the caption) and host them so the PR body renders them.

    1.8k GitHub stars~594 tokensUpdated today
    Media & CreativeAuto-check passed
  • Agnes AI Support

    lj1270998580-crypto/Agnes-help-skill

    Agnes AI API 接入支持与问题排查 Skill。帮助新用户完成 Agnes AI API 的接入配置, 诊断和解决接入过程中遇到的认证、参数、响应、图像生成、视频生成等各类问题。

    305 GitHub stars~14k tokensUpdated 18 days ago
    Media & CreativeAuto-check: notes
  • Dotty Av Test

    BrettKinny/dotty-stackchan

    Run local black-box voice tests against the physical Dotty robot by playing a TTS prompt through the workstation speakers while the C920 records video and room audio.

    113 GitHub stars~866 tokensUpdated 5 days ago
    Media & CreativeAuto-check: notes
  • Color Correction

    artokun/comfyui-mcp

    Diagnose and fix video/image color OBJECTIVELY with the getimage (action:"analyzecolor") tool (scopes/stats such as black/white points, contrast, saturation, clipping, cast) instead of eyeballing a…

    803 GitHub stars~2.4k tokensUpdated 6 days ago
    Media & CreativeAuto-check passed

More from black-forest-labs/skills

All 10 skills in this repo
  • Flux 3 Archival Formats

    black-forest-labs/skills

    A skill your agent uses when a FLUX 3 video needs a period or archival look.

    128 GitHub stars~1.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Flux 3 Keyframes Continuation

    black-forest-labs/skills

    A skill your agent uses when a FLUX 3 video must be built from supplied images or video.

    128 GitHub stars~827 tokensUpdated 1 mo ago
    Auto-check passed
  • Bfl API

    black-forest-labs/skills

    BFL FLUX API integration guide covering endpoints, async polling patterns, rate limiting, error handling, webhooks, and regional endpoints with Python and TypeScript code examples.

    128 GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check: notes
  • Flux 3 Product Ads

    black-forest-labs/skills

    A skill your agent uses when building a finished product ad from FLUX 3 - shot design, voiceover, action-to-word sync, evidence-gated copy, deterministic assembly, and QC gates that catch clipped…

    128 GitHub stars~9.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Flux 3 Generate

    black-forest-labs/skills

    A skill your agent uses when submitting or polling a FLUX 3 video API job.

    128 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Flux 3 Audio Dialogue

    black-forest-labs/skills

    A skill your agent uses when directing FLUX 3 audio, dialogue, or voiceover.

    128 GitHub stars~584 tokensUpdated 1 mo ago
    Auto-check passed

Questions about Flux 3 Prompt Doctor

What does Flux 3 Prompt Doctor do?

A skill your agent uses when diagnosing a FLUX 3 brief before generation. Flux 3 Prompt Doctor is an agent skill from black-forest-labs/skills. Use when diagnosing a FLUX 3 brief before generation.

When should I use Flux 3 Prompt Doctor?

Flux 3 Prompt Doctor fits situations like: diagnosing a FLUX 3 brief before generation.

How do I install Flux 3 Prompt Doctor in Claude Code?

Run `npx skills add black-forest-labs/skills --skill flux-3-prompt-doctor -a claude-code`. Or copy the skill folder (skills/flux-3-prompt-doctor in black-forest-labs/skills) into .claude/skills/flux-3-prompt-doctor in your project. Claude Code loads it when a task matches its description.

How do I install Flux 3 Prompt Doctor in Codex?

Run `npx skills add black-forest-labs/skills --skill flux-3-prompt-doctor -a codex`. Or copy the skill folder (skills/flux-3-prompt-doctor in black-forest-labs/skills) into .agents/skills/flux-3-prompt-doctor in your project. Codex loads it when a task matches its description.

Can I use Flux 3 Prompt Doctor 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 black-forest-labs/skills --skill flux-3-prompt-doctor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/flux-3-prompt-doctor, .gemini/skills/flux-3-prompt-doctor, .github/skills/flux-3-prompt-doctor and .opencode/skills/flux-3-prompt-doctor in your project.

What does Flux 3 Prompt Doctor need to run?

SKILL.md names no scripts, command-line tools or credentials: Flux 3 Prompt Doctor is instructions for the agent only.

Does Flux 3 Prompt Doctor access the network?

SKILL.md names 1 domain. As links in the text: docs.bfl.ai. This is read from the text; nothing was executed.

Is Flux 3 Prompt Doctor 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 Flux 3 Prompt Doctor use?

Flux 3 Prompt Doctor 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 Flux 3 Prompt Doctor use?

About 904 tokens (SKILL.md is roughly 3.6k 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 Flux 3 Prompt Doctor?

Skills that share tags, products or a category with Flux 3 Prompt Doctor: Video Script (itwanger/toBeBetterJavaer, 18k stars), Bench (ddalcu/mlx-serve, 1.8k stars), PR Charts (ddalcu/mlx-serve, 1.8k stars) and Agnes AI Support (lj1270998580-crypto/Agnes-help-skill, 305 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Flux 3 Prompt Doctor?

black-forest-labs (a GitHub organization) maintains it in black-forest-labs/skills, which has 128 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on September 9, 2026.

Source: black-forest-labs/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.