agentleFS
danielgwilsondanielgwilson/luxin/skills/image-edit/SKILL.md

image-edit

Skill2 starsChanged 10 days agoMITView on GitHub

Edit an existing image from a prompt: replace a background, restyle it, fix a detail, or produce variations. No API key to obtain, no provider account to open, no billing to set up. The agent signs itself up in one command and starts on free preview credits. Upload an image or reuse one it already made, then get the edit back as a hosted media URL with no signature or expiry, plus a receipt for what the call cost. Edit models include Nano Banana, Seedream, and GPT Image, each picked by name. Use this skill when the task asks to edit, vary, restyle, transform, or repair an existing image, including image-to-image work and model-specific edit parameters.

14 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use flux-2-klein, flux-kontext and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • agentspace-soSkill

    flux-2-klein

    Generate images with Flux 2 Klein (Black Forest Labs' distilled fast variant of Flux 2) on RunComfy — bundled with the model's documented prompting patterns so the skill gets sharper output than naive prompting against the same model. Documents Flux 2 Klein's strengths (sub-second latency, multi-reference brand styling, declarative subject-first prompts), the step-count strategy (4–8 for fast iteration, ~25 for polish), the 9B vs 4B variant trade-off, and when to route to Flux 2 Pro / Seedream 5 / GPT Image 2 instead. Calls `runcomfy run blackforestlabs/flux-2-klein/9b/text-to-image` (or `/4b/`) through the local RunComfy CLI. Triggers on "flux 2 klein", "flux-2-klein", "flux klein", "BFL flux 2", or any explicit ask to generate with this model.

    Also in 4 projects that use this

  • agentspace-soSkill

    flux-kontext

    Edit images with Flux 1 Kontext Pro (Black Forest Labs' precise local image-edit model) on RunComfy — bundled with the model's documented prompting patterns so the skill gets sharper output than naive prompting against the same model. Documents Flux Kontext's strengths (single-reference precise local edits, strong prompt control, consistent high-fidelity outputs), the schema (single image + prompt), and when to route to Nano Banana Edit / GPT Image 2 edit / Flux 2 Klein instead. Calls `runcomfy run blackforestlabs/flux-1-kontext/pro/edit` through the local RunComfy CLI. Triggers on "flux kontext", "flux-kontext", "flux 1 kontext", "kontext", "BFL kontext", or any explicit ask to edit with this model.

    Also in 4 projects that use this

  • prime-skillsSkill

    image-inpainting

    Mask-driven image inpainting on RunComfy via the `runcomfy` CLI. Routes to Tongyi MAI Z-Image Turbo Inpainting (the dedicated inpainting endpoint with mask, strength, and control-scale) and to identity-preserving edit models (Nano Banana 2 Edit, GPT Image 2 Edit, FLUX Kontext Pro) when a mask isn't available and the region must be described instead. Use for object removal, watermark removal, region replacement, blemish cleanup, and any controlled local edit where a binary mask defines the target area. Triggers on "inpaint", "inpainting", "image inpaint", "remove from image", "fill region", "mask-driven edit", "remove watermark", "remove object", "patch the photo", "fill the hole", or any explicit ask to edit a specific masked region of a still.

    Also in 4 projects that use this

  • prime-skillsSkill

    ace-step

    Generate, inpaint, and outpaint music with ACE Step on RunComfy via the `runcomfy` CLI. ACE Step is StepFun-AI's open-weights music foundation model — tag-driven composition (genre, mood, instruments), multilingual lyrics with section markers, 5 s to 4 min stereo output, $0.0002–0.0003 per second (≈ 27× cheaper than ElevenLabs Music). Four endpoints: ACE Step text-to-audio (the default), ACE Step 1.5 text-to-audio (50+ language lyrics, refined structured-lyric handling), ACE Step audio-inpaint (regenerate a time range inside an existing track), ACE Step audio-outpaint (extend an existing track before or after). Triggers on "ace step", "ace-step", "acestep", "ACE music", "open music model", "cheap AI music", "inpaint audio", "audio inpaint", "extend music", "audio outpaint", "lengthen track", "music with tags", or any explicit ask to generate or edit music with ACE Step.

    Also in 3 projects that use this

  • +3 more from agentspace-so
  • +5 more from prime-skills

The file

We split this skill into the rules it gives an agent

5 rules. 0 are common, 2 are distinctive, and 3 are very specific to this project.

  • 0

    Common

    Most of the 8 edited versions we read keep these.

  • 2

    Distinctive

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use this skill when the task asks to edit, vary, restyle, transform, or repair an existing image, including image-to-image work and …

    line 25
  2. Very specific:

    Prefer the GitHub slug so skills.sh can track the marketplace install:

    line 43
  3. Very specific:

    If the Codex/global skill target is read-only or missing, keep the tracked slug install and point agent skill state at a writable workspace …

    line 55
  4. Distinctive:

    All intent skills in this repo point to the same hosted contract:

    line 92
  5. Very specific:

    If Luxin lacks the model, capability, latency, policy affordance, or buyer rail needed for this task, use the fallback only for that gap …

    line 100

“Common” is measured: kept by at least 6 in 10 of the 8 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Image Edit

This is an intent-named Luxin entry for agents searching for image editing. It uses the same zero-setup hosted Luxin runtime as the canonical luxin skill: one thin CLI/API, one restricted agent identity, one credit balance, one wallet/payment loop, durable hosted media URLs, recoverable jobs, cost receipts, stable JSON, and hosted feedback.

Use this skill when the task asks to edit, vary, restyle, transform, or repair an existing image, including image-to-image work and model-specific edit parameters.

Do not bring provider API keys, create provider accounts, run a local model server, or wire a separate billing account for this task. Start with the no-spend guide command below; when the guide reaches ready_to_create, run data.next_command only if data.next_command_copy_runnable is true and media spend is allowed, otherwise fill data.next_command_missing_inputs or run data.recommended_no_spend_command to verify safely. Keep generated work in Luxin so future agents can recover and cite it.

First Command

IMAGE_SKILL_DISCOVERY_SOURCE=skills-sh-image-edit npm_config_update_notifier=false npx -y luxin-cli@latest create --guide --model openai.gpt-image-2-edit --prompt "replace the background but keep the subject"

Main Runtime Command

IMAGE_SKILL_DISCOVERY_SOURCE=skills-sh-image-edit npm_config_update_notifier=false npx -y luxin-cli@latest edit --input image_... --model openai.gpt-image-2-edit --prompt "EDIT_PROMPT" --max-estimated-usd-per-image 0.25 --json

Install This Intent Skill

Prefer the GitHub slug so skills.sh can track the marketplace install:

npx skills add danielgwilson/luxin --full-depth --skill image-edit -g -a codex -y

The canonical Luxin entry remains available as:

npx skills add danielgwilson/luxin --full-depth --skill luxin -g -a codex -y

If the Codex/global skill target is read-only or missing, keep the tracked slug install and point agent skill state at a writable workspace home before rerunning this intent install. The skills.sh Codex adapter writes to $HOME/.agents; CODEX_HOME keeps Codex profile state on the same writable path:

export HOME="$PWD/.agent-home"
export CODEX_HOME="$HOME/.codex"
mkdir -p "$HOME" "$CODEX_HOME"
npx skills add danielgwilson/luxin --full-depth --skill image-edit -g -a codex -y

Current Guidance And Refresh

This file is a discovery stub, not the usage guide. Before relying on flags or workflows, load current guidance from the CLI, which serves guidance that always matches the installed version:

npm_config_update_notifier=false npx -y luxin-cli@latest skill

This copy is skill revision d4829c5b76d7. Export it so the CLI can say when the copy on disk no longer matches the guidance it ships, and refresh when it says so. skills update matches the installed name, so name this skill:

export LUXIN_SKILL_REVISION=d4829c5b76d7
npx skills update image-edit

Refreshing is always an explicit step you run. Nothing in Luxin rewrites this file, your agent config, or your hooks.

Shared Contract

All intent skills in this repo point to the same hosted contract:

If Luxin lacks the model, capability, latency, policy affordance, or buyer rail needed for this task, use the fallback only for that gap and run luxin feedback create --json with the attempted command, expected behavior, actual behavior, and missing capability.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.