AI assistants

Install a skill file, add the Depicta CLI, or connect Depicta to Claude, and your assistant can generate, edit and process images.

Let your AI agent set it up

Using Claude Code or another AI agent that can run terminal commands? Paste this, and it follows our setup instructions.

Download https://depicta.ai/SKILL.md with curl and set up Depicta for me

You’ll still sign up and add your API key yourself.

Claude Code (and Claude Desktop with a skill file)

Download a skill file from the dashboard. It includes a new API key just for that skill, and full instructions for Claude.

1. Sign up at depicta.ai/dashboard if you don’t have an account.

2. Go to the Skills page in the dashboard sidebar.

3. Click “Create & download” on the Depicta skill.

4. Name your skill — e.g., “my-laptop” or “work-pc”. Give each device its own name: downloading again with the same name replaces the earlier file and turns off its key. If you leave the name empty, a default name is used, so a second unnamed download replaces the first.

5. Choose the format:

   • Claude Desktop (the default) — downloads a .skill ZIP package
   • Claude Code — downloads a .zip package
   • Raw Markdown — downloads the .md file directly

6. Click “Create & download” — save the file to your computer.

7. Install the file:

   Claude Desktop

   Double-click the .skill file. Claude Desktop imports it automatically.

   Then open Settings → Capabilities and add *.depicta.ai to the domain allowlist, so the skill can reach Depicta. The dashboard’s setup guide shows where.

   Claude Code

   Unzip the file into ~/.claude/skills/ (all projects) or <project>/.claude/skills/ (one project). The archive contains a depicta/ folder, so the skill ends up at .../skills/depicta/SKILL.md.

8. Test it — ask Claude: “Generate a photo of a sunset over the ocean.”

Claude on the web and Claude Desktop

Nothing to download, and no API key to copy.

1. Sign up at depicta.ai.

2. In your dashboard, choose Connect Depicta to Claude and follow the steps there to add Depicta in Claude.

3. Sign in to Depicta when Claude asks, and choose a monthly limit for Claude: €10 is suggested, any whole amount from €1 to €1,000, or no limit.

4. Ask Claude for an image. To stop, disconnect Claude on your Connections page. It takes effect immediately.

To use your own pictures, ask Claude to let you add pictures with Depicta. A Depicta panel appears under its answer. The first time, Claude may ask you to allow it. Choose up to 10 pictures, then choose Add to my message.

The images Claude makes appear in a gallery under its answer. Choose Download or Open. With more than 8 images, or for a story, Show all shows every one. The links last an hour; after that, the gallery says they’ve expired.

Project rules files

Coding assistants like Cursor, Copilot, Windsurf and Cline read instructions from rules files in your project. The Raw Markdown skill file makes a good starting point for them.

Remove the API key first

Every skill file, the Raw Markdown one included, contains an API key, and project rules files usually get committed. Delete the key from the file before you save it into a project, and let the CLI supply it instead (depicta auth login or the DEPICTA_API_KEY environment variable). Never commit an API key.

Cursor

Cursor’s agent mode can run terminal commands, so it works with the Depicta CLI out of the box. To make it aware of the tool:

1. Install the CLI and authenticate.
2. Create .cursor/rules/depicta.mdc in your project with instructions about the depicta CLI — what commands are available and when to use them. You can use the Raw Markdown skill file from the dashboard as a starting point, with its API key removed.

Cursor’s agent will then run depicta image "prompt" in the terminal when it needs to generate visuals.

GitHub Copilot

Copilot’s agent mode (VS Code) can run terminal commands and supports custom instruction files:

1. Install the CLI and authenticate.
2. Create .github/copilot-instructions.md in your repo with instructions about the depicta CLI. You can base this on the Raw Markdown skill file from the dashboard, with its API key removed.

You can also create a dedicated .github/agents/depicta.agent.md custom agent for image generation tasks.

Windsurf

Windsurf’s Cascade agent runs terminal commands and supports rules files:

1. Install the CLI and authenticate.
2. Create .windsurf/rules/depicta.md in your project with instructions about the depicta CLI. Use the Raw Markdown skill file as a starting point, with its API key removed.

Cascade will run depicta commands in its dedicated terminal.

Cline

Cline executes terminal commands with explicit user approval:

1. Install the CLI and authenticate.
2. Create .clinerules (or .clinerules/depicta.md) in your project root with instructions about the depicta CLI.

Other assistants

Any AI assistant or agent that can run terminal commands can use Depicta via the CLI. The general pattern is:

1. Install the depicta CLI and authenticate with your API key.
2. Add an instruction/rules file to your project describing the CLI commands. Download the Raw Markdown format from the Skills page as a ready-made reference, and remove its API key before saving it into the project.

This works with Continue.dev (.continue/rules/), Amazon Q Developer (.amazonq/rules/), Augment Code (.augment/rules/), JetBrains AI / Junie, and any agent with terminal access.

How skill files work

The skill file teaches your AI assistant how to use Depicta. It contains:

• Instructions for generating, editing, combining, and processing images
• Available models and their capabilities
• Guidelines search for better prompt writing
• An embedded API key (unique to your download). It can create and process images, run stories and read your balance; buying credits, managing keys and changing settings stay in your dashboard.

Your assistant reads the skill file and makes API or CLI calls on your behalf — or autonomously when it decides visuals are needed.

Caution

Skill files contain your API key. Don’t commit them to public repositories or share them. If compromised, download a new one with the same skill name — this revokes the old key automatically — or revoke the key on the Skills page.

Re-downloading

Downloading a new skill file for the same name revokes the previous key and creates a fresh one. Use this to rotate keys or set up a new device.

Managing skills

View and revoke active skill keys on the Skills page in the dashboard.