SkillKit

Skills shouldn't require pre-installation. This API lets any agent, framework, or tool discover and retrieve skills on demand.

400K+ skills across 46 AI coding agents. Results ranked by a multi-signal scoring system (content 40pts, query match 30pts, popularity 15pts, references 15pts).

Quick Start

npx skillkit serve

The API is now running at http://localhost:3737

MCP Server

For agent-native discovery (Claude Desktop, Cursor):

{
  "mcpServers": {
    "skillkit": { "command": "npx", "args": ["@skillkit/mcp"] }
  }
}

Python Client

pip install skillkit-client

API Paths

Search Skills

  • GET /search
    • Summary: Search skills
    • Description: Find skills matching your query. Results are ranked by relevance: content availability (40pts), query match (30pts), popularity (15pts), and references (15pts).
    • Parameters:
      • q: Search query (e.g., 'react performance', 'authentication')
      • limit: Maximum results to return
      • include_content: Include full SKILL.md content in response
    • Responses:
      • 200: Search results ranked by relevance.
      • 400: Missing query parameter.
      • 429: Rate limit exceeded (60 req/min per IP).

Get Skill by ID

  • GET /skills/{owner}/{repo}/{id}
    • Summary: Get skill by ID
    • Description: Get full details of a specific skill by its source repository and name.
    • Responses:
      • 200: Skill details.
      • 404: Skill not found.

Trending Skills

  • GET /trending
    • Summary: Trending skills
    • Description: The most popular skills right now, ranked by relevance score across all sources.
    • Responses:
      • 200: Trending skills list.

Skill Categories

  • GET /categories
    • Summary: Skill categories
    • Description: Browse all skill categories with counts. See what's available before searching.
    • Responses:
      • 200: Category list with counts.

Health Check

  • GET /health
    • Summary: Health check
    • Description: Check if the server is running. Returns version, skill count, and uptime.
    • Responses:
      • 200: Server health.

Cache Statistics

  • GET /cache/stats
    • Summary: Cache statistics
    • Description: See how the cache is performing. Shows hit/miss rates and current size.
    • Responses:
      • 200: Cache statistics.

License

Contact