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.
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.
Path Parameters
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
Copy-paste examples
Default — all-time install count
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.
Path Parameters
URL format
/skills/rank/{owner}/{repo}/{skill}.svgExamples
Copy-paste examples
Default — all-time leaderboard position
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.
Path Parameters
URL format
/skills/trending/{owner}/{repo}/{skill}.svg/skills/hot/{owner}/{repo}/{skill}.svgExamples
Copy-paste examples
Default — current trending position
Branded — hot (last 24h) position
