How do I install shieldcn?

Run these in Claude Code: npx -y skills add jal-co/shieldcn --agent claude-code. Then prompt normally.

Does shieldcn auto-invoke its skills?

Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.

Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.

Documentation

Plugin

shieldcn

Beautiful README badges, inspired by shields.io and styled like shadcn/ui.

FLOW.md

jal-co@jal-co

GitHub

Plugin Signal64/100Solid

maintained100

capable14

documented75

adopted62

Install

$ npx -y skills add jal-co/shieldcn --agent claude-code

Run the curl in your terminal, the rest in Claude Code.

Stats

TypeScript JavaScript React Next.js shadcn/ui

+4 tags

Bash Vercel GitHub Anthropic

786

Stars

Forks

Active

Maintenance

TypeScript

Language

MIT

License

4h ago

Last commit

3mo ago

Created

Repo: jal-co/shieldcn

In this plugin

1 skill

- shieldcn-badges

See everything inside

What's inside

Skills

/shieldcn-badgesCreate 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

Badges

README

Read on GitHub

Before anyone reaches your docs, they land on your README, the front door of every open-source project. shieldcn makes that first impression count: badges, charts, headers, and sponsor walls, rendered as real shadcn/ui components. A shields.io alternative.

Homepage · Docs · Studio · 𝕏

Usage

Drop a badge into any README and it renders as a real shadcn Button.

