mirror of
https://github.com/rohitg00/skillkit.git
synced 2026-11-20 12:23:29 +00:00
* docs: add comprehensive documentation section to website - Create Documentation.tsx component with DeepWiki-sourced content - Add sections: Overview, Installation, Architecture, Agents, Commands - Add sections: Configuration, API Reference, Skill Format, Tech Stack - Include interactive sidebar navigation - Add Docs link to navbar - Reference DeepWiki as documentation source Source: https://deepwiki.com/rohitg00/skillkit * feat(docs): add Fumadocs documentation site and update website - Add Fumadocs-based documentation site at /docs - Complete MDX documentation for all features - TUI section with keyboard navigation - Installation, quickstart, commands reference - API reference and configuration guides - Update SkillKit website (agentskills.com) - Add 15 new agents (32 total): CodeBuddy, Continue, Crush, Factory, MCPJam, Mux, Neovate, OpenHands, Pi, Qoder, Qwen, Vercel, Zencoder, CommandCode - Update agent count from 17 to 32 across all components - Update command count from 30+ to 40+ - Remove inline Documentation section (now in Fumadocs) - Link Docs to /docs route - Add 15 new agent adapters to @skillkit/agents - All use UniversalAdapter as base - Added to detection order and adapter registry - Configure Vercel rewrites for /docs proxy to Fumadocs * fix: resolve TypeScript build errors in fumadocs - Remove createRelativeLink from docs page (not compatible with current fumadocs) - Remove redundant isLoading prop in SkillGenerator (status already narrowed) - Fix lucide-react icon type casting in Card component - Fix MDXComponents return type in mdx-components * fix: resolve /docs 404 and show docs link on mobile - Handle undefined slug by defaulting to empty array for index page - Remove hidden class from Docs link so it shows on mobile * fix: address CodeRabbit review suggestions - Move Gemini API key to server-side route (security) - Add default type='button' to Button component - Use dynamic agent count instead of hardcoded 32 - Add 'use client' directive to Documentation - Fix stale closure in SkillSubmitForm with useCallback - Add URL validation for external references - Add noopener to external links for security - Fix Clawdbot path in agents.mdx - Update cicd.mdx with correct CLI commands - Capitalize proper nouns (Markdown, provider names) - Add text language to README code block - Update date example in quickstart.mdx * fix: add noopener to external links and improve nav accessibility - Add noopener to rel attributes on external links for tabnabbing protection - Add aria-label to nav element for screen readers - Add type="button" and aria-current to nav buttons * fix: add vercel.json for fumadocs deployment * fix: disable turbo detection in Vercel deployment * fix: clean up ASCII logo for better rendering * fix: improve code block contrast in SkillGenerator * fix: sync ASCII logo and code block contrast fixes to old Vite components * fix: improve mobile responsiveness for tabs and header buttons * fix: address CodeRabbit security and code quality suggestions - Add rate limiting to API route (10 requests/min per IP) - Add proper type validation for topic parameter - Move API key check after input validation - Add 'use client' directive to SkillGenerator - Add YAML escape helper to prevent frontmatter injection - Change vercel.json to use pnpm instead of npm
476 lines
13 KiB
Markdown
476 lines
13 KiB
Markdown
<div align="center">
|
|
|
|
```
|
|
██ SKILLKIT
|
|
```
|
|
</div>
|
|
|
|
**Universal Skills for AI Coding Agents**
|
|
|
|
[](https://www.npmjs.com/package/skillkit)
|
|
[](https://www.npmjs.com/package/skillkit)
|
|
[](https://github.com/rohitg00/skillkit/pkgs/npm/skillkit)
|
|
[](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
|
|
[](https://agenstskills.com)
|
|
[](https://opensource.org/licenses/Apache-2.0)
|
|
|
|
## 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.
|
|
|
|
```bash
|
|
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
|
|
|
|
<video src="https://raw.githubusercontent.com/rohitg00/skillkit/main/docs/video/skillkit.mp4" controls width="100%"></video>
|
|
|
|
> **Note:** If the video doesn't play above, [watch it here](https://raw.githubusercontent.com/rohitg00/skillkit/main/docs/video/skillkit.mp4)
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
skillkit recommend # Get smart recommendations
|
|
skillkit marketplace # Browse skill marketplace
|
|
skillkit marketplace search # Search marketplace
|
|
```
|
|
|
|
### Translation & Context
|
|
|
|
```bash
|
|
skillkit translate # Translate between formats
|
|
skillkit context init # Initialize project context
|
|
skillkit context sync # Sync context to agents
|
|
```
|
|
|
|
### Custom AI Sub-Agents
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
skillkit memory status # View memory status
|
|
skillkit memory search # Search learnings
|
|
skillkit memory compress # Compress observations
|
|
skillkit memory export # Export as skill
|
|
```
|
|
|
|
### Testing & Workflows
|
|
|
|
```bash
|
|
skillkit test # Run skill tests
|
|
skillkit workflow run # Execute workflow
|
|
skillkit cicd # Generate CI/CD templates
|
|
```
|
|
|
|
### Utilities
|
|
|
|
```bash
|
|
skillkit init # Initialize in project
|
|
skillkit validate # Validate skill format
|
|
skillkit create # Create new skill
|
|
```
|
|
|
|
## Creating Skills
|
|
|
|
### Quick Start
|
|
|
|
```bash
|
|
skillkit create my-skill
|
|
```
|
|
|
|
### Manual Creation
|
|
|
|
Create a `SKILL.md` file following the [Agent Skills specification](https://agentskills.io/specification):
|
|
|
|
```markdown
|
|
---
|
|
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
|
|
|
|
```typescript
|
|
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](https://github.com/anthropics/skills) | Official Claude Code marketplace - PDF, XLSX, DOCX processing |
|
|
| [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) | React/Next.js best practices, web design guidelines |
|
|
|
|
## Installation Options
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```yaml
|
|
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](LICENSE) for details.
|
|
|
|
## Contributing
|
|
|
|
Contributions welcome! Please read our [Contributing Guidelines](CONTRIBUTING.md).
|
|
|
|
## Links
|
|
|
|
- [Agent Skills Specification](https://agentskills.io/specification)
|
|
- [GitHub Repository](https://github.com/rohitg00/skillkit)
|
|
- [NPM Package](https://www.npmjs.com/package/skillkit)
|
|
- [GitHub Package](https://github.com/rohitg00/skillkit/pkgs/npm/skillkit)
|