/ Directory / Playground / bria-skill
● Community Bria-AI ⚡ Instant

bria-skill

by Bria-AI · Bria-AI/bria-skill

Commercial-grade image generation + editing: 18+ capabilities including object replace, background remove (RMBG-2.0), upscale, restyle, relight, product photography — 37+ agent compatibility.

Bria skill wraps Bria AI's commercial-safe image stack (Fibo, RMBG-2.0, VGL structured prompts) for AI coding agents. Covers text-to-image, object-level editing (replace/remove by name), background removal to transparent PNG, 2x/4x upscaling, relighting, restyling, and product photography. Pipeline chaining lets you compose ops. Free tier available.

Why use it

Key features

Live Demo

What it looks like in practice

bria-skill.replay ▶ ready
0/0

Install

Pick your client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "bria-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Bria-AI/bria-skill",
        "~/.claude/skills/bria-skill"
      ],
      "_inferred": true
    }
  }
}

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "bria-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Bria-AI/bria-skill",
        "~/.claude/skills/bria-skill"
      ],
      "_inferred": true
    }
  }
}

Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "bria-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Bria-AI/bria-skill",
        "~/.claude/skills/bria-skill"
      ],
      "_inferred": true
    }
  }
}

Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "bria-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Bria-AI/bria-skill",
        "~/.claude/skills/bria-skill"
      ],
      "_inferred": true
    }
  }
}

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "bria-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Bria-AI/bria-skill",
        "~/.claude/skills/bria-skill"
      ]
    }
  ]
}

Continue uses an array of server objects rather than a map.

~/.config/zed/settings.json
{
  "context_servers": {
    "bria-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/Bria-AI/bria-skill",
          "~/.claude/skills/bria-skill"
        ]
      }
    }
  }
}

Add to context_servers. Zed hot-reloads on save.

claude mcp add bria-skill -- git clone https://github.com/Bria-AI/bria-skill ~/.claude/skills/bria-skill

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use bria-skill

Turn a phone-shot product photo into a studio-quality listing image

👤 E-commerce teams without a photo budget ⏱ ~30 min beginner

When to use: You have a product photo but it needs studio treatment.

Prerequisites
  • Bria API key — Sign up at platform.bria.ai; free tier available
  • Skill installed — npx skills add bria-ai/bria-skill OR clone directly
Flow
  1. Remove background
    Use bria-skill RMBG-2.0 on product.jpg — clean transparent PNG.✓ Copied
    → Transparent PNG returned
  2. Relight + restyle
    Composite onto a soft-gradient background, three-quarter lighting, subtle shadow.✓ Copied
    → Studio-grade output
  3. Upscale for hero
    Upscale 2x for the product page hero.✓ Copied
    → High-res final

Outcome: Listing-ready hero image in minutes.

Pitfalls
  • Over-editing kills the real product — Keep changes subtle; customers spot over-smoothing

Replace or remove an object in an image by name

👤 Marketers iterating on creatives ⏱ ~10 min beginner

When to use: You have an image but one element is wrong.

Flow
  1. Describe the edit
    In scene.jpg, replace the coffee mug on the desk with a water bottle.✓ Copied
    → Edit applied; surrounding context preserved

Outcome: Clean edit that doesn't look photoshopped.

Pitfalls
  • Ambiguous object references ('the blue thing') — Be specific — 'the mug in the lower-left'

Adjust lighting / season for a campaign variant

👤 Content teams refreshing campaigns ⏱ ~20 min intermediate

When to use: Existing campaign shot; need a winter variant without a reshoot.

Flow
  1. Relight
    Take campaign.jpg; change lighting to golden-hour low-angle.✓ Copied
    → Lighting shifted convincingly
  2. Seasonal touches
    Add subtle snow / winter atmosphere without changing the subject.✓ Copied
    → Seasonal variant

Outcome: Campaign variant shipped in one chat.

Combinations

Pair with other MCPs for X10 leverage

Generate novel visuals with the other skill, then refine edits with Bria's deterministic ops

Generate with Nano Banana; run bria remove_background + relight.✓ Copied
bria-skill + filesystem

Batch over a directory of product shots

Run the product-photography pipeline on every jpg in products/.✓ Copied

Tools

What this MCP exposes

ToolInputsWhen to callCost
text_to_image prompt (VGL structured ok) New visual Bria credits
remove_background image Need cutout Bria credits
object_replace image, target name, replacement Change specific item Bria credits
upscale image, factor (2x|4x) Before print / hero Bria credits
restyle image, style ref Campaign variants Bria credits
relight image, lighting descriptor Atmosphere change Bria credits
pipeline ordered ops Multi-step edits Sum of ops

Cost & Limits

What this costs to run

API quota
Bria free tier + paid credits
Tokens per call
Low orchestration; Bria cost dominates
Monetary
Free tier generous for small tests; paid for production
Tip
Pipeline ops efficiently — remove_background + upscale in one chain amortizes setup

Security

Permissions, secrets, blast radius

Credential storage: BRIA_API_KEY in env
Data egress: Images go to platform.bria.ai

Troubleshooting

Common errors and fixes

Object replace misses the target

Be more specific in the target description; add position hints

RMBG artifacts on fine hair / fur

Use a refine pass or second model specialized for hair

401

BRIA_API_KEY missing/expired

Verify: curl -H 'api-token: $BRIA_API_KEY' https://engine.prod.bria-api.com/v1/account

Alternatives

bria-skill vs others

AlternativeWhen to use it insteadTradeoff
Ultimate AI Media GeneratorYou want multi-model generation more than clean editing primitivesLess commercial-safe by default

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills