# Image Generation agent skill (subclip-image-generation)

Generate persistent cloud images with Subclip AI from text and supported image references. Use for new images, backgrounds, plates, posters, or semantic image revisions that should appear in AI Generations.

Canonical URL: https://www.subclip.app/agent-skills/subclip-image-generation

Raw SKILL.md: https://www.subclip.app/agent-skills/subclip-image-generation/SKILL.md

Source: https://github.com/subclip-app/subclip-skills/tree/main/skills/subclip-image-generation

## Install this skill

```sh
npx -y @subclip/skills install --only subclip-image-generation
```

Install all skills with `npx @subclip/skills install`. The skills call tools that the Subclip app serves over its local MCP server. Open the app, go to Desktop settings > Connect AI client, and add the server to your agent. The app must be running while the agent works.

## Supporting references

- [Model Selection](https://www.subclip.app/agent-skills/subclip-image-generation/references/model-selection.md)

## Full SKILL.md

```markdown
---
name: subclip-image-generation
description: Generate persistent cloud images with Subclip AI from text and supported image references. Use for new images, backgrounds, plates, posters, or semantic image revisions that should appear in AI Generations.
---

# Subclip Image Generation

Subclip cloud image generation is optional and uses AI credits. If you have your own image generation (Codex, a Grok bot, another provider) you may use it instead and bring the picture in with `import_external_media` (see `$subclip-asset-creation`); use this skill when the user asks for Subclip generation or its models are the best fit.

Follow `$subclip-ai-generation` for quota, credits, async completion, history, and deletion.

Call `list_ai_models` with `kind: image`. Choose only a returned model and match its `acceptedInputs`, `maxAssets`, aspect ratios, and resolution policy. When the model accepts image references, pass them through `sourceAssets` with exact `sourceFileId` or `sourceItemId` values from `list_editor_assets` and role `reference`; do not hide references in `settings`. Use `generate_ai_media` with `kind: image` and `confirmed: true` once when the current request authorizes those exact settings. Preserve the returned operation ID; a revision is a new operation, not an overwrite.

When a completed image is used in the edit, import it as a normal MediaPanel image and verify its placement on the canvas. Do not claim its internal generated pixels are separate editable layers.

## Current model capabilities

Read [model selection and pricing](references/model-selection.md) when selecting a model, quoting credits, supplying references or comparing quality tiers. Live discovery overrides historical model lists.
```