README

npm Package for Managing Claude Code Skills & Commands

About • Installation • How It Works • CLI Commands • Creating Plugins • Available Plugins • Troubleshooting

Versions

Note: This package is installed automatically as a dependency of plugins. To migrate from v1, update your plugins to their v2 versions (npm-based).

About

Claude Manager is an npm package that automatically manages Claude Code skills, commands, agents, and hooks across your projects.

What it does:

• Automatically installs skills, commands, agents, and hooks from plugin packages into your project's .claude/ directory
• Copies assets so they're committed to your repository and available immediately
• Works with any project that has a package.json (Node.js, Laravel, Nuxt, etc.)
• Provides CLI tools for listing and managing installed plugins

Why use it?

Instead of manually copying skill files between projects, you can install them as npm packages and let the manager handle the rest. Update a skill package once, run npm update, and all your projects get the improvements.

Installation

The manager is typically installed automatically as a dependency of plugin packages. When you install a Claude plugin:

npm install @your-org/claude-your-plugin

The manager will:

1. Install itself (as a dependency of the plugin)
2. Add a prepare hook to your package.json
3. Copy the plugin's assets to .claude/

That's it. Future npm install and npm update runs will automatically sync all plugins.

How It Works

1. Plugin packages have @leeovery/claude-manager as a dependency
2. Plugins register themselves via their postinstall script
3. The manager copies skills, commands, agents, and hooks to .claude/
4. A manifest (.claude/.plugins-manifest.json) tracks what's installed
5. A prepare hook ensures plugins sync on both npm install and npm update
6. Claude Code discovers them automatically

After installation, your project structure looks like:

your-project/
├── .claude/
│   ├── .plugins-manifest.json
│   ├── skills/
│   │   └── laravel-actions/
│   │       └── skill.md
│   ├── commands/
│   │   └── artisan-make.md
│   ├── agents/
│   │   └── code-reviewer.md
│   └── hooks/
│       └── pre-commit.sh
├── node_modules/
│   └── @your-org/
│       └── claude-your-plugin/
└── package.json

CLI Commands

The manager provides a CLI tool for managing plugins:

Creating Plugins

Want to create your own skill or command packages?

Plugin Requirements

1. Have @leeovery/claude-manager as a dependency
2. Add a postinstall script that calls claude-plugins add
3. Include asset directories (skills/, commands/, agents/, hooks/)

Example package.json

{
    "name": "@your-org/claude-your-skills",
    "version": "1.0.0",
    "description": "Your custom skills for Claude Code",
    "license": "MIT",
    "dependencies": {
        "@leeovery/claude-manager": "^2.0.0"
    },
    "scripts": {
        "postinstall": "claude-plugins add"
    }
}

Plugin Structure

your-plugin/
├── skills/
│   ├── skill-one/
│   │   └── skill.md
│   └── skill-two/
│       └── skill.md
├── commands/
│   ├── command-one.md
│   └── command-two.md
├── agents/
│   └── agent-one.md
├── hooks/
│   └── pre-commit.sh
└── package.json

The manager auto-discovers skills/, commands/, agents/, and hooks/ directories—no additional configuration needed.

Available Plugins

Manifest

The manager tracks installed plugins in .claude/.plugins-manifest.json:

{
  "plugins": {
    "@your-org/claude-laravel": {
      "version": "1.0.0",
      "files": [
        "skills/laravel-actions",
        "commands/artisan-make.md"
      ]
    }
  }
}

This file should be committed to your repository. It ensures:

• Plugins are synced correctly on npm install and npm update
• Old files are cleaned up when plugins are updated or removed
• You can see what's installed at a glance

Troubleshooting

Assets not copied

Run the install command manually:

npx claude-plugins install

Skills not showing in Claude Code

Check that .claude/ directories exist and contain files:

ls -la .claude/skills/
ls -la .claude/commands/
ls -la .claude/agents/
ls -la .claude/hooks/

Plugin not detected

Verify the plugin's package.json has:

• @leeovery/claude-manager as a dependency
• A postinstall script that calls claude-plugins add
• A skills/, commands/, agents/, or hooks/ directory with content

Prepare hook not added

If your project's package.json doesn't have the prepare hook, add it manually:

{
  "scripts": {
    "prepare": "claude-plugins install"
  }
}

This ensures plugins sync on both npm install and npm update.

Requirements

• Node.js >= 18.0.0
• npm, pnpm, yarn, or bun

Contributing

Contributions are welcome! Whether it's:

• Bug fixes
• Documentation improvements
• New features
• Discussion about approaches

Please open an issue first to discuss significant changes.

License

MIT License. See LICENSE for details.

_{Built by Lee Overy}