The FLUX craft skill (Black Forest Labs) — generate and edit on-brand images with the right variant and license.

MITAuto-check passedMedia & Creative

Install Flux

skills CLI
$ npx skills add social-media-skills/skills --skill flux -a claude-code

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

GitHub CLI
$ gh skill install social-media-skills/skills flux --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/social-media-skills/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/flux .claude/skills/flux && 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
GitHub stars
134
Token cost
~2.1k tokens
SKILL.md length
893 words
Files
6 (incl. references)
Skills in repo
106
Repo updated
First seen
Licence
MIT

At a glance

The FLUX craft skill (Black Forest Labs) — generate and edit on-brand images with the right variant and license.

  • Works in 2 steps: image-prompt — the model-agnostic prompt… → brand-profile + design-and-templates —…
  • Someone wants to generate images with FLUX/FLUX.2/Kontext
  • SKILL.md covers The POV: control is the…, Read these first, The framework: PIXEL and The reality (verify-quarterly), plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Flux is an agent skill from social-media-skills/skills. The FLUX craft skill (Black Forest Labs) — generate and edit on-brand images with the right variant and license. Use when someone wants to generate images with FLUX/FLUX.2/Kontext, edit a generated image, keep a character or product consistent across a campaign, render legible text in images, get brand-exact colors, pick between FLUX variants, or asks if their FLUX use is commercially licensed. Uses the PIXEL framework. Reads image-prompt + brand-profile + design-and-templates first. The agent writes prompts/edit…

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `evals/evals.json`, `references/flux-2026-reality.md` and `references/prompt-patterns-and-templates.md`).

It sits in Media & Creative, covering Image generation. It works with Google Gemini, Midjourney and Canva. The repository describes itself as: 106 social media skills for AI agents - strategy, writing, video, design, platform growth, publishing, and analytics. Works with Claude, Cursor, OpenClaw, Hermes & 40+ agents. The licence is MIT.

When your agent uses it

  • Someone wants to generate images with FLUX/FLUX.2/Kontext
  • Edit a generated image
  • Keep a character
  • Product consistent across a campaign

Example prompts

  • “/flux”

Workflow steps

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

  1. image-prompt — the model-agnostic prompt craft + router above all image tools.
  2. brand-profile + design-and-templates — the system (colors → hex codes, type, logo rules).

What it can do on your machine

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

    No URLs in SKILL.md.

    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 loads about 2.1k tokens when it runs, and up to ~5.3k if it reads all its reference files. Until then it costs about 251 tokens; SKILL.md has 893 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~251
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.3k

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 social-media-skills/skills at commit 6e30eeb, republished under its MIT licence (© social-media-skills). 893 words, ~2,114 tokens.

Download SKILL.mdSave it as .claude/skills/flux/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
flux
description
The FLUX craft skill (Black Forest Labs) — generate and edit on-brand images with the right variant and license. Use when someone wants to generate images with FLUX/FLUX.2/Kontext, edit a generated image, keep a character or product consistent across a campaign, render legible text in images, get brand-exact colors, pick between FLUX variants, or asks if their FLUX use is commercially licensed. Uses the PIXEL framework. Reads image-prompt + brand-profile + design-and-templates first. The agent writes prompts/edit instructions and can call the API where connected; the HUMAN judges every image; WoopSocial publishes. License spine: [dev] outputs are commercial-OK but self-hosting for a commercial service needs a paid BFL tier; Apache-2.0 paths are [schnell]/[klein] 4B. Never use unpermitted likeness, clone trade dress, strip provenance, or invent stats. Distinct from image-prompt, ideogram/nano-banana/Midjourney (sibling tools), ai-image-editing (the edit router this feeds), and canva.
version
1.0.0

flux

The FLUX image tool skill — pick the variant + license, instruct in scenes, lock references + edit instead of re-rolling, evaluate deliberately, and label before publishing. The agent prompts (and can call the API where connected); the human judges every image; WoopSocial publishes. (Ships with tools/integrations/flux.md.)

The POV: control is the product — and the license is the trap

