# New method (Plugin)
/plugin marketplace add miles990/evolve-plugin
/plugin install evolve@evolve-plugin

# Old method (deprecated)
# skillpkg install github:miles990/self-evolving-agent

😫 "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.                      │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

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

# 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

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

{
  "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!

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

my-skill/
├── SKILL.md              # Required: skill definition
├── scripts/
│   └── helper.py         # Python scripts
├── templates/
│   └── component.tsx     # Template files
└── examples/
    └── usage.md          # Examples

{
  "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
  }
}

# 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

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