# shared-badge

This Claude Code skill standardizes status and label pills with a shared Badge component. It activates when a badge is added to a list, table, or dialog.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 1120 repo stars
- Author: rerun-build
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/rerun-build/rerun/tree/HEAD/.claude/skills/shared-badge/SKILL.md
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/shared-badge

## What it does

The skill routes status labels to the shared `Badge` component from `@rerun/ui/primitives` or to the project’s existing wrappers. It uses `BadgeTone` for color instead of styling a `span` with local color classes. Existing status-to-tone mappings should be reused; an unfamiliar status falls back to `neutral`.

\`Badge` renders a `span`, so a clickable label needs a button wrapper or `StatusBadgeButton`. The skill also separates badges from elements that should keep their own treatment, such as `kbd` shortcuts, code blocks, and data labels that carry no state. Tone tokens belong in `packages/ui/src/styles.css`, not in the calling component.

Type checking uses `cd apps/ui && npx tsc --noEmit`; `rg` commands help locate hand-styled status pills. Imports should come from `@rerun/ui/primitives`, not the `@rerun/ui` barrel, which pulls in the whole package.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add rerun-build/rerun --skill shared-badge -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add rerun-build/rerun --skill shared-badge -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add rerun-build/rerun --skill shared-badge -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install rerun-build/rerun .claude/skills/shared-badge
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add rerun-build/rerun --skill shared-badge -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/rerun-build/rerun --path .claude/skills/shared-badge
```

### Windsurf (Devin Desktop)

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

### 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/rerun-build/rerun/tree/HEAD/.claude/skills/shared-badge/SKILL.md

## When to use it
- replace a hand-styled status label with the shared `Badge`
- keep a status tone consistent across a table and dialog
- give an unknown status the neutral tone
- make a clickable badge a real button
- find status pills with local color classes

## Example prompts
- Replace the hand-styled status in this table with the shared badge component.
- Check that the dialog and admin table use the same tone for this status.
- Find status labels in `apps/ui` that use color classes on a `span`.

## Similar
- [add-molab-badge](https://affpapa.org/en/nevibecode/skills/add-molab-badge.md) — skill · 2400 installs
- [wpds](https://affpapa.org/en/nevibecode/skills/wpds.md) — skill · 4600 installs
- [shadcn-ui](https://affpapa.org/en/nevibecode/skills/nexu-io-shadcn-ui.md) — skill · 3100 installs
- [design](https://affpapa.org/en/nevibecode/skills/cognitedata-design.md) — skill · 1900 installs
- [figma-build](https://affpapa.org/en/nevibecode/skills/figma-build.md) — skill · 1600 installs
- [ui-design](https://affpapa.org/en/nevibecode/skills/mblode-ui-design.md) — skill · 1600 installs

From the same set: [rerun-build/rerun](https://affpapa.org/en/nevibecode/by/rerun-build/rerun.md) — 25 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