FLUX's 2026 edge isn't just quality; it's control: multi-reference consistency (up to ~8–10 images in one call — a campaign-consistent character or product with no fine-tuning), in-context editing ("change the jacket, keep everything else"), hex-code brand colors as parameters, 32k-token scene prompts, and typography clean enough that ad headlines are production-viable. Two top-1% edges most users miss. (1) The license split is the trap: [dev] outputs are commercially usable, but self-hosting [dev] to serve commercial work (clients, a product) needs a paid BFL tier — the agency tier includes just 3 clients before per-client fees — and the dev license requires content filters or manual review, which BFL says it may verify at random. Apache-2.0 freedom lives in [schnell] and [klein] 4B; the hosted APIs are the easiest commercial path (license + signed provenance handled). (2) Edit, don't re-roll: a 95%-right image is one Kontext-style instruction from done — re-rolling throws away the 95%. And the craft shift: FLUX reads natural-language scene briefs, not tag soup — describe subject, light, mood, camera; put exact in-image text in quotes and verify every character.

Read these first

  1. image-prompt — the model-agnostic prompt craft + router above all image tools.
  2. brand-profile + design-and-templates — the system (colors → hex codes, type, logo rules).

The framework: PIXEL

(Depth: references/the-pixel-framework.md.)

  • P — Pick the variant + license: hosted API = easiest commercial; [klein] 4B/[schnell] = Apache-2.0 self-host; [dev] = outputs OK / services need a paid tier + required filters; [max] for web-grounded; verify at bfl.ai.
  • I — Instruct in scenes, not tags: natural-language multi-part briefs (32k context); hex codes for brand-exact color; exact text in quotes; prompt upsampling helps [dev].
  • X — eXact references + edits: multi-reference locks characters/products (never an unpermitted likeness); in-context edits fix the 5% instead of re-rolling; chain small edits, watch drift; verify rendered text.
  • E — Evaluate + iterate: the human judges every render; one variable per iteration; keep the seed when composition lands; side-by-side drift review on sets.
  • L — License + label: rights confirmed for the variant actually used; AI-disclosure where required; never strip the signed provenance metadata; then WoopSocial publishes.

The reality (verify-quarterly)

