v1.12.0 — Runtime Skill Discovery

Runtime Skill Discovery

Adds runtime skill discovery capabilities with REST API, MCP server, pluggable caching, multi-signal relevance ranking, and a Python client.

New Packages

• @skillkit/api — REST API server (Hono) on port 3737

  • GET /search?q=... and POST /search with filters
  • GET /skills/:owner/:repo/:id — get specific skill
  • GET /trending — top skills by relevance score
  • GET /categories — skill categories with counts
  • GET /health and GET /cache/stats
  • Built-in Swagger UI at /docs and OpenAPI 3.1 spec at /openapi.json
  • Sliding-window per-IP rate limiting (60 req/min)

• @skillkit/mcp — MCP server for agent-native discovery

  • 4 tools: search_skills, get_skill, recommend_skills, list_categories
  • 2 resources: skills://trending, skills://categories
  • Stdio transport — works with Claude Desktop, Cursor, any MCP client

• skillkit-client (Python) — async Python client (httpx + pydantic)

  • search(), get_skill(), trending(), categories(), health()

New Core Modules

• Pluggable Cache (@skillkit/core) — MemoryCache with LRU eviction + TTL
• Relevance Ranker — 4-signal scoring (content 40pts, query 30pts, popularity 15pts, references 15pts)
• SKILL.md Parser — frontmatter parsing, reference discovery, content extraction
• Runtime Injector — fetch + cache SKILL.md from GitHub at runtime
• Community Registry — curated registry/SKILLS.md with 26 skills across 12 categories

New CLI Command

• skillkit serve / skillkit server — starts the REST API server
  • --port (-p), --host (-H), --cors, --cache-ttl

Documentation

• Hosted API docs at agenstskills.com/api — interactive Swagger UI
• Rewrote all core docs with clean problem/solution framing and progressive examples
• New pages: REST API, MCP Server, Python Client

Usage

# Start API server
skillkit serve

# MCP server (Claude Desktop / Cursor)
{
  "mcpServers": {
    "skillkit": { "command": "npx", "args": ["@skillkit/mcp"] }
  }
}

# Python client
pip install skillkit-client

Full Changelog

v1.11.0...v1.12.0