# Shieldcn Badges

Create polished shieldcn README badges, badge groups, charts, headers, sponsors grids...

- Repository: https://github.com/jal-co/shieldcn (938 stars)
- Category: Design
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add jal-co/shieldcn --skill shieldcn-badges -g -a claude-code -y`
Codex: `npx skills add jal-co/shieldcn --skill shieldcn-badges -g -a codex -y`
Cursor: `npx skills add jal-co/shieldcn --skill shieldcn-badges -g -a cursor -y`
Gemini CLI: `npx skills add jal-co/shieldcn --skill shieldcn-badges -g -a gemini-cli -y`

## Description

Create polished shieldcn README badges, badge groups, charts, headers, sponsors grids, and full README hero sections. Use when a user wants shadcn/ui-styled badges, Shields.io replacement, npm/GitHub/CI/status badges, download charts, README header banners, contributor/sponsor images, or README Studio guidance. Triggers include "add badges", "add shields", "README badges", "npm badge", "GitHub stars badge", "CI badge", "download chart", "README header", "README banner", "contributors grid", "sponsors grid", "build a README", "README Studio", "shieldcn", and requests to make a project README look better.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# shieldcn Badges

Use [shieldcn](https://shieldcn.dev) to add beautiful shadcn/ui-styled badges,
badge groups, charts, headers, sponsors grids, and contributor images to READMEs
and docs.

Base URL: `https://shieldcn.dev`

## Install this skill

Install from the shieldcn repository with the Skills CLI:

```bash
npx skills add jal-co/shieldcn
```

Useful variants:

```bash
# Install globally instead of only the current project
npx skills add jal-co/shieldcn --global

# Install for a specific agent supported by the Skills CLI
npx skills add jal-co/shieldcn --agent AGENT_NAME

# Use once without installing
npx skills use jal-co/shieldcn@shieldcn-badges
```

Verify installation:

```bash
npx skills list
```

## What to ask your agent

Copy one of these prompts after installing the skill. Replace bracketed values
with the real project details.

### Great badge rows

```text
Add a polished shieldcn badge row to my README for [owner/repo]. Include npm
version/downloads if this package is published as [package], GitHub stars,
license, CI status, and last commit. Center the row, make badges clickable, and
use a subtle shadcn style that works on GitHub light and dark themes.
```

```text
Replace the existing Shields.io badges in this README with shieldcn equivalents.
Keep the same links where possible, remove stale or duplicate badges, and keep
the final row to 3-6 high-signal badges.
```

```text
Migrate the existing Shields.io badges in this README to shieldcn, but undo any
split-style/two-tone badges. Use single-surface shieldcn badges instead: remove
split=true, labelColor, and other split-label styling unless a split badge is
explicitly needed for readability.
```

```text
Create a compact shieldcn badge group for [owner/repo] with stars, license,
contributors, and last commit. Use one grouped image when that is cleaner than
separate badges.
```

The rest: https://github.com/jal-co/shieldcn/blob/HEAD/skills/shieldcn-badges/SKILL.md