⚠️ ARCHIVED — This project has been superseded by Claude Code Plugin Marketplace.
Claude Code now has a built-in Plugin system that covers skillpkg's core functionality:
| skillpkg | Claude Code Plugin |
|---|---|
skillpkg search |
/plugin → Discover tab |
skillpkg install |
/plugin install {plugin}@{marketplace} |
skillpkg sync |
Automatic (plugins auto-sync) |
| MCP Server | No longer needed |
If you were using skillpkg to install Self-Evolving Agent:
# New method (Plugin)
/plugin marketplace add miles990/evolve-plugin
/plugin install evolve@evolve-plugin
# Old method (deprecated)
# skillpkg install github:miles990/self-evolving-agentSkills should now be packaged as Claude Code Plugins. See:
The content below is preserved for historical reference.
Agent Skills Package Manager — Install once, use everywhere.
The package manager for AI agent skills. Works with Claude Code, OpenAI Codex, GitHub Copilot, Cursor, and any platform that adopts the Agent Skills open standard.
English | 繁體中文
😫 "I have to copy the same skill files to every project"
😫 "My team uses different AI coding tools, skills aren't portable"
😫 "I want AI to learn new skills on-the-fly, but there's no standard way"
😫 "Managing skill dependencies manually is a nightmare"
┌─────────────────────────────────────────────────────────────────┐
│ │
│ skillpkg = npm for AI Agent Skills │
│ │
│ ┌─────────────┐ ┌─────────────────────┐ │
│ │ SKILL.md │ │ Claude Code │ │
│ │ (GitHub) │ ───► skillpkg ───► │ OpenAI Codex │ │
│ │ (Gist) │ install │ GitHub Copilot │ │
│ │ (URL) │ & sync │ Cursor │ │
│ └─────────────┘ └─────────────────────┘ │
│ │
│ One skill. All platforms. Zero friction. │
│ │
└─────────────────────────────────────────────────────────────────┘
| Without skillpkg | With skillpkg |
|---|---|
| Copy skills manually to each project | skillpkg install once |
| Skills only work on one platform | Sync to Claude, Codex, Copilot, Cursor |
| No dependency management | Automatic skill & MCP dependency resolution |
| AI can't learn new skills | MCP Server enables AI self-learning |
| No standard format | Industry-standard SKILL.md format |
skillpkg implements the Agent Skills open standard and supports all official adopters:
| Platform | Output Path | Status |
|---|---|---|
| Claude Code | .claude/skills/ |
✅ Supported |
| OpenAI Codex | .codex/skills/ |
✅ Supported |
| GitHub Copilot | .github/skills/ |
✅ Supported |
| Cursor | .cursor/skills/ |
✅ Supported |
npm install -g skillpkg-cli# Search across GitHub, awesome-lists, and local skills
skillpkg search "git commit"
# Example output:
# Found 8 skills:
# commit-helper ⭐120 github:anthropics/commit-helper
# git-expert ⭐85 github:user/git-skills#expert# From GitHub
skillpkg install anthropics/commit-helper
# From subdirectory
skillpkg install github:user/repo#skills/my-skill
# Install globally (available in all projects)
skillpkg install -g anthropics/commit-helper# Sync installed skills to all detected AI platforms
skillpkg sync
# Sync to specific platforms
skillpkg sync --target claude-code,codex,copilot,cursor- Multi-source search — Search GitHub, awesome-lists, and local skills
- Cross-platform sync — One skill works on Claude, Codex, Copilot, Cursor
- Full directory support — Skills with scripts, templates, resources fully supported
- Dependency management — Automatic skill & MCP server dependency resolution
- Subpath installation — Install from repo subdirectories:
user/repo#path/to/skill - Project configuration —
skillpkg.jsonfor reproducible team setups - MCP Server — Enable AI agents to install and manage skills autonomously
- Open standard — Based on Agent Skills specification
| Command | Description |
|---|---|
skillpkg init |
Initialize project with skillpkg.json |
skillpkg new [name] |
Create a new skill (SKILL.md) |
skillpkg install [source] |
Install skill with dependency resolution |
skillpkg uninstall <skill> |
Remove a skill (checks dependencies) |
skillpkg list |
List installed skills |
skillpkg sync [skill] |
Sync skills to AI platforms |
skillpkg search <query> |
Search for skills |
skillpkg info <skill> |
Get skill details |
skillpkg status |
Show project status |
# GitHub repository
skillpkg install user/repo
skillpkg install github:user/repo
# GitHub subdirectory
skillpkg install github:user/repo#skills/my-skill
# GitHub Gist
skillpkg install gist:abc123def
# Direct URL
skillpkg install https://example.com/SKILL.md
# Local path
skillpkg install ./my-local-skill| Option | Description |
|---|---|
-g, --global |
Install to global store (available in all projects) |
--dry-run |
Preview installation without making changes |
--essential-only |
Install only SKILL.md without additional files (scripts, templates) |
The --essential-only option is useful when you only need the core skill instructions without auxiliary files like scripts, templates, or examples. This reduces the installed size and keeps your skills directory lean.
Enable AI agents to search, install, and manage skills via Model Context Protocol.
claude mcp add skillpkg -- npx -y skillpkg-mcp-serverAdd to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"skillpkg": {
"command": "npx",
"args": ["-y", "skillpkg-mcp-server"]
}
}
}User: Help me write better git commits
Claude: I'll search for a relevant skill...
→ search_skills("git commit helper")
Found "commit-helper" - Installing...
→ install_skill("anthropics/commit-helper")
Loading skill instructions...
→ load_skill("commit-helper")
Now I can help you write conventional commits!
| Tool | Description |
|---|---|
search_skills |
Search for skills across sources |
recommend_skill |
Get AI-powered skill recommendations |
install_skill |
Install with dependency resolution |
load_skill |
Load skill instructions |
sync_skills |
Sync to AI platforms |
list_skills |
List installed skills |
create_skill |
Create new SKILL.md |
The Agent Skills open standard uses SKILL.md — Markdown with YAML frontmatter:
---
name: my-skill
version: 1.0.0
description: A helpful skill for X
dependencies:
skills:
- github:some/other-skill
mcp:
- package: "@some/mcp-server"
---
# My Skill
Instructions for the AI agent...
## When to Use
- Scenario A
- Scenario B
## How to Use
1. Step one
2. Step twoSkills can include additional files:
my-skill/
├── SKILL.md # Required: skill definition
├── scripts/
│ └── helper.py # Python scripts
├── templates/
│ └── component.tsx # Template files
└── examples/
└── usage.md # Examples
Create skillpkg.json for team-wide skill management:
{
"name": "my-project",
"skills": {
"commit-helper": "github:anthropics/commit-helper",
"code-reviewer": "github:my-org/code-reviewer"
},
"mcp": {
"context7": {
"package": "@context7/mcp-server"
}
},
"sync_targets": {
"claude-code": true,
"codex": true,
"copilot": true,
"cursor": true
}
}Then run skillpkg install to set up the entire team.
| Package | Description |
|---|---|
| skillpkg-cli | Command-line interface |
| skillpkg-mcp-server | MCP Server for AI agents |
| skillpkg-core | Core library (for integrations) |
# Install your favorite skills globally
skillpkg install -g anthropics/commit-helper
skillpkg install -g my-org/code-reviewer
# They're now available in every project# Share skillpkg.json in your repo
git add skillpkg.json
git commit -m "Add team AI skills"
# New team members just run:
skillpkg install# Create skills that work everywhere
skillpkg new my-awesome-skill
# Publish to GitHub, users install with:
skillpkg install your-org/my-awesome-skill| Variable | Description |
|---|---|
GITHUB_TOKEN |
GitHub API token (higher rate limits) |
SKILLPKG_HOME |
Custom global storage path |
git clone https://github.com/miles990/skillpkg.git
cd skillpkg
pnpm install
pnpm build
pnpm test # 246 tests- Agent Skills Specification — The open standard
- awesome-claude-skills — Curated skill list
- Model Context Protocol — AI tool integration
Contributions welcome! See CONTRIBUTING.md.
MIT License — see LICENSE.
Keywords: AI agent skills, Claude Code skills, OpenAI Codex skills, GitHub Copilot skills, Cursor skills, SKILL.md, AI coding assistant, LLM skills, agent skills package manager, AI skill management, cross-platform AI skills
Made with AI, for AI.