![npm](https://shieldcn.dev/npm/react.svg)
![stars](https://shieldcn.dev/github/vercel/next.js/stars.svg)
![views](https://shieldcn.dev/views/repo/shieldcn/shieldcn.svg)

Agent skill

Install the shieldcn-badges skill from skills.sh so your coding agent can add shieldcn badges, charts, and headers to READMEs:

npx skills add jal-co/shieldcn -a claude-code # installs to Claude Code
npx skills add jal-co/shieldcn -a cursor # installs to Cursor

See skills/shieldcn-badges/SKILL.md for prompt examples and options.

Star history

Rendered by the shieldcn starchart GitHub Action — star charts that survived GitHub's stargazers API restriction, updated daily by shieldcn[bot]. Add it to your repo:

- uses: jal-co/shieldcn@v1
  with:
    theme: violet

GitHub Action docs → · action reference

Contributors

MIT · Built by Justin Levine · Contribute

File tree

773

jal-co/shieldcnView on GitHub

.gitattributes
.github/
  CODE_OF_CONDUCT.md
  CONTRIBUTING.md
  dependabot.yml
  FUNDING.yml
  ISSUE_TEMPLATE/
    bug.yml
    config.yml
    feature.yml
    provider.yml
  labeler.yml
  PULL_REQUEST_TEMPLATE.md
  shieldcn/
    star-chart-dark.svg
    star-chart-light.svg
  workflows/
    ci.yml
    cli-publish.yml
    commit-check.yml
    docker-publish.yml
    labeler.yml
    release.yml
    star-chart.yml
.gitignore
.husky/
  commit-msg
  pre-commit
  pre-push
.tegami/
  publish-lock.yaml
action.yml
AGENTS.md
commit-check.toml
LICENSE
package.json
packages/
  action/
    CHANGELOG.md
    dist/
      index.js
    package.json
    README.md
    src/
      main.ts
      starhistory.ts
    tsconfig.json
  cli/
    .gitignore
    .npmignore
    LICENSE
    package.json
    README.md
    src/
      bin.ts
      brands.ts
      constants.ts
      detect.test.ts
      detect.ts
      inject.test.ts
      inject.ts
      migrate.test.ts
      migrate.ts
      output.ts
      types.ts
      url.ts
    tsconfig.json
    tsup.config.ts
    vitest.config.ts
  core/
    package.json
    scripts/
      check-visual.ts
      visual-test.ts
    src/
      badge-stats.ts
      badges/
        animate.ts
        brand-colors.ts
        button-tokens.ts
        chart-route.test.ts
        contributors-route.test.ts
        custom-icons.ts
        flags.json
        fonts.ts
        gif.ts
        github-sponsors-route.test.ts
        group-route.test.ts
        header-backgrounds.ts
        header-route.test.ts
        icon-index.ts
        icon-list.json
        icons.ts
        measure.ts
        memo-route.test.ts
        png-route.test.ts
        registry.test.ts
        registry.ts
        render-chart.test.ts
        render-chart.ts
        render-group.tsx
        render-header.test.ts
        render-header.ts
        render-safety.test.ts
        render-sponsors.ts
        render.test.ts
        render.tsx
        satori-fonts.ts
        simple-icons.test.ts
        simple-icons.ts
        sponsors-route.test.ts
        svg-parser.test.ts
        svg-parser.ts
        svg-text-utils.ts
        themes.test.ts
        themes.ts
        twemoji.test.ts
        twemoji.ts
        types.ts
        validate.ts
        views-route.test.ts
      brand-logo-mode.test.ts
      branded-brand-bridge.test.ts
      brands.test.ts
      brands.ts
      cache-distributed-backoff.test.ts
      cache.test.ts
      cache.ts
      db.ts
      fonts/
        fira-code-medium.ttf
        geist-medium.ttf
        geist-mono-medium.ttf
        inter-medium.ttf
        jetbrains-mono-medium.ttf
        roboto-medium.ttf
        space-grotesk-medium.ttf
      format.ts
      gen-counter.ts
      gen-users.ts
      github.ts
      icons/
        indiedevs.svg
        neon.svg
        notra.svg
        openpanel.svg
        shadcnblocks.svg
        shadcncraft.svg
        shieldcn.svg
        shipperclub.svg
      migrate/
        index.ts
        transform.ts
      next-fetch.d.ts
      normalize-params.ts
      provider-fetch.test.ts
      provider-fetch.ts
      providers/
        amo.ts
        badge.test.ts
        badge.ts
        bluesky.ts
        bundlephobia.ts
        chocolatey.ts
        chrome.ts
        cocoapods.ts
        codecov.ts
        commit-history.ts
        conda.ts
        coverage-color.ts
        coveralls.ts
        crates.ts
        discord.ts
        discourse.ts
        docker.ts
        fdroid.ts
        flathub.ts
        github.test.ts
        github.ts
        gitlab.ts
        hackernews.ts
        homebrew.ts
        indiedevs.ts
        jsdelivr.ts
        jsr.ts
        lemmy.ts
        liberapay.ts
        mastodon.ts
        matrix.ts
        maven.ts
        memo.test.ts
        memo.ts
        modrinth.ts
        nba.ts
        npm.ts
        nuget.ts
        opencollective.ts
        openssf.test.ts
        openssf.ts
        openvsx.ts
        packagist.ts
        pub.ts
        pypi.ts
        reddit.ts
        rubygems.ts
        shipperclub.ts
        skills.test.ts
        skills.ts
        snapcraft.ts
        sonar.ts
        stackexchange.ts
        starhistory.ts
        tokscale.ts
        twitch.ts
        url-encoding.test.ts
        views.ts
        vscode.ts
        wakatime.ts
        weblate.ts
        x.ts
        youtube.ts
      rate-limit.test.ts
      rate-limit.ts
      route-glue.test.ts
      route-handler.ts
      safe-fetch.test.ts
      safe-fetch.ts
      scripts/
        seed-friends-brands.ts
        validate-icons.ts
      settings.ts
      token-pool.test.ts
      token-pool.ts
    tsconfig.json
    vitest.config.ts
  engine/
    .dockerignore
    .env.example
    app/
      [...slug]/
        route.ts
      api/
        auth/
          github/
            callback/
              route.test.ts
              route.ts
            route.ts
        gen-count/
          route.ts
        health/
          route.ts
      layout.tsx
      page.tsx
    docker-compose.yml
    Dockerfile
    instrumentation.ts
    next.config.ts
    package.json
    README.md
    sentry.edge.config.ts
    sentry.server.config.ts
    tsconfig.json
    vitest.config.ts
  web/
    .gitignore
    app/
      .well-known/
        agent-skills/
          index.json/
            route.ts
          shieldcn-badges/
            SKILL.md/
              route.ts
        api-catalog/
          route.ts
        mcp/
          server-card.json/
            route.ts
        oauth-authorization-server/
          route.ts
        oauth-protected-resource/
          route.ts
        openapi.json/
          route.ts
      [...slug]/
        route.ts
      api/
        [...op]/
          route.ts
        admin/
          brands/
            route.ts
          settings/
            route.ts
        auth/
          [...path]/
            route.ts
          github/
            callback/
              route.ts
            route.ts
        brands/
          [slug]/
            assets/
              route.ts
            logos/
              route.ts
            route.ts
          import/
            route.ts
          list/
            route.ts
          route.ts
        gen-count/
          route.ts
        gen-inspect/
          route.ts
        gen-users/
          route.ts
        icon/
          route.ts
        markdown/
          route.ts
        migrate/
          check/
            route.ts
          github-app.ts
          pr/
            route.ts
        og/
          docs/
            route.tsx
        showcase/
          route.ts
      apple-icon.png
      b/
        [slug]/
          [asset]/
            route.ts
      badge/
        builder-v2.tsx
        page.tsx
      brandmgmt/
        page.tsx
      contributors/
        page.tsx
      dashboard/
        admin/
          page.tsx
        brands/
          [slug]/
            page.tsx
          new/
            page.tsx
          page.tsx
        layout.tsx
        page.tsx
      dev/
        badge-grid/
          page.tsx
        badge-og/
          page.tsx
        badge-rows/
        badge-rows-light/
          page.tsx
          page.tsx
        hero-bg/
          page.tsx
        preview/
          page.tsx
          preview-client.tsx
        social/
          page.tsx
          social-client.tsx
      docs/
        [[...slug]]/
          page.tsx
        layout.tsx
        loading.tsx
      error.tsx
      favicon.ico
      gallery/
        page.tsx
      gen/
        gen-users-stack.tsx
        generator-client.tsx
        generator-tour.tsx
        loading.tsx
        page.tsx
        profile/
          page.tsx
          profile-client.tsx
          profile-tour.tsx
      global-error.tsx
      globals.css
      header/
        page.tsx
      icon.png
      layout.tsx
... 569 more

FAQ

shieldcn is a Claude Code plugin with 1 hand-picked skill for documentation work, indexed on Flowy. Install it with the command on its page. It includes shieldcn-badges. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.

What is shieldcn?: Beautiful README badges, inspired by shields.io and styled like shadcn/ui.
How do I install shieldcn?: Run these in Claude Code: npx -y skills add jal-co/shieldcn --agent claude-code. Then prompt normally.
Does shieldcn auto-invoke its skills?: Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
Is shieldcn free?: Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.

Agent skill

Install the shieldcn-badges skill from skills.sh so your coding agent can add shieldcn badges, charts, and headers to READMEs:

npx skills add jal-co/shieldcn -a claude-code # installs to Claude Code npx skills add jal-co/shieldcn -a cursor # installs to Cursor

.gitattributes .github/ CODE_OF_CONDUCT.md CONTRIBUTING.md dependabot.yml FUNDING.yml ISSUE_TEMPLATE/ bug.yml config.yml feature.yml provider.yml labeler.yml PULL_REQUEST_TEMPLATE.md shieldcn/ star-chart-dark.svg star-chart-light.svg workflows/ ci.yml cli-publish.yml commit-check.yml docker-publish.yml labeler.yml release.yml star-chart.yml .gitignore .husky/ commit-msg pre-commit pre-push .tegami/ publish-lock.yaml action.yml AGENTS.md commit-check.toml LICENSE package.json packages/ action/ CHANGELOG.md dist/ index.js package.json README.md src/ main.ts starhistory.ts tsconfig.json cli/ .gitignore .npmignore LICENSE package.json README.md src/ bin.ts brands.ts constants.ts detect.test.ts detect.ts inject.test.ts inject.ts migrate.test.ts migrate.ts output.ts types.ts url.ts tsconfig.json tsup.config.ts vitest.config.ts core/ package.json scripts/ check-visual.ts visual-test.ts src/ badge-stats.ts badges/ animate.ts brand-colors.ts button-tokens.ts chart-route.test.ts contributors-route.test.ts custom-icons.ts flags.json fonts.ts gif.ts github-sponsors-route.test.ts group-route.test.ts header-backgrounds.ts header-route.test.ts icon-index.ts icon-list.json icons.ts measure.ts memo-route.test.ts png-route.test.ts registry.test.ts registry.ts render-chart.test.ts render-chart.ts render-group.tsx render-header.test.ts render-header.ts render-safety.test.ts render-sponsors.ts render.test.ts render.tsx satori-fonts.ts simple-icons.test.ts simple-icons.ts sponsors-route.test.ts svg-parser.test.ts svg-parser.ts svg-text-utils.ts themes.test.ts themes.ts twemoji.test.ts twemoji.ts types.ts validate.ts views-route.test.ts brand-logo-mode.test.ts branded-brand-bridge.test.ts brands.test.ts brands.ts cache-distributed-backoff.test.ts cache.test.ts cache.ts db.ts fonts/ fira-code-medium.ttf geist-medium.ttf geist-mono-medium.ttf inter-medium.ttf jetbrains-mono-medium.ttf roboto-medium.ttf space-grotesk-medium.ttf format.ts gen-counter.ts gen-users.ts github.ts icons/ indiedevs.svg neon.svg notra.svg openpanel.svg shadcnblocks.svg shadcncraft.svg shieldcn.svg shipperclub.svg migrate/ index.ts transform.ts next-fetch.d.ts normalize-params.ts provider-fetch.test.ts provider-fetch.ts providers/ amo.ts badge.test.ts badge.ts bluesky.ts bundlephobia.ts chocolatey.ts chrome.ts cocoapods.ts codecov.ts commit-history.ts conda.ts coverage-color.ts coveralls.ts crates.ts discord.ts discourse.ts docker.ts fdroid.ts flathub.ts github.test.ts github.ts gitlab.ts hackernews.ts homebrew.ts indiedevs.ts jsdelivr.ts jsr.ts lemmy.ts liberapay.ts mastodon.ts matrix.ts maven.ts memo.test.ts memo.ts modrinth.ts nba.ts npm.ts nuget.ts opencollective.ts openssf.test.ts openssf.ts openvsx.ts packagist.ts pub.ts pypi.ts reddit.ts rubygems.ts shipperclub.ts skills.test.ts skills.ts snapcraft.ts sonar.ts stackexchange.ts starhistory.ts tokscale.ts twitch.ts url-encoding.test.ts views.ts vscode.ts wakatime.ts weblate.ts x.ts youtube.ts rate-limit.test.ts rate-limit.ts route-glue.test.ts route-handler.ts safe-fetch.test.ts safe-fetch.ts scripts/ seed-friends-brands.ts validate-icons.ts settings.ts token-pool.test.ts token-pool.ts tsconfig.json vitest.config.ts engine/ .dockerignore .env.example app/ [...slug]/ route.ts api/ auth/ github/ callback/ route.test.ts route.ts route.ts gen-count/ route.ts health/ route.ts layout.tsx page.tsx docker-compose.yml Dockerfile instrumentation.ts next.config.ts package.json README.md sentry.edge.config.ts sentry.server.config.ts tsconfig.json vitest.config.ts web/ .gitignore app/ .well-known/ agent-skills/ index.json/ route.ts shieldcn-badges/ SKILL.md/ route.ts api-catalog/ route.ts mcp/ server-card.json/ route.ts oauth-authorization-server/ route.ts oauth-protected-resource/ route.ts openapi.json/ route.ts [...slug]/ route.ts api/ [...op]/ route.ts admin/ brands/ route.ts settings/ route.ts auth/ [...path]/ route.ts github/ callback/ route.ts route.ts brands/ [slug]/ assets/ route.ts logos/ route.ts route.ts import/ route.ts list/ route.ts route.ts gen-count/ route.ts gen-inspect/ route.ts gen-users/ route.ts icon/ route.ts markdown/ route.ts migrate/ check/ route.ts github-app.ts pr/ route.ts og/ docs/ route.tsx showcase/ route.ts apple-icon.png b/ [slug]/ [asset]/ route.ts badge/ builder-v2.tsx page.tsx brandmgmt/ page.tsx contributors/ page.tsx dashboard/ admin/ page.tsx brands/ [slug]/ page.tsx new/ page.tsx page.tsx layout.tsx page.tsx dev/ badge-grid/ page.tsx badge-og/ page.tsx badge-rows/ badge-rows-light/ page.tsx page.tsx hero-bg/ page.tsx preview/ page.tsx preview-client.tsx social/ page.tsx social-client.tsx docs/ [[...slug]]/ page.tsx layout.tsx loading.tsx error.tsx favicon.ico gallery/ page.tsx gen/ gen-users-stack.tsx generator-client.tsx generator-tour.tsx loading.tsx page.tsx profile/ page.tsx profile-client.tsx profile-tour.tsx global-error.tsx globals.css header/ page.tsx icon.png layout.tsx ... 569 more

shieldcn

Skills

Badges

README

Usage

Agent skill

Star history

Sponsors

Contributors

File tree

shieldcn

Skills

Badges

README

Usage

Agent skill

Star history

Sponsors

Contributors

File tree