mcpField
F
flux-best-practices

flux-best-practices

github.com/black-forest-labsCreative & media134854 installsUpdated 9w ago
Repository

About flux-best-practices

flux-best-practices is a prompting skill for people creating images with BFL FLUX models. It covers model selection and prompt techniques for generation, editing, typography, structured scenes, and color specification.

Key features

  1. 01Prompt structure guidance
  2. 02FLUX.1 and FLUX.2 model selection
  3. 03Text-to-image and image editing patterns
  4. 04Structured JSON scene prompting
  5. 05Typography and precise color guidance

Use cases

  1. 01Writing prompts for FLUX image generation
  2. 02Editing images with FLUX.2
  3. 03Rendering text or brand colors in images
  4. 04Building complex scenes with JSON prompts

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/black-forest-labs/skills --skill flux-best-practices

After installing, type/flux-best-practicesin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

AGENTS.md
metadata.json
rules/
_sections.md
core-principles.md
flux1-models.md
flux2-models.md
hex-color-prompting.md
i2i-prompting.md
json-structured-prompting.md
model-selection-guide.md
multi-reference-editing.md
negative-prompt-alternatives.md
t2i-prompting.md
typography-text.md

Details

From the project README

FLUX Best Practices

Use this skill when generating prompts for any BFL FLUX model to ensure optimal image quality and accurate prompt interpretation.

When to Use

  • Creating prompts for FLUX.2 or FLUX.1 models
  • Text-to-image (T2I) generation
  • Image-to-image (I2I) editing with FLUX.2 models
  • Structured scene generation with JSON
  • Typography and text rendering
  • Multi-reference style transfer
  • Color-accurate brand generations

Quick Reference

Prompt Structure Formula
[Subject] + [Action/Pose] + [Style/Medium] + [Context/Setting] + [Lighting] + [Camera/Technical]
Model Selection
Use CaseRecommended ModelNotes
Fastest generationFLUX.2 [klein]4B or 9B, sub-second
Highest qualityFLUX.2 [max]Best detail, grounding search
Production balancedFLUX.2 [pro]Quality + speed
Typography/textFLUX.2 [flex]Best text rendering
Local/developmentFLUX.2 [dev]Open weights
Image editingFLUX.2 [pro/max]Pass image URL directly to input_image
InpaintingFLUX.1 FillObject removal/completion
Context editingFLUX.1 KontextOlder model, prefer FLUX.2
Critical Rules
  1. NO negative prompts - FLUX does not support negative prompts; describe what you want
  2. Be specific - Vague prompts produce mediocre results
  3. Use natural language - Prose/narrative style works best
  4. Specify lighting - Lighting has the biggest impact on quality
  5. Quote text - Use "quoted text" for typography rendering
  6. Hex colors - Use #RRGGBB format with color description

Related

For API integration (endpoints, polling, webhooks), see the bfl-api skill.

Rules Reference

Read individual rule files for detailed guidance:

Example Prompt

A weathered fisherman in his 70s with deep wrinkles and a salt-and-pepper beard,
wearing a navy cable-knit sweater, standing at the helm of his wooden boat.
Golden hour sunlight from the left creates dramatic rim lighting on his profile.
Shot on Hasselblad with 85mm lens at f/2.8, shallow depth of field with harbor
lights creating soft bokeh in the background. Kodak Portra 400 color science.

Comments

Markdown supported