Skip to content

npm-style Agent Skills Package Manager - Install once, use everywhere

Notifications You must be signed in to change notification settings

miles990/skillpkg

Repository files navigation

skillpkg

⚠️ ARCHIVED — This project has been superseded by Claude Code Plugin Marketplace.


🔀 Migration Guide

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

Recommended: Use evolve Plugin

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-agent

For Skill Authors

Skills 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.

npm version npm version License: MIT Agent Skills

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 | 繁體中文

The Problem

😫 "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"

The Solution

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   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.                      │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Why skillpkg?

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

Supported Platforms

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

Quick Start

Install CLI

npm install -g skillpkg-cli

Search for Skills

# 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

Install a Skill

# 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 to All Platforms

# Sync installed skills to all detected AI platforms
skillpkg sync

# Sync to specific platforms
skillpkg sync --target claude-code,codex,copilot,cursor

Features

  • 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 configurationskillpkg.json for reproducible team setups
  • MCP Server — Enable AI agents to install and manage skills autonomously
  • Open standard — Based on Agent Skills specification

CLI Commands

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

Install Sources

# 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

Install Options

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.

MCP Server — AI Self-Learning

Enable AI agents to search, install, and manage skills via Model Context Protocol.

Setup for Claude Code

claude mcp add skillpkg -- npx -y skillpkg-mcp-server

Setup for Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "skillpkg": {
      "command": "npx",
      "args": ["-y", "skillpkg-mcp-server"]
    }
  }
}

How AI Self-Learning Works

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!

Available MCP Tools

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

SKILL.md Format

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 two

Skill Directory Structure

Skills 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

Project Configuration

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.

Packages

Package Description
skillpkg-cli Command-line interface
skillpkg-mcp-server MCP Server for AI agents
skillpkg-core Core library (for integrations)

Use Cases

For Individual Developers

# 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

For Teams

# Share skillpkg.json in your repo
git add skillpkg.json
git commit -m "Add team AI skills"

# New team members just run:
skillpkg install

For AI Tool Builders

# Create skills that work everywhere
skillpkg new my-awesome-skill

# Publish to GitHub, users install with:
skillpkg install your-org/my-awesome-skill

Environment Variables

Variable Description
GITHUB_TOKEN GitHub API token (higher rate limits)
SKILLPKG_HOME Custom global storage path

Development

git clone https://github.com/miles990/skillpkg.git
cd skillpkg
pnpm install
pnpm build
pnpm test  # 246 tests

Related Projects

Contributing

Contributions welcome! See CONTRIBUTING.md.

License

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.

About

npm-style Agent Skills Package Manager - Install once, use everywhere

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages