Skip to main content
skill CX Codex

shared-badge — Claude Code skill for consistent UI badges

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.

AGPL-3.0 ★ 1,120 updated 2026-11-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add rerun-build/rerun --skill shared-badge -a claude-code
Open on GitHub

What shared-badge 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.

What it helps with

  • 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 for the agent

  • 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.

How to install shared-badge

1Skills CLI (Vercel)

npx skills add rerun-build/rerun --skill shared-badge -a claude-code

2Manually: put the files in place

~/.claude/skills/shared-badge/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/shared-badge/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about shared-badge

How do I install shared-badge in Claude Code?

Run npx skills add rerun-build/rerun --skill shared-badge -a claude-code. The skill file is at ~/.claude/skills/shared-badge/SKILL.md.

What does shared-badge do?

It sets conventions for status and short text labels in the UI: use Badge or an existing wrapper, and assign color through BadgeTone.

How should I make a badge clickable?

Badge renders a span and should not handle clicks. Use StatusBadgeButton or place the badge inside a button.

Similar skills

All skills for Frontend and UI →

From the same set25

The whole set →
loading-skeletons A Claude Code skill for building loading skeletons that match each component’s layout. It applies when adding a loading state or replacing a spinner in a content area. CX Codex +1 ★ 1,120repo stars investigate-bug investigate-bug — a skill for Claude Code that gathers evidence and traces a bug to its cause before a fix is written. It starts on bug reports, incidents, customer complaints, or requests to reproduce an issue. CX Codex +1 ★ 1,120repo stars form-field-labels form-field-labels — a Claude Code skill routes form titles through the shared Field component. It activates when adding or redesigning a field in apps/ui. CX Codex +1 ★ 1,120repo stars create-dialog The create-dialog Claude Code skill sets patterns for creating and redesigning app dialogs. Short forms use a basic frame; lists that open detail views use a panel with stepped navigation. CX Codex +1 ★ 1,120repo stars update-docs The update-docs Claude Code skill checks Rerun’s documentation against code changes. It runs before work is marked done or a pull request is opened for changes to specified project areas, and on direct requests to update the docs. CX Codex +1 ★ 1,120repo stars menu-item-icons The menu-item-icons Claude Code skill helps decide which menu items need icons. It applies when creating or redesigning a DropdownMenu or ContextMenu, and when reviewing a menu where every item has an icon. CX Codex +1 ★ 1,120repo stars create-agent-template The create-agent-template Claude Code skill turns an agent idea into a Rerun template draft. It interviews about the task, builds the agent, then tests it against challenging cases. CX Codex +1 ★ 1,120repo stars supabase This Claude Code rule sets how the agent accesses a Supabase database. It requires using @src/app/supabase/supabase-helpers.ts instead of querying tables directly. CX Codex +1 ★ 1,120repo stars

Project sponsors

Companies that keep this analytics open