---
slug: "bria-skill"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/Bria-AI/bria-skill@main/README.md"
repo: "https://github.com/Bria-AI/bria-skill"
source_file: "README.md"
branch: "main"
---
# Bria AI Skills — Controllable Image Generation for Coding Agents

Generate, edit, and precisely control images directly from your AI coding agent using [Bria.ai](https://bria.ai)'s commercially-safe models. Unlike black-box generators, Bria gives you fine-grained control: edit specific objects, mask regions, control lighting/season/style independently, and chain operations in pipelines.

**Works with:** Claude Code, Cursor, Cline, Codex, and [37+ other agents](https://skills.sh)

## Quick Start

### 1. Install

**Claude Code (plugin):** add the marketplace, then install the plugin:

```
/plugin marketplace add Bria-AI/bria-skill
/plugin install bria-ai@bria-skills
```

The marketplace also bundles the `remove-background`, `vgl`, and `image-utils` plugins — install any of them the same way (e.g. `/plugin install remove-background@bria-skills`).

**Other agents** (Cursor, Cline, Codex, and [37+ more](https://skills.sh)):

```bash
npx skills add bria-ai/bria-skill
```

### 2. Get a free API key

Sign up at [platform.bria.ai](https://platform.bria.ai/console/account/api-keys?utm_source=skill&utm_campaign=bria_skills&utm_content=readme) and create an API key.

### 3. Set the key

```bash
export BRIA_API_KEY="your-key-here"
```

Or just start using the skill — it will walk you through setup automatically.

### 4. Use it

Ask your agent to generate images, remove backgrounds, edit photos, and more. The skill handles the rest.

## Skills Included

| Skill | Description |
|-------|-------------|
| **[bria-ai](https://github.com/Bria-AI/bria-skill/blob/HEAD/skills/bria-ai/SKILL.md)** | Controllable image generation & editing — 18+ capabilities including text-to-image, object-level editing, background removal, upscaling, restyling, relighting, and product photography |
| **[remove-background](https://github.com/Bria-AI/bria-skill/blob/HEAD/skills/remove-background/SKILL.md)** | Dedicated background removal — transparent PNGs, cutouts, and foreground extraction powered by RMBG 2.0. Fastest path for background removal tasks |
| **[vgl](https://github.com/Bria-AI/bria-skill/blob/HEAD/skills/vgl/SKILL.md)** | Maximum generation control — structured JSON (Visual Generation Language) that explicitly defines objects, lighting, camera, composition, and style for deterministic, reproducible results |
| **[image-utils](https://github.com/Bria-AI/bria-skill/blob/HEAD/skills/image-utils/SKILL.md)** | Classic image manipulation — resize, crop, composite, watermarks, format conversion with Python Pillow |

## What You Can Control

| Capability | Control Level | Example |
|------------|---------------|---------|
| **Generate images from text** | Prompt + aspect ratio + VGL structured JSON | "A modern office with natural lighting, 16:9" |
| **Edit specific objects** | Object-level — add, replace, or remove by name | "Replace the red mug with a blue one" |
| **Edit by instruction** | Image-level — natural language control | "Change the mug color to red" |
| **Edit masked regions** | Pixel-level — paint exactly where to change | Inpaint only the sky, leave everything else |
| **Remove backgrounds** | Automatic — clean transparent PNGs | One API call, no manual masking |
| **Control lighting** | Independent — change light without touching content | Golden hour, spotlight, dramatic shadows |
| **Control style** | Independent — restyle without changing structure | Oil painting, anime, cartoon, 3D render |
| **Control season** | Independent — change season/weather only | Spring blossoms, winter snow |
| **Expand images** | Directional — extend boundaries with context | Outpaint to 16:9 from a square |
| **Product photography** | Scene control — place products in any setting | "Modern kitchen countertop, morning light" |
| **Upscale resolution** | 2x or 4x — preserves details | Super resolution enhancement |
| **Pipeline chaining** | Multi-step — compose operations in sequence | Generate -> remove BG -> lifestyle shot |

## Example Use Cases

**Building a website?** Ask: "Generate a hero image for a SaaS landing page, 16:9, modern and clean"

**E-commerce catalog?** Ask: "Remove the background from this product photo and place it in a kitchen scene"

**Batch assets?** Ask: "Generate product photos for these 5 items and create transparent PNGs for each"

**Presentations?** Ask: "Create a slide visual showing data analytics, blue gradient, corporate style"

## Alternative Installation

### Claude Code (direct)

```bash
claude mcp add bria-skills -- npx -y bria-skills
```

### Cursor

Download the skill folders to `~/.cursor/skills/`. Each skill is a folder containing a `SKILL.md` file.

### Manual (any agent)

Copy the `skills/` directory contents to your agent's skills directory.

## Requirements

- **Bria API key** — Free at [platform.bria.ai](https://platform.bria.ai/console/account/api-keys?utm_source=skill&utm_campaign=bria_skills&utm_content=readme)
- **For image-utils:** `pip install Pillow requests`

## Documentation

- [bria-ai SKILL.md](https://github.com/Bria-AI/bria-skill/blob/HEAD/skills/bria-ai/SKILL.md) — Core skill with all capabilities
- [remove-background SKILL.md](https://github.com/Bria-AI/bria-skill/blob/HEAD/skills/remove-background/SKILL.md) — Dedicated background removal skill
- [API Endpoints Reference](https://github.com/Bria-AI/bria-skill/blob/HEAD/skills/bria-ai/references/api-endpoints.md) — Complete API documentation
- [Shell Client (bria_client.sh)](https://github.com/Bria-AI/bria-skill/blob/HEAD/skills/bria-ai/references/code-examples/bria_client.sh) — Single-function helper for all endpoints
- [VGL Schema Reference](https://github.com/Bria-AI/bria-skill/blob/HEAD/skills/vgl/references/schema-reference.md) — Full VGL JSON schema

## License

MIT