Skip to content

rohitg00/skillkit

 
 

Repository files navigation

██ SKILLKIT

Universal Skills for AI Coding Agents

npm version npm downloads GitHub Package CI Website License

Supercharge Every AI Coding Agent

Give your AI agents new abilities with portable, reusable skills. Install from a curated marketplace, create your own, and use them across Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and 27 more agents.

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.

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:

SkillKit Interactive CLI

  • 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

# 1. Install SkillKit globally
npm install -g skillkit

# 2. Launch the interactive TUI (easiest way to start)
skillkit

# Or use CLI commands directly:

# 3. Get personalized skill recommendations
skillkit recommend

# 4. Install skills from the marketplace
skillkit install anthropics/skills

# 5. Sync to your AI agent
skillkit sync

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: Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Antigravity, Amp, Clawdbot, Droid, GitHub Copilot, Goose, Kilo, Kiro, Roo, Trae, Windsurf, Universal

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

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 | b Browse | 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 (17)

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/

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 disable <skills>     # Disable specific skills
skillkit sync                 # Sync skills to agent config
skillkit read <skills>        # Read skill content for AI

Discovery & Recommendations

skillkit recommend            # Get smart recommendations
skillkit marketplace          # Browse skill marketplace
skillkit marketplace search   # Search marketplace

Translation & Context

skillkit translate            # Translate between formats
skillkit context init         # Initialize project context
skillkit context sync         # Sync context to 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

Testing & Workflows

skillkit test                 # Run skill tests
skillkit workflow run         # Execute workflow
skillkit cicd                 # Generate CI/CD templates

Utilities

skillkit init                 # Initialize in project
skillkit validate             # Validate skill format
skillkit create               # Create new skill

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,
  analyzeProject,

  // 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
const engine = new RecommendationEngine();
const profile = await analyzeProject('./my-project');
const recs = engine.recommend(profile);

Popular Skill Repositories

Repository Description
anthropics/skills Official Claude Code marketplace - PDF, XLSX, DOCX processing
vercel-labs/agent-skills React/Next.js best practices, web design guidelines

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.

Links

About

Supercharge AI coding agents with portable skills. Install, translate & share skills across Claude Code, Cursor, Codex, Copilot & 40 more

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages