Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
agentspace-so avatar

Flux Kontext

  • 355k installs
  • 31 repo stars
  • Updated May 15, 2026
  • agentspace-so/runcomfy-agent-skills

Flux Kontext is a Claude skill that edits a single image with Black Forest Labs' Flux 1 Kontext Pro model through the local RunComfy CLI.

About

Edits a single source image with Black Forest Labs' Flux 1 Kontext Pro model, invoked through the local RunComfy CLI. A developer reaches for it for targeted local edits that keep the source identity intact, like adding an object to a portrait or swapping brand text on a label. It bundles the model's documented prompting patterns and tells you when to route to a sibling model for multi-image or embedded-text edits.

  • Edits one source image with Black Forest Labs Flux 1 Kontext Pro via the RunComfy CLI
  • Bundles preservation-first prompting patterns for precise local edits
  • Routes to Nano Banana Edit / GPT Image 2 / Flux 2 Klein for multi-image or text-heavy jobs

Flux Kontext by the numbers

  • 355,105 all-time installs (skills.sh)
  • Security screen: MEDIUM risk (skills.sh audit)
  • Data as of Jul 28, 2026 (Skillselion catalog sync)
At a glance

flux-kontext capabilities & compatibility

Skill is MIT-licensed; needs a RunComfy account and GPU generation is billed by RunComfy.

Capabilities
image editing · brand asset editing
Use cases
image generation
Runs
Local or remote
Pricing
Bring your own API key
From the docs

What flux-kontext says it does

single-reference precise local image edit
SKILL.md
Strong prompt control, consistent outputs, high fidelity.
SKILL.md
For multi-image or web-grounded edits, route to Nano Banana Edit.
SKILL.md
npx skills add https://github.com/agentspace-so/runcomfy-agent-skills --skill flux-kontext

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs355k
repo stars31
Security audit2 / 3 scanners passed
Last updatedMay 15, 2026
Repositoryagentspace-so/runcomfy-agent-skills

How do you run Flux Kontext Pro edits on RunComfy?

Make a precise single-image local edit (swap label text, add an object) while preserving the source identity.

Who is it for?

Single-image precise local edits that must preserve source identity

Skip if: Multi-image fanout or editing embedded/multilingual text in an image

When should I use this skill?

User says 'flux kontext', 'kontext', or asks to edit one image with this model

What you get

High-fidelity edited image, Flux Kontext schema parameters, and runcomfy CLI command.

  • edited image file downloaded to output-dir

By the numbers

  • 4 input schema fields (prompt, image, aspect_ratio, seed)
  • single source image per call

Files

SKILL.mdMarkdownGitHub ↗

Flux Kontext Pro — Pro Pack on RunComfy

runcomfy.com · Model page · GitHub

Black Forest Labs' Flux 1 Kontext Pro — single-reference precise local image edit — hosted on the RunComfy Model API. Strong prompt control, consistent outputs, high fidelity.

npx skills add agentspace-so/runcomfy-skills --skill flux-kontext -g

When to pick this model (vs siblings)

You wantUse
Single-image precise local edit ("she's now holding X")Flux Kontext
High-fidelity preservation of source identityFlux Kontext
Batch edits across 1–20 imagesNano Banana Edit
Edit multilingual / embedded text in imageGPT Image 2 edit
Generate from scratch, no source imageFlux 2 Klein

If the user said "Flux Kontext" / "kontext" / "BFL Kontext" explicitly, route here regardless.

Prerequisites

1. RunComfy CLInpm i -g @runcomfy/cli 2. RunComfy accountruncomfy login opens a browser device-code flow. 3. CI / containers — set RUNCOMFY_TOKEN=<token> instead of runcomfy login.

Endpoints + input schema

blackforestlabs/flux-1-kontext/pro/edit

FieldTypeRequiredDefaultNotes
promptstringyesSingle declarative edit instruction.
imagestringyesSingle source image URL (publicly fetchable HTTPS).
aspect_ratioenumno(input)Pick from supported W:H options on the model page.
seedintnoReuse for variant comparisons.

The schema is intentionally minimal — Kontext leans on prompt + single ref. For multi-image or web-grounded edits, route to Nano Banana Edit.

How to invoke

Default — local edit, preserve everything else:

runcomfy run blackforestlabs/flux-1-kontext/pro/edit \
  --input '{
    "prompt": "Keep the person'\''s face, pose, and clothing unchanged. Add an orange umbrella in her left hand and a slight smile.",
    "image": "https://.../portrait.jpg"
  }' \
  --output-dir <absolute/path>

With seed for reproducible variant series:

runcomfy run blackforestlabs/flux-1-kontext/pro/edit \
  --input '{
    "prompt": "Keep the bottle, label, and lighting unchanged. Replace the brand text on the label from \"ALPHA\" to \"AURA\".",
    "image": "https://.../bottle.jpg",
    "seed": 42
  }' \
  --output-dir <absolute/path>

Prompting — what actually works

One declarative instruction. Kontext shines on prompts shaped like the docs example: "She is now holding an orange umbrella and smiling". Imperative mood, single change.

Preservation first. Lead with "Keep [identity / pose / framing / brand] unchanged." Then the change. Models honor what's stated up front.

Single ref only — pick the right one. No multi-image fanout here

Related skills

How it compares

Pick flux-kontext when one reference image needs surgical local edits; pick Nano Banana Edit or GPT Image 2 edit for batch or in-image text workflows.

FAQ

What CLI endpoint does flux-kontext call?

flux-kontext runs runcomfy run blackforestlabs/flux-1-kontext/pro/edit through the local RunComfy CLI. The skill supplies single-image-plus-prompt schema and documented prompting patterns.

When should developers use flux-kontext over Nano Banana Edit?

flux-kontext targets Flux 1 Kontext Pro for single-reference precise local edits with strong prompt control. Nano Banana Edit fits batch edits up to 20 images or identity-preserving multi-input workflows.

Is Flux Kontext safe to install?

skills.sh reports 2 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.