* 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
██ SKILLKIT
Universal Skills for AI Coding Agents
One Skill. Every Agent.
The package manager for AI agent skills. Install, translate, and share skills across 32 coding agents.
Think npm, but for AI agent skills. Write once, deploy to Claude Code, Cursor, Codex, Windsurf, Copilot, and 27 more.
What are AI Agent Skills? Skills are instruction files that teach AI coding agents how to handle specific tasks - like processing PDFs, following React best practices, or enforcing security patterns. Think of them as plugins for your AI assistant.
# Quick start (no install required)
npx skillkit@latest
# Or install globally
npm install -g skillkit
Why SkillKit?
The problem: You've built amazing skills for Claude Code. Now you want to try Cursor. Or your team uses different agents. Each agent has different formats and directories. Without SkillKit, you either rewrite everything, lock yourself into one agent, or give up on skills entirely.
The solution: SkillKit translates skills between all 32 agents automatically. Write once, use everywhere.
See It In Action
Note: If the video doesn't play above, watch it here
# Install a skill for ALL your agents at once
skillkit install anthropics/skills --agent claude-code,cursor,windsurf
# Or translate existing skills between any agents
skillkit translate my-skill --from claude --to cursor,codex,copilot
# Get smart recommendations based on your project
skillkit recommend
# > 92% match: vercel-react-best-practices
# > 87% match: tailwind-v4-patterns
# > 85% match: nextjs-app-router
Beautiful CLI Experience
SkillKit features a polished, interactive CLI with visual feedback:
- Adaptive Logo - Full ASCII art on wide terminals, compact on narrow
- Agent Icons - Visual indicators: ⟁ Claude · ◫ Cursor · ◎ Codex · ✦ Gemini · ⬡ OpenCode
- Interactive Selection - Multi-select skills and agents with visual feedback
- Progress Indicators - Step trails, spinners, and progress bars
- Smart Defaults - Remembers your last selected agents
What Makes SkillKit Different
| Feature | Without SkillKit | With SkillKit |
|---|---|---|
| Multi-Agent Support | Manual rewrite for each agent | One command, all agents |
| Team Collaboration | Email skills back and forth | Git-based bundles, remote sync |
| Skill Discovery | Search GitHub manually | Smart recommendations for your stack |
| Format Translation | Learn each agent's format | Automatic conversion (32 formats) |
| Context Sync | Configure each agent separately | One config, synced everywhere |
| Session Memory | Knowledge dies with each session | Persistent learning across agents |
| Skill Testing | Hope it works | Test framework with assertions |
5-Minute Quick Start
# Launch interactive TUI (no install required)
npx skillkit@latest
# Or with specific commands:
npx skillkit recommend # Get smart recommendations
npx skillkit install anthropics/skills # Install official skills
npx skillkit sync # Sync to your AI agent
# For frequent use, install globally:
npm install -g skillkit
skillkit # Launch TUI
Core Features
Cross-Agent Translation
Use any skill with any agent. SkillKit automatically converts between formats:
# Translate a Claude skill to Cursor format
skillkit translate react-patterns --to cursor
# Translate all your skills to a new agent
skillkit translate --all --to windsurf
# Preview translation without writing
skillkit translate my-skill --to codex --dry-run
# Batch translate from a custom source directory
skillkit agent translate --source ./my-skills --to cursor
# Recursively translate nested agent directories
skillkit agent translate --source ./kubernetes-skills --to cursor --recursive
Supported Agents (32): Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Antigravity, Amp, Clawdbot, Droid, GitHub Copilot, Goose, Kilo, Kiro, Roo, Trae, Windsurf, Universal, Cline, CodeBuddy, CommandCode, Continue, Crush, Factory, MCPJam, Mux, Neovate, OpenHands, Pi, Qoder, Qwen, Vercel, Zencoder
Smart Recommendations
SkillKit analyzes your project and suggests the perfect skills:
skillkit recommend
# Project: my-app (Next.js + TypeScript + Tailwind)
#
# Recommended Skills:
# 92% vercel-react-best-practices
# 87% tailwind-v4-patterns
# 85% nextjs-app-router
# 78% typescript-strict-mode
Filter by task, category, or minimum score:
skillkit recommend --search "auth" # Task-based search
skillkit recommend --category security # Category filter
skillkit recommend --min-score 80 # Quality threshold
skillkit recommend --explain # Show WHY skills match
skillkit recommend --reasoning # Use LLM-based search
Hierarchical Skill Tree
Browse skills organized in a navigable taxonomy:
skillkit tree # Show full tree
skillkit tree Frontend # Show Frontend subtree
skillkit tree "Frontend > React" # Navigate to subcategory
skillkit tree --generate # Generate tree from index
skillkit tree --stats # Show tree statistics
skillkit tree --depth 2 # Limit display depth
Categories: Development, Frontend, Backend, Mobile, DevOps, Testing, Security, AI/ML, Database, Tooling, Documentation, Performance
Session Memory System
Your AI agents learn, but that knowledge dies with the session. SkillKit captures learnings and makes them persistent:
# Compress session observations into reusable learnings
skillkit memory compress
# Search past learnings
skillkit memory search "authentication patterns"
# Export a learning as a shareable skill
skillkit memory export auth-insight --output auth-patterns.md
# Share memory across projects
skillkit memory --global
Skill Marketplace
Browse and install from curated skill repositories:
# Browse all available skills
skillkit marketplace
# Search for specific skills
skillkit marketplace search "react hooks"
# Filter by tags
skillkit marketplace --tags typescript,testing
# Refresh the skill index
skillkit marketplace refresh
Interactive TUI
Beautiful terminal interface for visual skill management:
skillkit ui
# or just
skillkit
Navigation: h Home | m Marketplace | b Browse | v Tree View | r Recommend | t Translate | c Context | l List | s Sync | q Quit
Skill Testing Framework
Test your skills with built-in assertions:
# Run all skill tests
skillkit test
# Test specific skills
skillkit test ./my-skill
# Run tests with specific tags
skillkit test --tags unit,integration
# JSON output for CI
skillkit test --json
Workflow Orchestration
Compose skills into multi-step workflows:
# List available workflows
skillkit workflow list
# Run a workflow
skillkit workflow run feature-development
# Create new workflow
skillkit workflow create my-workflow
CI/CD Integration
Generate CI/CD templates for automated skill management:
# GitHub Actions
skillkit cicd github-action
# GitLab CI
skillkit cicd gitlab-ci
# Pre-commit hooks
skillkit cicd pre-commit
Supported Agents (32)
| Agent | Format | Skills Directory |
|---|---|---|
| Claude Code | SKILL.md | .claude/skills/ |
| Cursor | MDC (.mdc) | .cursor/skills/ |
| Codex | SKILL.md | .codex/skills/ |
| Gemini CLI | SKILL.md | .gemini/skills/ |
| OpenCode | SKILL.md | .opencode/skills/ |
| Antigravity | SKILL.md | .antigravity/skills/ |
| Amp | SKILL.md | .amp/skills/ |
| Clawdbot | SKILL.md | skills/ or ~/.clawdbot/skills/ |
| Droid (Factory) | SKILL.md | .factory/skills/ |
| GitHub Copilot | Markdown | .github/skills/ |
| Goose | SKILL.md | .goose/skills/ |
| Kilo Code | SKILL.md | .kilocode/skills/ |
| Kiro CLI | SKILL.md | .kiro/skills/ |
| Roo Code | SKILL.md | .roo/skills/ |
| Trae | SKILL.md | .trae/skills/ |
| Windsurf | Markdown | .windsurf/skills/ |
| Universal | SKILL.md | skills/ |
| Cline | SKILL.md | .cline/skills/ |
| CodeBuddy | SKILL.md | .codebuddy/skills/ |
| CommandCode | SKILL.md | .commandcode/skills/ |
| Continue | SKILL.md | .continue/skills/ |
| Crush | SKILL.md | .crush/skills/ |
| Factory | SKILL.md | .factory/skills/ |
| MCPJam | SKILL.md | .mcpjam/skills/ |
| Mux | SKILL.md | .mux/skills/ |
| Neovate | SKILL.md | .neovate/skills/ |
| OpenHands | SKILL.md | .openhands/skills/ |
| Pi | SKILL.md | .pi/skills/ |
| Qoder | SKILL.md | .qoder/skills/ |
| Qwen | SKILL.md | .qwen/skills/ |
| Vercel | SKILL.md | .vercel/skills/ |
| Zencoder | SKILL.md | .zencoder/skills/ |
All Commands
Skill Management
skillkit install <source> # Install skills from GitHub/GitLab/Bitbucket/local
skillkit remove <skills> # Remove installed skills
skillkit update [skills] # Update skills from source
skillkit list # List installed skills
skillkit enable <skills> # Enable specific skills
skillkit pause <skills> # Temporarily pause skills
skillkit resume <skills> # Resume paused skills
skillkit sync # Sync skills to agent config
skillkit read <skills> # Read skill content for AI
skillkit status # Show skill and agent status
Discovery & Recommendations
skillkit recommend # Get smart recommendations
skillkit recommend --explain # Show reasoning for matches
skillkit recommend --reasoning # Use LLM-based discovery
skillkit tree # Browse hierarchical taxonomy
skillkit tree --generate # Generate tree from index
skillkit marketplace # Browse skill marketplace
skillkit marketplace search # Search marketplace
skillkit find <query> # Quick skill search
skillkit check # Check skill health and updates
Translation & Context
skillkit translate # Translate between formats
skillkit context init # Initialize project context
skillkit context sync # Sync context to agents
AI Instruction Generation (Primer)
Generate AI instruction files for all 32 supported agents based on your codebase analysis:
skillkit primer # Analyze codebase, generate for detected agents
skillkit primer --all-agents # Generate for all 32 agents
skillkit primer --agent claude-code,cursor # Specific agents only
skillkit primer --dry-run # Preview without writing files
skillkit primer --analyze-only # Only show codebase analysis
skillkit primer --output ./instructions # Write to custom directory
skillkit primer --json # Output analysis as JSON (for scripting)
skillkit primer --json --analyze-only # Machine-readable analysis
Inspired by primer but extended for all SkillKit agents.
Custom AI Sub-Agents
skillkit agent list # List all installed agents
skillkit agent show <name> # Show agent details
skillkit agent create <name> # Create a new agent
skillkit agent translate # Translate agents between formats
--source ./path # Source directory or file
--to cursor # Target agent format
--recursive # Scan subdirectories recursively
--dry-run # Preview without writing
skillkit agent sync # Sync agents to target AI agent
skillkit agent validate # Validate agent definitions
Memory System
skillkit memory status # View memory status
skillkit memory search # Search learnings
skillkit memory compress # Compress observations
skillkit memory export # Export as skill
Mesh Network
skillkit mesh init # Initialize mesh network
skillkit mesh add <address> # Add a host to mesh
skillkit mesh remove <id> # Remove a host from mesh
skillkit mesh list # List known hosts
skillkit mesh discover # Discover hosts on LAN
skillkit mesh health # Check host health
skillkit mesh status # Show mesh status
# Security
skillkit mesh security init # Setup encryption keys
skillkit mesh security status # Show security status
skillkit mesh peer trust <id> # Trust a peer
skillkit mesh peer revoke <id># Revoke peer trust
skillkit mesh peer list # List trusted peers
Inter-Agent Messaging
skillkit message send # Send message to agent
skillkit message inbox # View inbox
skillkit message read <id> # Read a message
skillkit message reply <id> # Reply to message
skillkit message archive <id> # Archive message
skillkit message sent # View sent messages
skillkit message status # Messaging status
Quality & Testing
skillkit test # Run skill tests
skillkit validate # Validate skill format
skillkit fix # Auto-fix skill issues
skillkit audit # Audit skills for security/quality
skillkit manifest # Generate skill manifest
Team Collaboration
skillkit team init # Initialize team workspace
skillkit team share # Share skills with team
skillkit team import # Import team skills
skillkit team sync # Sync team skills
skillkit team list # List team members
Workflows & Automation
skillkit workflow run # Execute workflow
skillkit plan create # Create execution plan
skillkit plan execute # Execute a plan
skillkit cicd init # Generate CI/CD templates
skillkit hook register # Register lifecycle hooks
skillkit command generate # Generate slash commands
Plugins & Extensions
skillkit plugin list # List available plugins
skillkit plugin install # Install a plugin
skillkit plugin enable # Enable a plugin
skillkit methodology list # List methodologies
skillkit methodology load # Load a methodology
Publishing & Sharing
skillkit publish # Generate well-known hosting structure
skillkit publish submit # Submit to SkillKit marketplace
skillkit create # Create new skill
skillkit init # Initialize in project
Self-Hosting Skills (RFC 8615)
Generate a well-known URI structure to host skills on your own domain:
# Generate hosting structure
skillkit publish ./my-skills --output ./public
# Users install from your domain
skillkit add https://your-domain.com
This creates:
.well-known/skills/
index.json # Skill manifest
my-skill/SKILL.md # Skill files
Configuration
skillkit settings # View/edit settings
skillkit settings --set key=value # Update setting
Creating Skills
Quick Start
skillkit create my-skill
Manual Creation
Create a SKILL.md file following the Agent Skills specification:
---
name: my-skill
description: What this skill does and when to use it
license: MIT
metadata:
author: your-name
version: "1.0"
---
# My Skill
Instructions for the AI agent.
## When to Use
- Scenario 1
- Scenario 2
## Steps
1. First step
2. Second step
Programmatic API
import {
// Skill discovery
findAllSkills,
discoverSkills,
detectAgent,
getAdapter,
// Translation
translateSkill,
translateSkillFile,
// Recommendations
RecommendationEngine,
ReasoningRecommendationEngine,
analyzeProject,
// Tree & Taxonomy
TreeGenerator,
generateSkillTree,
loadTree,
buildSkillGraph,
getRelatedSkills,
// Reasoning Engine
ReasoningEngine,
createReasoningEngine,
// Connectors (Tool-Agnostic Placeholders)
detectPlaceholders,
replacePlaceholders,
suggestMappingsFromMcp,
// Execution Flow
ExecutionManager,
detectExecutionMode,
// Context
ContextManager,
syncToAllAgents,
// Memory
createMemoryCompressor,
createMemoryInjector,
LearningStore,
// Marketplace
createMarketplaceAggregator,
// Testing
SkillTestRunner,
// Workflows
WorkflowOrchestrator,
} from 'skillkit';
// Example: Translate and install
const skill = await translateSkill(skillContent, 'cursor');
console.log(skill.content);
// Example: Get recommendations with reasoning
const engine = new ReasoningRecommendationEngine();
await engine.initReasoning();
const profile = await analyzeProject('./my-project');
const recs = await engine.recommendWithReasoning(profile, { reasoning: true });
// Example: Browse skill tree
const tree = generateSkillTree(skills);
console.log(tree.rootNode.children); // Categories
// Example: Detect execution mode
const mode = detectExecutionMode();
console.log(mode.mode); // 'standalone' or 'enhanced'
console.log(mode.capabilities); // Available MCP capabilities
Skill Sources & Attribution
SkillKit aggregates skills from trusted sources. We credit and link back to all original creators. Each source retains its original license.
Official Partner Sources
| Repository | Description | License |
|---|---|---|
| anthropics/skills | Official Claude Code skills from Anthropic | Apache 2.0 |
| vercel-labs/agent-skills | Next.js, React, and Vercel platform skills | MIT |
| expo/skills | Mobile development with Expo and React Native | MIT |
| remotion-dev/skills | Programmatic video creation with React | MIT |
| supabase/agent-skills | Database, auth, and backend skills | Apache 2.0 |
| stripe/ai | Payment integration and Stripe API patterns | MIT |
Community Contributors
| Repository | Description | License |
|---|---|---|
| trailofbits/skills | Security analysis and vulnerability detection | Apache 2.0 |
| obra/superpowers | Test-driven development and workflow automation | MIT |
| wshobson/agents | Development patterns and agent configurations (48 agents) | MIT |
| ComposioHQ/awesome-claude-skills | Curated collection of Claude Code skills | MIT |
| travisvn/awesome-claude-skills | Community-curated skill collection | MIT |
| langgenius/dify | AI application development platform patterns | Apache 2.0 |
| better-auth/skills | Authentication and authorization patterns | MIT |
| onmax/nuxt-skills | Vue.js and Nuxt framework skills | MIT |
| elysiajs/skills | Bun runtime and ElysiaJS framework | MIT |
| kadajett/agent-nestjs-skills | NestJS backend framework patterns | MIT |
| cloudai-x/threejs-skills | 3D graphics and WebGL development | MIT |
| dimillian/skills | iOS and SwiftUI development patterns | MIT |
| waynesutton/convexskills | Convex backend development | MIT |
| kepano/obsidian-skills | Obsidian plugin and vault management | MIT |
| giuseppe-trisciuoglio/developer-kit | UI component libraries (Shadcn/Radix) | MIT |
| openrouterteam/agent-skills | OpenRouter API integration patterns | MIT |
Want to add your skills? Submit your repository to be included in SkillKit
Installation Options
# npm (recommended)
npm install -g skillkit
# pnpm
pnpm add -g skillkit
# yarn
yarn global add skillkit
# bun
bun add -g skillkit
# npx (no install)
npx skillkit <command>
# GitHub Packages (alternative registry)
npm install -g @rohitg00/skillkit --registry=https://npm.pkg.github.com
Configuration
Create skillkit.yaml in your project:
version: 1
agent: cursor # Override auto-detection
autoSync: true # Auto-sync on changes
enabledSkills:
- pdf
- xlsx
disabledSkills:
- deprecated-skill
License
Apache License 2.0 - see LICENSE for details.
Contributing
Contributions welcome! Please read our Contributing Guidelines.
