Features: - Multi-agent support: Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Antigravity - Multi-platform Git: GitHub, GitLab, Bitbucket, local paths - Agent Skills spec compliance (agentskills.io) - Skill toggle, validation, and CI/CD support - Programmatic API for library usage
SkillKit
Universal skills loader for AI coding agents. Install, manage, and sync skills across your favorite AI tools.
Skills follow the Agent Skills open format—a simple, portable standard for giving agents new capabilities and expertise.
Compatible With
| Agent | Status |
|---|---|
| Claude Code | ✅ Native |
| OpenAI Codex | ✅ Native |
| Cursor | ✅ Native |
| Gemini CLI | ✅ Native |
| OpenCode | ✅ Native |
| Amp | ✅ Supported |
| Goose | ✅ Supported |
| VS Code (Copilot) | ✅ Supported |
| Letta | ✅ Supported |
| Factory | ✅ Supported |
| Antigravity | ✅ Native |
| Any markdown-config agent | ✅ Universal |
Features
- Multi-Agent Support: Works with 10+ AI coding agents out of the box
- Multi-Platform Git: GitHub, GitLab, Bitbucket, and local paths
- CI/CD Friendly: Non-interactive flags for automation (
--skills,--all,--yes) - Skill Toggle: Enable/disable skills without removing them
- Type-Safe: Built with TypeScript and Zod validation
- Zero Config: Auto-detects your agent and configures appropriately
Installation
npm install -g skillkit
# or
npx skillkit <command>
Quick Start
# Initialize in your project (auto-detects agent)
skillkit init
# Install skills from GitHub
skillkit install owner/repo
# Install from GitLab
skillkit install gitlab:owner/repo
# Install specific skills (CI/CD friendly)
skillkit install owner/repo --skills=pdf,xlsx,docx
# Sync skills to your agent config
skillkit sync
# Read a skill (for AI consumption)
skillkit read pdf
Popular Skill Repositories
Install skills from these community repositories:
# Anthropic's official skill marketplace
skillkit install anthropics/skills
# Vercel's React & Next.js best practices
skillkit install vercel-labs/agent-skills/skills
| Repository | Skills | Description |
|---|---|---|
| anthropics/skills | pdf, xlsx, docx, etc. |
Official Claude Code skill marketplace |
| vercel-labs/agent-skills | vercel-react-best-practices, web-design-guidelines |
React/Next.js optimization & UI review |
Commands
skillkit install <source>
Install skills from various sources.
# GitHub (default)
skillkit install owner/repo
skillkit install https://github.com/owner/repo
# Install from a subdirectory
skillkit install owner/repo/skills
# GitLab
skillkit install gitlab:owner/repo
skillkit install https://gitlab.com/owner/repo
# Bitbucket
skillkit install bitbucket:owner/repo
# Local path
skillkit install ./my-skills
skillkit install ~/dev/skills
# Options
--skills=pdf,xlsx # Install specific skills only (CI/CD)
--all # Install all discovered skills
--yes # Skip confirmation prompts
--global # Install to global directory
--force # Overwrite existing skills
--provider=gitlab # Force specific provider
skillkit sync
Sync installed skills to your agent's config file.
skillkit sync
skillkit sync --agent cursor
skillkit sync --output AGENTS.md
skillkit sync --enabled-only
skillkit read <skills>
Read skill content for AI agent consumption.
skillkit read pdf
skillkit read pdf,xlsx,docx # Multiple skills
skillkit list
List all installed skills.
skillkit list
skillkit list --enabled
skillkit list --json
skillkit enable/disable <skills>
Toggle skills on/off without removing them.
skillkit enable pdf xlsx
skillkit disable docx
skillkit update [skills]
Update skills from their original sources.
skillkit update # Update all
skillkit update pdf xlsx # Update specific
skillkit remove <skills>
Remove installed skills.
skillkit remove pdf xlsx
skillkit init
Initialize skillkit in a project.
skillkit init
skillkit init --agent cursor
skillkit init --list # List supported agents
skillkit validate <path>
Validate skills against the Agent Skills specification.
skillkit validate ./my-skill # Validate single skill
skillkit validate ./skills --all # Validate all skills in directory
Supported Agents
| Agent | Config File | Skills Directory |
|---|---|---|
| Claude Code | AGENTS.md |
.claude/skills/ |
| Cursor | .cursorrules |
.cursor/skills/ |
| Codex | AGENTS.md |
.codex/skills/ |
| Gemini CLI | GEMINI.md |
.gemini/skills/ |
| OpenCode | AGENTS.md |
.opencode/skills/ |
| Antigravity | AGENTS.md |
.antigravity/skills/ |
| Universal | AGENTS.md |
.agent/skills/ |
Creating Skills
A skill is a directory with a SKILL.md file:
my-skill/
├── SKILL.md # Required: Instructions for the AI
├── references/ # Optional: Documentation
├── scripts/ # Optional: Helper scripts
└── assets/ # Optional: Templates, configs
SKILL.md Format
Follows the Agent Skills specification:
---
name: my-skill
description: What this skill does and when to use it. Include trigger keywords.
license: MIT
compatibility: Requires Node.js 18+
metadata:
author: your-org
version: "1.0"
---
# My Skill
Instructions for the AI agent on how to use this skill.
## When to Use
- Scenario 1
- Scenario 2
## Steps
1. First step
2. Second step
| Field | Required | Description |
|---|---|---|
name |
Yes | Lowercase alphanumeric with hyphens (max 64 chars) |
description |
Yes | What it does and when to use it (max 1024 chars) |
license |
No | License name or reference |
compatibility |
No | Environment requirements |
metadata |
No | Arbitrary key-value pairs |
CI/CD Usage
# GitHub Actions example
- name: Setup skills
run: |
npx skillkit install owner/skills --skills=lint,test,deploy --yes
npx skillkit sync --yes
Programmatic API
import {
findAllSkills,
discoverSkills,
detectAgent,
getAdapter,
} from 'skillkit';
// Find all installed skills
const skills = findAllSkills(searchDirs);
// Detect current agent
const agent = await detectAgent();
// Generate config
const adapter = getAdapter(agent);
const config = adapter.generateConfig(skills);
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
MIT License - see LICENSE for details.
Contributing
Contributions welcome! Please read our contributing guidelines.
Acknowledgments
Implements the Agent Skills open format, originally developed by Anthropic and adopted by leading AI development tools.