mcpField
F
flux-image-best-practices

flux-image-best-practices

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

About flux-image-best-practices

flux-image-best-practices is a skill for writing prompts for BFL FLUX models, covering image generation and editing. It offers model-specific guidance for prompt structure, scene details, color, typography, and image references.

Key features

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

Use cases

  1. 01Draft prompts for FLUX image generation
  2. 02Describe edits to images with FLUX.2
  3. 03Specify rendered text or brand colors

Install

Copy the command and run it in a terminal.

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

After installing, type/flux-image-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