flux-best-practices

What the source does

• FilesystemNone observedNo reads or writes in the source
• NetworkNone observedNo outbound calls in the source
• ShellNone observedNo commands run in the source
• DependenciesPinnedNothing floats
• SecretsNone foundNo keys in source

Five audit layers

Gates applied: no behavioural pass.

Audit 0.4.1 · source sha 13ec33b09272 · 31 Oct 2026Report an issue or request a re-scan

• Publishercalesthio GitHub userOwner of the repository this skill is read from
• Source foldercalesthio/openmontage/.agents/skills/flux-best-practicesThe exact folder we audited
• LicenceAGPL-3.0As the repository states it
• Commit pinned for this verdict13ec33b09272A new audit runs when the source changes
• Repository statusNot archivedLast push 2 days ago
• Sandboxed runNot runSkills are read, not executed; layer L4 is skipped

Its description: Comprehensive guide for BFL FLUX image generation models. Covers prompting, T2I, I2I, structured JSON, hex colors, typography, multi-reference editing, and model-specific best practices for FLUX.2 and FLUX.1 families.

---
name: flux-best-practices
description: Comprehensive guide for BFL FLUX image generation models. Covers prompting, T2I, I2I, structured JSON, hex colors, typography, multi-reference editing, and model-specific best practices for FLUX.2 and FLUX.1 families.
metadata:
  author: Black Forest Labs
  version: "1.0.0"
  tags: flux, bfl, image-generation, prompting, t2i, i2i
---

# FLUX Best Practices

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

> **Extended reference:** [`AGENTS.md`](AGENTS.md) in this directory is the long-form upstream FLUX guide (vendored from Black Forest Labs). It is supplementary reference material scoped to this skill only — `SKILL.md` is the loadable entry point and the authority. It does not override or extend the repository-root `AGENTS.md` / `AGENT_GUIDE.md`.

## 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 Case            | Recommended Model | Notes                                  |
| ------------------- | ----------------- | -------------------------------------- |
| Fastest generation  | FLUX.2 [klein]    | 4B or 9B, sub-second                   |
| Highest quality     | FLUX.2 [max]      | Best detail, grounding search          |
| Production balanced | FLUX.2 [pro]      | Quality + speed                        |
| Typography/text     | FLUX.2 [flex]     | Best text rendering                    |
| Local/development   | FLUX.2 [dev]      | Open weights                           |
| Image editing       | FLUX.2 [pro/max]  | Pass image URL directly to input_image |
| Inpainting          | FLUX.1 Fill       | Object removal/completion              |
| Context editing     | FLUX.1 Kontext    | Older 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:

- [rules/core-principles.md](rules/core-principles.md) - Universal FLUX prompting principles
- [rules/flux2-models.md](rules/flux2-models.md) - FLUX.2 family: klein, max, pro, flex, dev
- [rules/flux1-models.md](rules/flux1-models.md) - FLUX.1 family: older generation of FLUX.2 models - pro, Kontext, Fill
- [rules/t2i-prompting.md](rules/t2i-prompting.md) - Text-to-image prompting patterns
- [rules/i2i-prompting.md](rules/i2i-prompting.md) - Image-to-image editing with FLUX.2
- [rules/json-structured-prompting.md](rules/json-structured-prompting.md) - Complex scene composition
- [rules/hex-color-prompting.md](rules/hex-color-prompting.md) - Precise color specification
- [rules/typography-text.md](rules/typography-text.md) - Text rendering and typography
- [rules/multi-reference-editing.md](rules/multi-reference-editing.md) - Multi-image references
- [rules/negative-prompt-alternatives.md](rules/negative-prompt-alternatives.md) - Positive alternatives
- [rules/model-selection-guide.md](rules/model-selection-guide.md) - Choosing the right model

## 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.
```

Excerpt, first 4,273 characters of SKILL.md, verbatim from the audited commit. It is text from someone else’s repository, quoted so you can judge it before your agent reads it.

git clone https://github.com/calesthio/openmontage
git -C openmontage checkout 13ec33b09272

Works in

1. 2026-10-31
   ✓SAFE B 89 / 100

   first audit · source 13ec33b09272

Questions about flux-best-practices

• github.com/calesthio/openmontage/tree/main/.agents/skills/flux-b — the audited source at commit 13ec33b09272 and every finding aboveObserved · 31 Oct 2026

Spotted something wrong? Report a correction · Methodology