skills.sh
Badges for skills.sh — agent skill installs and leaderboard rank, trending, and hot positions.
Display live stats from skills.sh, the open agent skills directory by Vercel. Show how many times your skill has been installed and where it sits on the leaderboard.
Installs (branded)
All-time rank
Trending rank (branded)
Hot rank
Installs
Rank
Available badges
| Badge | Endpoint | Description |
|---|---|---|
| Installs | /skills/installs/{owner}/{repo}/{skill} | All-time install count |
| Rank | /skills/rank/{owner}/{repo}/{skill} | All-time leaderboard position |
| Trending | /skills/trending/{owner}/{repo}/{skill} | Position on the trending leaderboard |
| Hot | /skills/hot/{owner}/{repo}/{skill} | Position on the hot (last 24h) leaderboard |
The default endpoint /skills/{owner}/{repo}/{skill} returns the install count.
Quick examples
Finding your skill
Skills are addressed as {owner}/{repo}/{skill} — the GitHub repository that hosts the skill (owner/repo, the skills.sh source) plus the skill's slug:
- Publish a
SKILL.mdin a public GitHub repo (see the skills.sh docs). - The skill is indexed automatically after its first
npx skills add {owner}/{repo}install. - Find your skill page at
https://www.skills.sh/{owner}/{repo}/{skill}— the badge path uses the same three segments. For example,https://www.skills.sh/vercel-labs/agent-skills/vercel-react-best-practices→/skills/installs/vercel-labs/agent-skills/vercel-react-best-practices.svg.
Data source
Uses the public skills.sh leaderboard API (/api/skills/{view}/{page}). No API key required — a SKILLS_SH_API_KEY env var raises the rate limit when self-hosting. Leaderboard pages are cached 30 minutes and shared across all badges. Rank and installs read the all-time leaderboard; trending and hot read their respective boards. Skills outside the top of a board return a not-found badge, so these work best for skills that are actively ranking.
Endpoint details
Use these sections when you need the exact URL shape or a focused example for a specific badge type.
Skill Installs
This section covers the skills/installs badge endpoint.
Show the all-time install count for a skill.
GET/skills/installs/:owner/:repo/:skill.svg
Path Parameters
required
required
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/skills/installs/vercel-labs/agent-skills/vercel-react-best-practices.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/skills/installs/vercel-labs/agent-skills/vercel-react-best-practices.svg?mode=light"></picture>
URL format
/skills/installs/{owner}/{repo}/{skill}.svg/skills/{owner}/{repo}/{skill}.svgBoth formats return the same badge. The default endpoint shows the install count.
Examples
Default variant
Branded variant
Secondary variant
Outline variant
Copy-paste examples
Default — all-time install count
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/skills/installs/vercel-labs/agent-skills/vercel-react-best-practices.svg?mode=dark"><img alt="skill installs" src="https://shieldcn.dev/skills/installs/vercel-labs/agent-skills/vercel-react-best-practices.svg?mode=light"></picture>Branded — Vercel black with the ▲ logo
Skill Rank
This section covers the skills/rank badge endpoint.
Show the skill's position on the all-time skills.sh leaderboard.
GET/skills/rank/:owner/:repo/:skill.svg
Path Parameters
required
required
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/skills/rank/vercel-labs/agent-skills/vercel-react-best-practices.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/skills/rank/vercel-labs/agent-skills/vercel-react-best-practices.svg?mode=light"></picture>
URL format
/skills/rank/{owner}/{repo}/{skill}.svgExamples
Default variant
Branded variant
Secondary variant
Outline variant
Copy-paste examples
Default — all-time leaderboard position
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/skills/rank/vercel-labs/agent-skills/vercel-react-best-practices.svg?mode=dark"><img alt="skill rank" src="https://shieldcn.dev/skills/rank/vercel-labs/agent-skills/vercel-react-best-practices.svg?mode=light"></picture>Branded — Vercel black background
Trending & Hot
These sections cover the skills/trending and skills/hot badge endpoints.
Show the skill's position on the trending or hot (last 24h) leaderboards. A skill that isn't currently listed returns a not-found badge, so these work best for skills that are actively climbing.
GET/skills/trending/:owner/:repo/:skill.svg
Path Parameters
required
required
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/skills/trending/vercel-labs/agent-skills/vercel-react-best-practices.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/skills/trending/vercel-labs/agent-skills/vercel-react-best-practices.svg?mode=light"></picture>
URL format
/skills/trending/{owner}/{repo}/{skill}.svg/skills/hot/{owner}/{repo}/{skill}.svgExamples
Trending (branded)
Trending (secondary)
Hot (outline)
Hot (default)
Copy-paste examples
Default — current trending position
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/skills/trending/vercel-labs/agent-skills/vercel-react-best-practices.svg?mode=dark"><img alt="skill trending" src="https://shieldcn.dev/skills/trending/vercel-labs/agent-skills/vercel-react-best-practices.svg?mode=light"></picture>Branded — hot (last 24h) position
