> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dreamlayer.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Image workflows for agents

> Install DreamLayer skills for logo concepts, product imagery, marketing visuals, print artwork, sprite animations and game-engine imports.

## What this lets you do

Create and edit image files from your agent, then save them into your project. The [DreamLayer workflow repository](https://github.com/TheDesignFounder/dreamlayer-agent-plugin) provides portable skills and Claude Code and Codex plugin packages from one maintained source.

| Job                                          | Workflow                                     | Check before delivery                                                            |
| -------------------------------------------- | -------------------------------------------- | -------------------------------------------------------------------------------- |
| Original images, edits, cutouts and upscales | `generate-or-edit-image`                     | Dimensions, transparency and reference fidelity                                  |
| Logos and app icons                          | `logo-and-app-icon-concepts`                 | Raster concept quality and small-size readability; no vector guarantee           |
| Product imagery                              | `product-image-generation`                   | Product shape, label, color and other details against the reference              |
| Shirts, stickers and posters                 | `print-on-demand-artwork`                    | Supplier pixel requirements and transparency before calling an asset print-ready |
| Ads and social visuals                       | `marketing-image-variations`                 | Copy, claims, dimensions and branding                                            |
| Repeated photo operations                    | `batch-photo-editing`                        | Per-file results and total credit budget                                         |
| Reference-based animation                    | `sprite-sheet-from-reference`                | Frame count, alpha, timing and visible motion quality                            |
| Engine import                                | `godot-sprite-import`, `unity-sprite-import` | Playback in the target engine                                                    |

## What you need

* Node.js 22.12 or later.
* An API key from the [developer console](https://platform.dreamlayer.io).
* Credits for paid generation. New API accounts start at zero credits.
* `dreamlayer@0.4.0-beta.3` or `@dreamlayer/mcp@0.4.0-beta.3` for the complete workflow, including sprites. The stable `latest` tag remains `0.3.0`.

## Steps

1. Install the task instructions and choose your agent and desired skills:

```sh theme={null}
npx skills add TheDesignFounder/dreamlayer-agent-plugin
```

2. Configure DreamLayer using the [client setup guide](https://github.com/TheDesignFounder/dreamlayer-agent-plugin/blob/main/docs/client-setup.md). Supply the API key to the MCP server process through private configuration. Do not commit it.
3. Ask the agent to read capabilities and balance. These calls spend no credits.
4. Give it a concrete brief, destination and authorized credit budget. For example: “Create one original app-icon concept for a gardening app, save the PNG into my assets folder, and use at most one image operation.”
5. Inspect the result. For sprites, review the preview before using the [Godot or Unity examples](https://github.com/TheDesignFounder/dreamlayer-agent-plugin/tree/main/examples).

## Confirm it worked

The agent should produce a saved local file and identify its dimensions, any limitations and the completed execution. A skill installation alone does not prove that authentication, generation or engine playback works.

The example repository includes a real reference-to-seven-frame ZIP. Its Godot import was checked for frame advancement. Unity files require validation in your Unity editor.

## Common errors

* **Missing tools:** installing skills supplies instructions; configure the MCP server separately.
* **Unsupported sprites:** use the pinned beta and check `sprite_sheet` in capabilities.
* **Insufficient credits:** read balance and compare against the whole quote. Do not start a smaller or different job without an authorized scope.
* **Interrupted stream or rate limit:** save the execution ID and cursor, back off, then resume the existing job. Do not repeatedly poll in a tight loop.
* **Download failure:** fix the destination and download the completed execution again.

## Troubleshooting

Follow [execution recovery](/agent-api/jobs-and-events). Ordinary image operations currently cost one credit each. Sprite pricing depends on frame count and rounds upward once per order to a tenth of a credit; quote from capabilities and enforce `max_credits`.

Raster outputs do not imply SVG files, trademark clearance, verified print compliance, exact product fidelity, pixel-perfect artwork or guaranteed animation quality. Store and ad publishing are separate actions.

## Next steps

Read [MCP tools](/mcp/tools), [CLI automation](/cli/automation), or the [sprite contract](/agent-api/sprite-sheet). The repository's installation guide covers Cursor, OpenCode, GitHub Copilot and Gemini CLI as well as the plugin packages. Repository installation is separate from acceptance into a public marketplace directory.
