# background-removal

background-removal cuts the background out of photos with the BiRefNet model through the belt CLI and returns a transparent PNG. Handy for product shots and headshots.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 243 installs · ★ 31 repo stars
- Author: 101-skills
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/101-skills/superpowers/tree/HEAD/tools/image/background-removal/SKILL.md
- Updated: 2026-08-31
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/101-skills-background-removal

## What it does

The skill passes an image URL to the `infsh/birefnet` app on inference.sh: `belt app run infsh/birefnet --input '{"image_url": "https://your-photo.jpg"}'`. What comes back is a PNG with nothing behind the subject. No model runs on your machine; the CLI is the only local piece.

Swapping a backdrop rather than deleting it goes through `falai/reve`, which takes a prompt next to the picture: transparent, a beach, whatever the shot calls for. The same app covers the two-step route — generate with `falai/flux-dev-lora`, then hand the result to Reve.

Install with `npx skills add 101-skills/superpowers --skill background-removal -a claude-code`; Codex, Cursor, Gemini CLI and OpenCode take the same line with `-a codex`, `-a cursor`, `-a gemini-cli` or `-a opencode`. First you need the `belt` CLI (`npx skills add belt-sh/cli`) and one `belt login`. `allowed-tools` lists only `Bash(belt *)`, so while the skill is active nothing outside `belt` gets run.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add 101-skills/superpowers --skill background-removal -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/background-removal/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/background-removal/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add 101-skills/superpowers --skill background-removal -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/background-removal/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add 101-skills/superpowers --skill background-removal -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/background-removal/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install 101-skills/superpowers tools/image/background-removal
```

2. **Manually: put the files in place**
- File: `.github/skills/background-removal/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add 101-skills/superpowers --skill background-removal -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/101-skills/superpowers --path tools/image/background-removal
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/background-removal/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add 101-skills/superpowers --skill background-removal -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/101-skills/superpowers/tree/HEAD/tools/image/background-removal/SKILL.md

## When to use it
- cut a product photo out of its backdrop into a transparent PNG
- swap the studio background for a beach scene
- turn a portrait into a clean headshot for a profile
- generate a mascot and strip its background in one go
- prepare design elements without hand-masking them

## Example prompts
- Remove the background from `photo.jpg` and save it as a transparent PNG
- Go through `products/` and cut out every item photo
- Change the background on this product shot to a beach

## Similar
- [video-background-removal](https://affpapa.org/en/nevibecode/skills/video-background-removal.md) — skill · 260 installs
- [remove-background](https://affpapa.org/en/nevibecode/skills/remove-background.md) — skill · 7600 installs
- [fal-image-edit](https://affpapa.org/en/nevibecode/skills/fal-image-edit.md) — skill · 2900 installs
- [ai-image-editing](https://affpapa.org/en/nevibecode/skills/ai-image-editing.md) — skill · 1200 installs
- [Cutout Labs](https://affpapa.org/en/nevibecode/mcp/cutout-labs.md) — MCP server · ★ 1 repo stars
- [video-remove-background](https://affpapa.org/en/nevibecode/skills/video-remove-background.md) — skill · ★ 76 repo stars

## Other versions with the same name
- [background-removal · eachlabs](https://affpapa.org/en/nevibecode/skills/background-removal.md) — 491 installs

From the same set: [101-skills/superpowers](https://affpapa.org/en/nevibecode/by/101-skills/superpowers.md) — 81 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
