Sandbox
@Bria-AI/bria-skill

Bria AI image skills for Claude Code and agents

This repo packages Bria AI skills that let your agent generate, edit, remove backgrounds from, and restyle images with direct model control. The skills cover both simple prompts and structured VGL JSON so you can steer objects, lighting, composition, and pipelines more precisely.

67 stars6 forksPythonUpdated 8d ago
Who it's for

Builders who use Claude Code, Cursor, or Codex and want image generation and editing built into their agent workflow.

What it delivers

You can create and transform images from inside your agent instead of switching to a separate image tool.

What it does

Controllable image generation

The `bria-ai` skill handles text-to-image, object edits, masking, relighting, restyling, upscaling, and product photography.

Background removal

The `remove-background` skill uses RMBG 2.0 for transparent PNGs, cutouts, and foreground extraction.

Structured VGL prompts

The `vgl` skill uses structured JSON to define objects, lighting, camera, composition, and style for reproducible image generation.

Ad layer recovery

The `ad-delayer` skill breaks flat ads into editable layers like background, product, logo, headline, copy, and CTA.

Image utilities

The `image-utils` skill provides resize, crop, composite, watermark, and format conversion workflows with Pillow.

How to get it

  1. 1Claude Code (plugin): add the marketplace, then install the plugin
    /plugin marketplace add Bria-AI/bria-skill
    /plugin install bria-ai@bria-skills
  2. 2Other agents (Cursor, Cline, Codex, and 37+ more)
    npx skills add bria-ai/bria-skill
  3. 3Run
    export BRIA_API_KEY="your-key-here"
  4. 4Run
    claude mcp add bria-skills -- npx -y bria-skills

README

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

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, ad-delayer, 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):

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

SkillDescription
bria-aiControllable image generation & editing — 18+ capabilities including text-to-image, object-level editing, background removal, upscaling, restyling, relighting, and product photography
remove-backgroundDedicated background removal — transparent PNGs, cutouts, and foreground extraction powered by RMBG 2.0. Fastest path for background removal tasks
vglMaximum generation control — structured JSON (Visual Generation Language) that explicitly defines objects, lighting, camera, composition, and style for deterministic, reproducible results
ad-delayerFlat ads back into editable layers — background, product shot, logo, headline, copy, and CTA recovered as separate assets with position, size, and typography
image-utilsClassic image manipulation — resize, crop, composite, watermarks, format conversion with Python Pillow

What You Can Control

CapabilityControl LevelExample
Generate images from textPrompt + aspect ratio + VGL structured JSON"A modern office with natural lighting, 16:9"
Edit specific objectsObject-level — add, replace, or remove by name"Replace the red mug with a blue one"
Edit by instructionImage-level — natural language control"Change the mug color to red"
Edit masked regionsPixel-level — paint exactly where to changeInpaint only the sky, leave everything else
Remove backgroundsAutomatic — clean transparent PNGsOne API call, no manual masking
Control lightingIndependent — change light without touching contentGolden hour, spotlight, dramatic shadows
Control styleIndependent — restyle without changing structureOil painting, anime, cartoon, 3D render
Control seasonIndependent — change season/weather onlySpring blossoms, winter snow
Expand imagesDirectional — extend boundaries with contextOutpaint to 16:9 from a square
Product photographyScene control — place products in any setting"Modern kitchen countertop, morning light"
Upscale resolution2x or 4x — preserves detailsSuper resolution enhancement
Pipeline chainingMulti-step — compose operations in sequenceGenerate -> 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

License

MIT

Files in the repo

Repository payload14 top-level entries
  • .claude
  • .claude-plugin
  • .github
  • .husky
  • bin
  • bria-ai-openclaw
  • kiro
  • preambles
  • skills
  • .coderabbit.yaml
  • .gitignore
  • package-lock.json
  • package.json
  • README.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More skills

Vincentwei1021/
anything2explainer

Topic in, narrated explainer video out. A Claude Code / Codex skill that turns any topic into a black-canvas motion-graphics explainer video with TTS voiceover, subtitles and a chapter progress bar. Chinese or English; every frame drawn in code with Remotion.

666

Taste-Skill - gives your AI good taste. stops the AI from generating boring, generic slop

86k

Agent skill for beautiful, verifiable architecture, workflow, sequence, data-flow, and lifecycle diagrams—self-contained HTML with motion and crisp export.

57k
img2threejs/
img2threejs

Rebuild the object in a reference image as a code-only, procedural, quality-gated, animation-ready Three.js model. Token-efficient image-to-3D.

16k