Bria publishes a set of agent skills: instruction files and helper scripts that teach a coding agent how to call the Bria API well. Once installed, you ask your agent in plain language ("remove the background from these five product photos and place them in a kitchen scene") and it plans the calls, runs them against the REST API with your key, and saves the results.
Skills are the right fit when your agent works in a shell or IDE and you want reproducible scripts alongside your code. If your client speaks MCP and you want Bria available as tools with no scripts involved, use the MCP server instead. Both use the same API and the same account.
Works with: Claude Code, Cursor, Cline, Codex and every agent supported by skills.sh.
/plugin marketplace add Bria-AI/bria-skill
/plugin install bria-ai@bria-skillsThe marketplace also bundles remove-background, vgl and image-utils as separate plugins, for example /plugin install remove-background@bria-skills.
npx skills add bria-ai/bria-skillThe skills CLI installs into the skill directory of the agent you pick. For Cursor, that is ~/.cursor/skills/; each skill is a folder containing a SKILL.md file, so you can also copy the skills/ folder from the repository by hand.
npx bria-skillsCopies the skills into ~/.claude/skills/bria-skills/ for Claude Code. Run npx bria-skills uninstall to remove them.
Create a key in the Bria Console and export it. The skills read BRIA_API_KEY (the SDK and MCP server read BRIA_API_TOKEN; set both if you use more than one integration):
export BRIA_API_KEY="<your-bria-api-key>"If the key is missing, the skill walks you through setup the first time you use it.
| Skill | What it covers |
|---|---|
bria-ai | The core skill: text-to-image with FIBO, instruction-based editing, object add/replace/erase, masked edits, background removal (plain or guided by a prompt) and replacement, relight, restyle, reseason, expansion, upscaling, product cutouts, packshots, lifestyle shots, product holding and virtual try-on, and a batch product-catalog pipeline with marketplace presets. |
remove-background | A focused skill for transparent PNGs and cutouts (RMBG 2.0). The fastest path when background removal is all you need. Name what to keep or drop ("keep the mat", "only the chair") and it runs Guided Remove Background instead of the plain cut. |
vgl | Writing VGL structured prompts for deterministic, reproducible generation: objects, lighting, camera, composition and style as JSON. |
image-utils | Classic manipulation with Pillow (resize, crop, composite, watermark, format conversion) for post-processing results. Requires pip install Pillow requests. |
| Capability | Control | Example |
|---|---|---|
| Generate images from text | Prompt, aspect ratio, VGL JSON | "A modern office with natural lighting, 16:9" |
| Edit specific objects | Add, replace or remove by name | "Replace the red mug with a blue one" |
| Edit by instruction | Whole image, natural language | "Make it golden hour" |
| Edit masked regions | Pixel-level, only where you paint | Inpaint the sky and nothing else |
| Remove backgrounds | Automatic transparent PNGs | One call, no manual masking |
| Keep or drop part of a cutout | Plain words on top of the default cut, original pixels kept | "Remove the background but keep the mat and the plant" |
| Control lighting, style or season | Independently of content | Oil painting, winter snow, spotlight |
| Expand images | Directional outpainting | Square to 16:9 |
| Product photography | Scene control | "Kitchen countertop, morning light" |
| Put a product in someone's hands | Person photo plus 1-3 product photos, no prompt needed | "Have her hold this can, logo facing the camera" |
| Put garments on a person | Person photo plus 1-3 garment photos, no prompt needed | "Dress him in the navy blazer and grey trousers" |
| Upscale | 2x or 4x, detail-preserving | Print-ready assets |
| Pipelines | Chain steps | Generate, remove background, lifestyle shot |
- Building a website: "Generate a hero image for a SaaS landing page, 16:9, modern and clean."
- E-commerce catalog: "Turn the photos in
./raw/into cutouts, packshots and an Amazon-ready listing set." - Presentations: "Create a slide visual showing data analytics, blue gradient, corporate style."
- Repository and skill sources
- API endpoint reference used by the skill
- VGL schema reference
- Prefer tools over scripts? See the MCP server. Building an application? See the Python SDK.