FLUX.2 (Nov 2025, current flagship): 32B rectified-flow + Mistral-3 VLM, multi-reference (~8–10 images), 4MP, clean small-size typography (the "text soup" era largely fixed), hex-color parameters, photorealism reducing "the AI look"; [klein] (Jan 2026) = sub-second on consumer GPUs (~13GB VRAM for the 4B), 4B Apache 2.0 (the 9B klein is non-commercial); [max] adds real-time web-grounded generation; FLUX.1 Kontext = the in-context editing line (a selectable partner model in Photoshop Beta's Generative Fill). Licensing (bfl.ai, attributed): dev outputs commercial-OK; self-hosted commercial services need paid tiers (developer ~10K img/mo single-domain, not client work; agency ~100K/mo, 3 clients included); filters or manual review required on [dev] with random verification stated; API applies cryptographically-signed provenance metadata; non-removable CSAM/NCII filters on API. Runs via Playground → APIs (BFL/fal/Replicate/ Together/Cloudflare) → self-host (ComfyUI; FLUX.2 [dev] quantized on an RTX 4090). Attribute all; verify-quarterly. Full detail: references/flux-2026-reality.md. The variant table, scene-prompt pattern, consistency + edit workflows, and two worked examples: references/prompt-patterns-and-templates.md.

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

Honest scope (never violate)

  • The agent prompts, plans references/edits, and calls the API where connected (exact human steps otherwise); the human judges every image (no fabricated "that looks great"; side-by-side set reviews); WoopSocial publishes finished exports — it does not generate or edit media.
  • License spine: verify rights for the variant actually used; [dev]-as-a-service needs the paid tier + the filter/review obligation; Apache-2.0 = [schnell]/[klein] 4B; high-stakes → counsel (not legal advice). Likeness/IP/provenance: no unpermitted real-person likeness (real or AI lookalike), no cloned trade dress or copyrighted characters, never strip provenance, AI-disclosure where required (EU AI Act; C2PA). Data honesty: never invent stats (data viz → infographic-and-data-viz). Never fabricate benchmarks/prices/ capabilities. (Full scope: references/scope-and-connections.md.)

Distinct from its siblings (route correctly)

flux (this) = the FLUX-specific lane (photorealism + typography + multi-reference + editing + open-weight control) · image-prompt = the model-agnostic router/craft (read first) · ideogram = graphic-design/ text-layout lane · Midjourney = distinct aesthetic lane (external — no skill in this library) · nano-banana = its documented lane ( strengths shift per release — test, don't trust leaderboards) · ai-image-editing = the edit router FLUX editing will serve · canva = the design workflow output drops into · ai-video / veo-3 / kling = video (BFL's video model is announced — verify before claiming).

Where this connects

Reads first: image-prompt + brand-profile + design-and-templates. Feeds: canva (layout/type over imagery), thumbnail-design, quote-cards-and-text-graphics (backgrounds), carousel-writer, pinterest-pin-design, before-after-and-transformation (honest visuals only). Publishes via: export → scheduling-and-queue → WoopSocial. Tool file: tools/integrations/flux.md. Measure with: native + analytics-and-reporting — never fabricated.

Definition of done

A FLUX workflow that is on-brand and on-license: the variant chosen with its actual rights verified (hosted API for easy commercial; Apache-2.0 [schnell]/[klein] 4B for free self-host; [dev] outputs-vs-service line respected with the filter/review obligation met; paid tiers for client/product self-hosting), prompts written as natural-language scene briefs with hex-exact brand color and quoted in-image text, consistency achieved by multi-reference (original/consented characters only) and near-misses fixed by in-context edits rather than re-rolls, every render human-judged with one-variable iteration and side-by-side set drift review, all rendered text character-verified, and the shipped image labeled honestly (AI-disclosure where required; provenance metadata intact) then published via WoopSocial; no unpermitted likeness, no cloned trade dress, no stripped provenance, no invented stats, no fabricated benchmarks/capabilities; and correctly distinguished from image-prompt, the sibling image tools, ai-image-editing, and canva.

© social-media-skills, 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 5 other files (references) in skills/flux of social-media-skills/skills.

  • SKILL.md
  • evals/evals.json
  • references/flux-2026-reality.md
  • references/prompt-patterns-and-templates.md
  • references/scope-and-connections.md
  • references/the-pixel-framework.md

Open the folder on GitHubat commit 6e30eeb

Compare with similar skills

Flux 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Flux this skillsocial-media-skills/skills134—~2.1kAutomated safety check: PassMIT
ImageNexus-JPF/note-companion8703 repos~3.9kAutomated safety check: PassMIT
AI Image Prompts SkillLeoYeAI/openclaw-master-skills2.2k—~4.3kAutomated safety check: PassMIT
Nano Banana Pro Prompts Recommend SkillYouMind-OpenLab/nano-banana-pro-prompts-recommend-skill1.9k1 repos~4.1kAutomated safety check: PassNone
Zy Cinematic Realismpopopo-99/zy-cinematic-realism570—~4.6kAutomated safety check: PassCC-BY-NC-4.0
AI Image Generationaiskillstore/marketplace4332 repos~1.1kAutomated safety check: PassNone

Similar skills

  • Image

    Nexus-JPF/note-companion

    When the user wants to create, generate, edit, or optimize images for marketing — blog heroes, social graphics, product mockups, profile banners, listing visuals, or brand assets.

    870 GitHub starsUsed in 3 repos~3.9k tokens
    Media & CreativeAuto-check passed
  • AI Image Prompts Skill

    LeoYeAI/openclaw-master-skills

    Recommend curated prompts from a 10,000+ real-world image generation prompt library.

    2.2k GitHub stars~4.3k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • Nano Banana Pro Prompts Recommend Skill

    YouMind-OpenLab/nano-banana-pro-prompts-recommend-skill

    Recommend suitable prompts from 10,000+ Nano Banana Pro image generation prompts based on user needs.

    1.9k GitHub starsUsed in 1 repo~4.1k tokens
    Media & CreativeAuto-check passed
  • Zy Cinematic Realism

    popopo-99/zy-cinematic-realism

    Develop supplied scripts, short stories, or synopses into scene understanding, director-facing art concepts, and motivated narrative keyframes; compile scene ideas, visual references, or existing…

    570 GitHub stars~4.6k tokensUpdated 7 days ago
    Media & CreativeAuto-check passed
  • AI Image Generation

    aiskillstore/marketplace

    Generate AI images with FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI.

    433 GitHub starsUsed in 2 repos~1.1k tokens
    Media & CreativeAuto-check passed
  • AI Image Generation

    aiskillstore/marketplace

    Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI.

    433 GitHub starsUsed in 1 repo~1.3k tokens
    Media & CreativeAuto-check passed

More from social-media-skills/skills

All 106 skills in this repo
  • AI Image Editing

    social-media-skills/skills

    The AI image-editing router — inpainting/object removal, background removal, upscaling, outpainting, old-photo restoration, and retouch, routed task-first to the right engine.

    134 GitHub stars~2.1k tokensUpdated 9 days ago
    Auto-check passed
  • AI Music And Sound

    social-media-skills/skills

    The AI music + sound-design skill for social -- original/licensed audio beds and sound design for Reels/TikToks/Shorts/videos.

    134 GitHub stars~1.9k tokensUpdated 9 days ago
    Auto-check passed
  • AI Search Optimization

    social-media-skills/skills

    A skill your agent uses to get a brand and its content CITED and RECOMMENDED by AI answer engines — the GEO (Generative Engine Optimization) / AI-search-visibility skill.

    134 GitHub stars~2k tokensUpdated 9 days ago
    Auto-check passed
  • AI Video

    social-media-skills/skills

    The model-agnostic AI-video router and brief — the counterpart to image-prompt.

    134 GitHub stars~1.3k tokensUpdated 9 days ago
    Auto-check passed
  • AI Voiceover

    social-media-skills/skills

    The AI narration / voiceover mini-skill (ElevenLabs-led). An agent skill from social-media-skills/skills.

    134 GitHub stars~1.1k tokensUpdated 9 days ago
    Auto-check passed
  • Analytics And Reporting

    social-media-skills/skills

    Social media analytics and reporting — read native platform data honestly and turn it into next actions.

    134 GitHub stars~1.4k tokensUpdated 9 days ago
    Auto-check passed

Questions about Flux

What does Flux do?

The FLUX craft skill (Black Forest Labs) — generate and edit on-brand images with the right variant and license. Flux is an agent skill from social-media-skills/skills. The FLUX craft skill (Black Forest Labs) — generate and edit on-brand images with the right variant and license.

When should I use Flux?

Flux fits situations like: someone wants to generate images with FLUX/FLUX.2/Kontext; edit a generated image; keep a character; product consistent across a campaign.

How do I install Flux in Claude Code?

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

How do I install Flux in Codex?

Run `npx skills add social-media-skills/skills --skill flux -a codex`. Or copy the skill folder (skills/flux in social-media-skills/skills) into .agents/skills/flux in your project. Codex loads it when a task matches its description.

Can I use Flux 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 social-media-skills/skills --skill flux -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, .gemini/skills/flux, .github/skills/flux and .opencode/skills/flux in your project.

What does Flux need to run?

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

Does Flux access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

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

Flux 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 use?

About 2.1k tokens (SKILL.md is roughly 8.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.2k tokens, read only when the agent opens those files.

What are the alternatives to Flux?

Skills that share tags, products or a category with Flux: Image (Nexus-JPF/note-companion, 870 stars), AI Image Prompts Skill (LeoYeAI/openclaw-master-skills, 2.2k stars), Nano Banana Pro Prompts Recommend Skill (YouMind-OpenLab/nano-banana-pro-prompts-recommend-skill, 1.9k stars) and Zy Cinematic Realism (popopo-99/zy-cinematic-realism, 570 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Flux?

social-media-skills (a GitHub organization) maintains it in social-media-skills/skills, which has 134 GitHub stars. The repository holds 106 skills in this directory. The repository was last updated on October 1, 2026.

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