Best for
- User asks to edit, modify, inpaint, or make a variation of an existing image.
- Background removal or swap on a provided asset.
- Upscaling or restyling an existing render from a prior generation run.
Source profileQuality 92/100
event4u-app/agent-config/src/skills/image-editing/SKILL.md
image-editing
Edit an existing image — inpaint, background swap, variation — via providers that support it. Use when editing/modifying/inpainting an image or making variations.
- Source repository stars
- 7
- Declared platforms
- 0
- Static risk flags
- 0
- Last source update
- 2026-07-28
- Source checked
- 2026-07-28
Decision brief
What it does—and where it fits
Edit or vary an existing image: inpaint masked regions, swap backgrounds, produce variations from a seed, or upscale — routed to providers that support the edit API, with governance applied before delivery. All adapters are scaffold-tier (dry-run) until promoted to stable.
Not for
- Tasks that require unconfirmed production actions or broad system permissions.
- Environments where the pinned source and install steps cannot be inspected.
Compatibility matrix
Platform support, with evidence labels
| Platform | Status | Evidence | What to check |
|---|---|---|---|
| Codex | Not declared | No explicit evidence | Portability before use |
| Claude Code | Not declared | No explicit evidence | Portability before use |
| Cursor | Not declared | No explicit evidence | Portability before use |
| Gemini CLI | Not declared | No explicit evidence | Portability before use |
Installation
Inspect first. Install second.
The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.
Source-detected install commandSource
npx skills add https://github.com/event4u-app/agent-config --skill "src/skills/image-editing"Safe inspection promptEditorial
Inspect the Agent Skill "image-editing" from https://github.com/event4u-app/agent-config/blob/0adf49a8ae84b0ff6e2de8759eea43257e020eff/src/skills/image-editing/SKILL.md at commit 0adf49a8ae84b0ff6e2de8759eea43257e020eff. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.
Workflow
What the source asks the agent to do
- 01
Procedure
1. Identify the edit type — classify the request: inpaint (replace a masked region), background (remove or swap), variation (alternate version of the same subject), or upscale (resolution increase). 2. Confirm provider support — not all providers support image editing. GPT Image…
Identify the edit type — classify the request: inpaint (replace a maskedConfirm provider support — not all providers support image editing. GPT Image 2Route the provider via image-provider-routing — - 02
When to use
User asks to edit, modify, inpaint, or make a variation of an existing image.
User asks to edit, modify, inpaint, or make a variation of an existing image.Background removal or swap on a provided asset.Upscaling or restyling an existing render from a prior generation run. - 03
Output format
1. Edit plan — edit type, chosen provider, routing rationale, and prompt string ready to copy. 2. Provider + params — adapter file reference, source image path, mask path (if inpaint), key params (aspect ratio, strength, seed/ref-image for variation). 3. Artifact path / dry-run…
Edit plan — edit type, chosen provider, routing rationale, and prompt stringProvider + params — adapter file reference, source image path, mask path (ifArtifact path / dry-run note — the path returned by the adapter, or an - 04
Gotcha
Scaffold-tier adapters produce plans, not pixels — adapters for GPT Image 2,
Scaffold-tier adapters produce plans, not pixels — adapters for GPT Image 2,Not all providers support editing — Ideogram and Recraft are primarilyVariation needs the original seed or ref-image — requesting a variation without - 05
Do NOT
Do NOT assume every provider supports image editing — check provider capability
Do NOT assume every provider supports image editing — check provider capabilityDo NOT skip image-likeness-and-rights when the source image or edit promptDo NOT claim a live edit is produced while adapters are scaffold-tier — surface
Permission review
Static risk signals and limitations
No configured static risk pattern was detected
This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.
Evidence record
Why each signal appears
EvidenceSourceComputedTestedEditorial
| Signal | Value | Evidence type | Meaning |
|---|---|---|---|
| Quality score | 92/100 | Computed | Documentation, specificity, maintenance, and trust rules |
| Repository stars | 7 | Source | Repository attention, not individual Skill quality |
| Compatibility | 0 platforms | Source | Declared in the catalog source record |
| Usage guide | automated source guide | Editorial | Generated or reviewed according to the visible evidence level |
Pinned source
Provenance and original SKILL.md
- Repository
- event4u-app/agent-config
- Skill path
- src/skills/image-editing/SKILL.md
- Commit
- 0adf49a8ae84b0ff6e2de8759eea43257e020eff
- License
- MIT
- Collected
- 2026-07-28
- Default branch
- main
View the original SKILL.md
image-editing
Edit or vary an existing image: inpaint masked regions, swap backgrounds, produce
variations from a seed, or upscale — routed to providers that support the edit API,
with governance applied before delivery. All adapters are scaffold-tier (dry-run) until promoted to stable.
When to use
- User asks to edit, modify, inpaint, or make a variation of an existing image.
- Background removal or swap on a provided asset.
- Upscaling or restyling an existing render from a prior generation run.
- Any task that starts from an image rather than a blank brief.
Procedure
- Identify the edit type — classify the request:
inpaint(replace a masked region),background(remove or swap),variation(alternate version of the same subject), orupscale(resolution increase). - Confirm provider support — not all providers support image editing. GPT Image 2
and
gemini-imageboth expose an edit/inpaint endpoint. Flux and Recraft support variation via seed/ref-image only; Ideogram is largely generate-only. Check the provider's capability before proceeding. - Route the provider via
image-provider-routing— route to a provider whose adapter exposes an edit endpoint for the required edit type. Selecting a generate-only provider for an inpaint task will fail silently. - Author the edit instruction via
prompt-engineering-image— write the edit prompt in the target provider's grammar. For inpaint, describe what fills the masked region. For variation, carry the original seed/ref-image path forward. - Invoke the adapter (dry-run today) — run
node_modules/@event4u/agent-config/src/scripts/ai-image/adapters/<provider>.shwith the assembled params including the source image path and, for inpaint, the mask path. Validate the returned artifact path or dry-run confirmation. All adapters areexperimental(scaffold-tier); no live editing occurs until a maintainer promotes the adapter viaprovider-lifecycle-discipline. - Apply rights and disclosure governance — run the rights check
(
image-likeness-and-rights) when the source image or edit instruction involves a real person's likeness, a brand mark, or a named living artist's style. Attach the AI-disclosure footer permedia-governance-routingbefore delivering output.
Output format
- Edit plan — edit type, chosen provider, routing rationale, and prompt string ready to copy.
- Provider + params — adapter file reference, source image path, mask path (if inpaint), key params (aspect ratio, strength, seed/ref-image for variation).
- Artifact path / dry-run note — the path returned by the adapter, or an
explicit note: "adapter is experimental (scaffold-tier) — dry-run plan only; no
edited asset until promotion per
provider-lifecycle-discipline."
Gotcha
- Scaffold-tier adapters produce plans, not pixels — adapters for GPT Image 2,
gemini-image, Flux, and Recraft are scaffold-tier (dry-run only). This skill produces the edit blueprint + dry-run confirmation; actual edits require a maintainer to capture a smoke trace and promote the adapter tostable. Claiming an edited asset exists when no adapter is stable misleads the caller. - Not all providers support editing — Ideogram and Recraft are primarily generate-only; they do not expose a mask-based inpaint endpoint. Routing an inpaint task to them silently falls back to generation from scratch, discarding the source image entirely.
- Variation needs the original seed or ref-image — requesting a variation without carrying the seed value or ref-image path from the original generation will produce a stylistically unrelated result. The seed/ref-image is the only reliable continuity lever for variation workflows.
Do NOT
- Do NOT assume every provider supports image editing — check provider capability before routing; a generate-only provider will discard the source image.
- Do NOT skip
image-likeness-and-rightswhen the source image or edit prompt involves a real person's face, a brand mark, or a named living artist's style. - Do NOT claim a live edit is produced while adapters are scaffold-tier — surface the dry-run caveat explicitly every time.
- Do NOT use this skill for generating a new image from scratch — route that to
image-generationinstead.
See also
image-generation— generate a new image from a brief (not editing an existing one).image-provider-routing— select the right provider before writing the prompt.prompt-engineering-image— translate the edit brief into provider-specific prompt grammar.image-likeness-and-rights— rights check before editing real-person likenesses or brand marks.screenshot-hygiene— for redacting a documentation screenshot, use a deterministic opaque box/blur (never the lossy inpaint here).