Data Sources

Current Providers

• skills.sh - Community-curated skills leaderboard
  • All Time (/) - Total installs ranking
  • Trending (/trending) - Recent growth ranking
  • Hot (/hot) - Daily installs ranking

Planned Providers

• GitHub Trending - Popular skill repos on GitHub
• Awesome Lists - Curated awesome-* lists for AI agent skills

Manual Skills

Skills not tracked by any provider can be manually added via `data/manual_skills.json`:

{
  "skills": [
    {
      "source": "owner/repo",
      "skillId": "skill-name",
      "name": "Skill Display Name",
      "installs": 1
    }
  ]
}

Manual skills will be:

• Fetched for their SKILL.md from GitHub (using standard skill folder detection)
• Included in skills_index.json with providerId: "manual"
• Not overwritten by the crawler (they persist across runs)
• Deduplicated: If skills.sh later tracks a manual skill, it will use skills.sh data instead

Note: `installs` should be at least 1 (minimum value).

Output Files

The crawler generates files in the `data/` directory:

`data/skills.json`

Complete skill data containing all three