# SkillMD

> SkillMD is the largest open-source registry for AI agent skills — SKILL.md files that extend Claude Code, Cursor, GitHub Copilot, Codex CLI, Gemini CLI, Windsurf, and VS Code with specialized knowledge and behaviors. Indexes 350,000+ public skills from GitHub, organized by occupation and creator.

## Core Pages

- [Home — Search Skills](https://skillmds.dev/): Search and browse 350,000+ SKILL.md agent skills indexed from GitHub. Filter by occupation, creator, stars, and recency.
- [Documentation & REST API](https://skillmds.dev/docs): Interactive REST API explorer with live endpoints. SKILL.md format specification and integration guide for Claude Code, Cursor, Copilot, Codex, and Gemini CLI.
- [Analytics Dashboard](https://skillmds.dev/analytics): Live registry statistics — total skills, GitHub stars, occupation distributions, and top creator leaderboard.
- [Top Creators](https://skillmds.dev/creators): Browse the top 250 SKILL.md authors ranked by skill count with GitHub profile links.
- [Skills by Occupation](https://skillmds.dev/occupations): Browse 350,000+ agent skills organized by Standard Occupational Classification (SOC) — 23 groups, 867 roles.
- [About SkillMD](https://skillmds.dev/about): Mission, architecture, and principles behind the SkillMD open-source registry.

## REST API Reference

- [GET /api/search](https://skillmds.dev/api/search?limit=3): Search skills with params: q, occupation, creator, sortBy (stars|recent|name), page, limit.
- [GET /api/stats](https://skillmds.dev/api/stats): Aggregate stats — total skills, combined GitHub stars, average stars, forks.
- [GET /api/occupations](https://skillmds.dev/api/occupations): All occupation categories with skill counts, sorted by volume.
- [GET /api/creators](https://skillmds.dev/api/creators): Top creators ranked by skill count.
- [GET /api/skills/{id}](https://skillmds.dev/docs): Get a single skill by its unique ID.

## Key Facts

- 350,000+ SKILL.md files indexed from public GitHub repositories
- 624M+ combined GitHub stars across indexed repositories
- 5,000+ active creators
- 867 Standard Occupational Classification (SOC) roles covered
- Free REST API, no authentication required, CORS open
- Updated continuously by background scraper
- Compatible with: Claude Code, Cursor, GitHub Copilot, Codex CLI, Gemini CLI, Windsurf, VS Code, Roo Code, and any agent using the SKILL.md open standard

## Optional

- [Privacy Policy](https://skillmds.dev/privacy): Data handling and indexing policy.
- [Terms of Service](https://skillmds.dev/terms): Usage terms and API terms.
- [Contact](https://skillmds.dev/contact): Get in touch with the SkillMD team.
- [Support](https://skillmds.dev/support): Help and troubleshooting.