API Reference

Public REST API for querying the SkillsMD registry. No authentication required.

Base URL: https://skillsmd.dev/api

---

GET /api/skills

Returns the skills leaderboard with pagination and filtering.

Query Parameters

Param	Type	Default	Description
filter	string	all	Filter: all, trending, or hot
page	integer	1	Page number
limit	integer	30	Results per page (max 100)

Response

{
  "skills": [
    {
      "id": "anthropics/skills/skills",
      "name": "skills",
      "repo": "anthropics/skills",
      "desc": "Public repository for Agent Skills",
      "installs": 1408322,
      "stars": 117142,
      "forks": 13474,
      "language": "Python",
      "tags": ["agent-skills"],
      "updated": "2026-04-14",
      "trending": false,
      "hot": true,
      "change": 2.3
    }
  ],
  "total": 90,
  "page": 1,
  "pages": 3,
  "cached": true,
  "updated": "2026-04-14T13:35:45.467Z"
}

---

GET /api/skill

Returns enriched detail for a single repository, including README content.

Query Parameters

Param	Type	Required	Description
repo	string	Yes	Repository in owner/repo format

Response

{
  "name": "skills",
  "full_name": "anthropics/skills",
  "description": "Public repository for Agent Skills",
  "stars": 117142,
  "forks": 13474,
  "language": "Python",
  "license": "MIT",
  "topics": ["agent-skills", "ai"],
  "created_at": "2025-01-19T...",
  "updated_at": "2026-04-14T...",
  "readme": "# Skills\n\nPublic repository...",
  "html_url": "https://github.com/anthropics/skills"
}

---

GET /api/search

Search skills by name, repo, description, or tags.

Query Parameters

Param	Type	Required	Description
q	string	Yes	Search query

---

GET /api/stats

Returns aggregate registry statistics.

Response

{
  "total_skills": 90,
  "total_installs": 8521340,
  "total_stars": 245891,
  "total_forks": 79543,
  "languages": ["Python", "TypeScript", "JavaScript", ...],
  "top_tags": [
    { "tag": "agent-skills", "count": 42 },
    { "tag": "ai", "count": 31 }
  ],
  "updated": "2026-04-14T13:35:45.467Z"
}

---

POST /api/submit

Submit a new skill for review.

Request Body

{
  "repo": "owner/repo",       // Required
  "name": "my-skill",         // Required
  "description": "...",       // Optional
  "email": "you@example.com"  // Optional
}

Response

{
  "success": true,
  "id": "abc12345-...",
  "message": "Submission received. It will be reviewed shortly."
}

---

Rate Limits

The API is currently unmetered. Please be respectful — cache responses where possible. Data refreshes every 5 minutes.

CORS

All endpoints support CORS with Access-Control-Allow-Origin: *. You can call the API directly from browser JavaScript.