Bria AI Skills — Controllable Image Generation for Coding Agents

Generate, edit, and precisely control images directly from your AI coding agent using 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

Quick Start

1. Install

npx skills add bria-ai/bria-skill

2. Get a free API key

Sign up at platform.bria.ai and create an API key.

3. Set the key

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 | Controllable image generation & editing — 18+ capabilities including text-to-image, object-level editing, background removal, upscaling, restyling, relighting, and product photography | | vgl | Maximum generation control — structured JSON (Visual Generation Language) that explicitly defines objects, lighting, camera, composition, and style for deterministic, reproducible results | | image-utils | 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)

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
• For image-utils: pip install Pillow requests

Documentation

• bria-ai SKILL.md — Core skill with all capabilities
• API Endpoints Reference — Complete API documentation
• Shell Client (bria_client.sh) — Single-function helper for all endpoints
• VGL Schema Reference — Full VGL JSON schema

License

MIT