mirror of
https://github.com/rohitg00/skillkit.git
synced 2026-11-19 02:13:58 +00:00
* feat: runtime skill discovery — REST API, MCP server, cache, ranking, Python client (#42) Add runtime skill discovery capabilities enabling agents to autonomously search and retrieve skills on demand, inspired by skyll.app's approach of making skills queryable by intent rather than requiring pre-installation. Core infrastructure: - Pluggable cache backend with LRU + TTL (MemoryCache) - Multi-signal relevance ranker (content 40pts, query 30pts, popularity 15pts, refs 15pts) - Enhanced SKILL.md parser with frontmatter extraction and reference discovery - Runtime skill injector fetching SKILL.md from GitHub with caching REST API server (@skillkit/api): - Hono-based HTTP server on port 3737 - GET/POST /search with ranked results and filters - GET /skills/:source/:id, /trending, /categories, /health, /cache/stats - Sliding-window rate limiting (60 req/min/IP) MCP server (@skillkit/mcp): - 4 tools: search_skills, get_skill, recommend_skills, list_categories - 2 resources: skills://trending, skills://categories - Compatible with Claude Desktop, Cursor, any MCP client CLI serve command: - `skillkit serve` starts the API server - Options: --port, --host, --cors, --cache-ttl Community registry: - registry/SKILLS.md with 26 curated skills across 12 categories - CommunityRegistry class integrated into FederatedSearch Python client (skillkit-client): - Async httpx + pydantic client for the REST API - search, get_skill, trending, categories, cache_stats, health All 856+ tests pass across 24 workspace tasks. * fix: resolve TypeScript errors in API package Add explicit return type to rate limiter middleware and remove stale CategoryCount type annotation in categories route. * fix: address CodeRabbit review findings and version-check CI - Fix version-check: bump docs packages to 1.11.0 - Parse first IP from X-Forwarded-For header in rate limiter - Add try/catch for malformed JSON in POST /search - Use exact source match in skill routes (owner/repo/id pattern) - Fix NaN fallback for invalid limit params in trending/search - Filter empty strings from query words in relevance ranker - Use Map lookups instead of O(n^2) find in MCP resources/tools - URL-encode path params in Python client - Fix -h flag conflict with Clipanion help in serve command - Fix typo: remoti-dev -> remotion-dev in registry SKILLS.md * fix: address Devin review — composite key lookups and Python URL path - Use source+name composite key Map lookups in search GET/POST routes - Use source+name composite key Map lookup in trending route - Fix Python client get_skill to use /skills/:owner/:repo/:id URL pattern - Update Python test to match new 3-segment skill URL
141 lines
4.5 KiB
Python
141 lines
4.5 KiB
Python
from __future__ import annotations
|
|
|
|
from typing import Optional
|
|
from urllib.parse import quote
|
|
|
|
import httpx
|
|
|
|
from skillkit.models import (
|
|
CacheStats,
|
|
CategoriesResponse,
|
|
Category,
|
|
HealthResponse,
|
|
SearchResponse,
|
|
Skill,
|
|
TrendingResponse,
|
|
)
|
|
|
|
|
|
class SkillKitClient:
|
|
def __init__(self, base_url: str = "http://localhost:3737", timeout: float = 30.0):
|
|
self.base_url = base_url.rstrip("/")
|
|
self.timeout = timeout
|
|
self._client: Optional[httpx.AsyncClient] = None
|
|
|
|
async def __aenter__(self) -> "SkillKitClient":
|
|
self._client = httpx.AsyncClient(base_url=self.base_url, timeout=self.timeout)
|
|
return self
|
|
|
|
async def __aexit__(self, *args: object) -> None:
|
|
if self._client:
|
|
await self._client.aclose()
|
|
self._client = None
|
|
|
|
def _get_client(self) -> httpx.AsyncClient:
|
|
if self._client is None:
|
|
self._client = httpx.AsyncClient(base_url=self.base_url, timeout=self.timeout)
|
|
return self._client
|
|
|
|
async def health(self) -> HealthResponse:
|
|
client = self._get_client()
|
|
response = await client.get("/health")
|
|
response.raise_for_status()
|
|
data = response.json()
|
|
return HealthResponse(
|
|
status=data["status"],
|
|
version=data["version"],
|
|
skill_count=data.get("skillCount", 0),
|
|
uptime=data.get("uptime", 0),
|
|
)
|
|
|
|
async def search(
|
|
self,
|
|
query: str,
|
|
limit: int = 20,
|
|
include_content: bool = False,
|
|
) -> SearchResponse:
|
|
client = self._get_client()
|
|
params = {"q": query, "limit": str(limit)}
|
|
if include_content:
|
|
params["include_content"] = "true"
|
|
response = await client.get("/search", params=params)
|
|
response.raise_for_status()
|
|
data = response.json()
|
|
return SearchResponse(
|
|
skills=[Skill(**s) for s in data["skills"]],
|
|
total=data["total"],
|
|
query=data["query"],
|
|
limit=data["limit"],
|
|
)
|
|
|
|
async def search_with_filters(
|
|
self,
|
|
query: str,
|
|
limit: int = 20,
|
|
include_content: bool = False,
|
|
tags: Optional[list[str]] = None,
|
|
category: Optional[str] = None,
|
|
source: Optional[str] = None,
|
|
) -> SearchResponse:
|
|
client = self._get_client()
|
|
body: dict = {"query": query, "limit": limit, "include_content": include_content}
|
|
filters: dict = {}
|
|
if tags:
|
|
filters["tags"] = tags
|
|
if category:
|
|
filters["category"] = category
|
|
if source:
|
|
filters["source"] = source
|
|
if filters:
|
|
body["filters"] = filters
|
|
response = await client.post("/search", json=body)
|
|
response.raise_for_status()
|
|
data = response.json()
|
|
return SearchResponse(
|
|
skills=[Skill(**s) for s in data["skills"]],
|
|
total=data["total"],
|
|
query=data["query"],
|
|
limit=data["limit"],
|
|
)
|
|
|
|
async def get_skill(self, source: str, skill_id: str) -> Skill:
|
|
client = self._get_client()
|
|
parts = source.split("/", 1)
|
|
owner = quote(parts[0], safe="")
|
|
repo = quote(parts[1], safe="") if len(parts) > 1 else owner
|
|
response = await client.get(f"/skills/{owner}/{repo}/{quote(skill_id, safe='')}")
|
|
response.raise_for_status()
|
|
return Skill(**response.json())
|
|
|
|
async def trending(self, limit: int = 20) -> list[Skill]:
|
|
client = self._get_client()
|
|
response = await client.get("/trending", params={"limit": str(limit)})
|
|
response.raise_for_status()
|
|
data = response.json()
|
|
return [Skill(**s) for s in data["skills"]]
|
|
|
|
async def categories(self) -> list[Category]:
|
|
client = self._get_client()
|
|
response = await client.get("/categories")
|
|
response.raise_for_status()
|
|
data = response.json()
|
|
return [Category(**c) for c in data["categories"]]
|
|
|
|
async def cache_stats(self) -> CacheStats:
|
|
client = self._get_client()
|
|
response = await client.get("/cache/stats")
|
|
response.raise_for_status()
|
|
data = response.json()
|
|
return CacheStats(
|
|
hits=data["hits"],
|
|
misses=data["misses"],
|
|
size=data["size"],
|
|
max_size=data.get("maxSize", 0),
|
|
hit_rate=data.get("hitRate", 0.0),
|
|
)
|
|
|
|
async def close(self) -> None:
|
|
if self._client:
|
|
await self._client.aclose()
|
|
self._client = None
|