PHPackages                             leeovery/claude-manager - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. leeovery/claude-manager

Abandoned → [https://github.com/leeovery/agentic-skills](/?search=https%3A%2F%2Fgithub.com%2Fleeovery%2Fagentic-skills)Composer-plugin

leeovery/claude-manager
=======================

Plugin manager for Claude Code skills and commands

v1.0.23(4mo ago)1962MITTypeScriptPHP ^8.2

Since Nov 23Pushed 3mo agoCompare

[ Source](https://github.com/leeovery/claude-manager)[ Packagist](https://packagist.org/packages/leeovery/claude-manager)[ RSS](/packages/leeovery-claude-manager/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (6)Versions (25)Used By (2)

Claude Manager
==============

[](#claude-manager)

 **npm Package for Managing Claude Code Skills & Commands**

 [About](#about) • [Installation](#installation) • [How It Works](#how-it-works) • [CLI Commands](#cli-commands) • [Creating Plugins](#creating-plugins) • [Available Plugins](#available-plugins) • [Troubleshooting](#troubleshooting)

---

Versions
--------

[](#versions)

VersionPackage ManagerStatusBranch2.xnpm**Active**`main`1.xComposerDeprecated[`v1`](https://github.com/leeovery/claude-manager/tree/v1)> **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
-----

[](#about)

Claude Manager is an npm package that automatically manages [Claude Code](https://claude.ai/code) skills, commands, agents, hooks, and scripts across your projects.

**What it does:**

- Automatically installs skills, commands, agents, hooks, and scripts 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
------------

[](#installation)

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

```
npm install -D @your-org/claude-your-plugin
# or
pnpm add -D @your-org/claude-your-plugin
# or
yarn add -D @your-org/claude-your-plugin
```

The plugin's postinstall script copies assets to `.claude/`. That's it.

### Removing Plugins

[](#removing-plugins)

Due to bugs in npm 7+ ([issue #3042](https://github.com/npm/cli/issues/3042)) and pnpm ([issue #3276](https://github.com/pnpm/pnpm/issues/3276)), preuninstall hooks don't run reliably. Remove files manually first:

```
npx claude-manager remove @leeovery/claude-laravel && npm rm @leeovery/claude-laravel
```

### pnpm Users

[](#pnpm-users)

pnpm doesn't expose binaries from transitive dependencies, so install the manager directly alongside plugins:

```
pnpm add -D @leeovery/claude-manager @leeovery/claude-laravel
pnpm approve-builds  # approve when prompted
pnpm install         # triggers postinstall
```

How It Works
------------

[](#how-it-works)

1. Plugin packages have `@leeovery/claude-manager` as a dependency
2. Plugin's `postinstall` script copies assets to `.claude/`
3. A manifest (`.claude/.plugins-manifest.json`) tracks what's installed
4. Claude Code discovers the assets automatically

> **Note:** Plugins include `preuninstall` scripts but npm 7+ doesn't run them reliably ([issue #3042](https://github.com/npm/cli/issues/3042)). See [Removing Plugins](#removing-plugins) for the manual removal command.

**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
│   └── scripts/
│       └── build-check.sh
├── node_modules/
│   └── @your-org/
│       └── claude-your-plugin/
└── package.json

```

CLI Commands
------------

[](#cli-commands)

The manager provides a CLI tool for managing plugins:

CommandDescription`npx claude-manager list`Show all installed plugins and their assets`npx claude-manager install`Sync all plugins from manifest (runs automatically)`npx claude-manager add `Manually add a plugin`npx claude-manager remove `Remove a plugin and its assetsCreating Plugins
----------------

[](#creating-plugins)

Want to create your own skill or command packages?

### Plugin Requirements

[](#plugin-requirements)

1. Have `@leeovery/claude-manager` as a dependency
2. Add `postinstall` and `preuninstall` scripts (see example below)
3. Include asset directories (`skills/`, `commands/`, `agents/`, `hooks/`, `scripts/`)

### Example package.json

[](#example-packagejson)

```
{
    "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-manager add",
        "preuninstall": "claude-manager remove"
    }
}
```

The `postinstall` script copies assets when the plugin is installed. The `preuninstall` script cleans up when the plugin is removed.

### Plugin Structure

[](#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
├── scripts/
│   └── build-check.sh
└── package.json

```

The manager auto-discovers `skills/`, `commands/`, `agents/`, `hooks/`, and `scripts/` directories—no additional configuration needed. All asset directories support nested subdirectories.

Available Plugins
-----------------

[](#available-plugins)

PackageDescription[@leeovery/claude-technical-workflows](https://github.com/leeovery/claude-technical-workflows)Structured discussion & planning skills—research, discuss, specify, plan, implement, review[@leeovery/claude-laravel](https://github.com/leeovery/claude-laravel)Opinionated Laravel development patterns and practices[@leeovery/claude-nuxt](https://github.com/leeovery/claude-nuxt)Opinionated Nuxt 4 + Vue 3 development patternsManifest
--------

[](#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:

- Old files are cleaned up when plugins are updated or removed
- You can see what's installed at a glance

Troubleshooting
---------------

[](#troubleshooting)

### Assets not copied

[](#assets-not-copied)

Run the install command manually:

```
npx claude-manager install
```

### Skills not showing in Claude Code

[](#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/
ls -la .claude/scripts/
```

### Plugin not detected

[](#plugin-not-detected)

Verify the plugin's package.json has:

- `@leeovery/claude-manager` as a dependency
- `postinstall` and `preuninstall` scripts
- A `skills/`, `commands/`, `agents/`, `hooks/`, or `scripts/` directory with content

Requirements
------------

[](#requirements)

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

Contributing
------------

[](#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
-------

[](#license)

MIT License. See [LICENSE](LICENSE) for details.

---

 Built by [Lee Overy](https://github.com/leeovery)

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance78

Regular maintenance activity

Popularity12

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 77.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Total

25

Last Release

123d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/93bafe84d227ffd47a06f36023d14a2ff6722bdcad9a3ab5bdcc66459eae463e?d=identicon)[leeovery](/maintainers/leeovery)

---

Top Contributors

[![leeovery](https://avatars.githubusercontent.com/u/1087804?v=4)](https://github.com/leeovery "leeovery (108 commits)")[![claude](https://avatars.githubusercontent.com/u/81847?v=4)](https://github.com/claude "claude (31 commits)")

###  Code Quality

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/leeovery-claude-manager/health.svg)

```
[![Health](https://phpackages.com/badges/leeovery-claude-manager/health.svg)](https://phpackages.com/packages/leeovery-claude-manager)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M648](/packages/sylius-sylius)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

19462.3M1.3k](/packages/drupal-core)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[shlinkio/shlink

A self-hosted and PHP-based URL shortener application with CLI and REST interfaces

4.8k4.3k](/packages/shlinkio-shlink)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)