Commands

`skillpm install [skill...]`

Install one or more skills and wire them into agent directories.

skillpm install my-skill                   # install a specific skill
skillpm install                            # install all deps from package.json
skillpm i skill-a skill-b                  # alias, multiple skills

What happens:

Runs npm install with the provided arguments
Scans node_modules/ for packages containing skills/*/SKILL.md
Links each skill into agent directories via skills
Collects skillpm.mcpServers from all skills (transitively, deduplicated)
Configures each MCP server via add-mcp

`skillpm uninstall <skill...>`

Remove one or more skills and clean up agent directories.

skillpm uninstall my-skill
skillpm rm old-skill             # alias
skillpm remove another-skill     # alias

Runs npm uninstall, then re-wires agent directories to remove stale links.

`skillpm list`

List all installed skill packages.

skillpm list
skillpm ls      # alias

Shows each skill's name, version (from package.json), description (from SKILL.md), and MCP server requirements.

`skillpm init`

Scaffold a new skill package.

mkdir my-skill && cd my-skill
skillpm init

This will:

Run npm init -y
Add "agent-skill" to keywords in package.json
Create skills/<name>/SKILL.md with a template

`skillpm publish`

Publish a skill package to npmjs.org.

skillpm publish
skillpm publish --access public    # for scoped packages

Validates that "agent-skill" is present in package.json keywords, runs skills-ref validate against the Agent Skills spec, then delegates to npm publish. Your skill will appear in the Agent Skills Registry and on npmjs.org.

`skillpm sync`

Re-scan and re-wire agent directories without reinstalling.

skillpm sync

Useful after manual changes to node_modules/ or when agent directories need refreshing.

Monorepo / npm workspace support

When your repo uses npm workspaces, npm creates symlinks inside node_modules/ that point to your first-party skill packages:

node_modules/
  @org/
    my-skill → ../../skills/my-skill   ← npm workspace symlink

skillpm sync detects these symlinks automatically. Each symlinked package is treated as a workspace package — its configs/ directory is copied into the workspace root, regenerating all deployed agent definitions, prompts, and rules. Workspace packages are tagged in output:

ℹ Linking workspace package @org/my-skill@1.0.0 into agent directories
ℹ Copying config files from workspace package @org/my-skill@1.0.0

Contributor workflow for in-repo skill monorepos:

Edit source files in skills/<name>/configs/
Run skillpm sync to regenerate deployed copies
Commit the regenerated files

`skillpm mcp add <source...>`

Configure one or more MCP servers across agents.

skillpm mcp add @anthropic/mcp-server-filesystem
skillpm mcp add https://mcp.context7.com/mcp

Delegates to add-mcp.

`skillpm mcp list`

List configured MCP servers.

skillpm mcp list

Note

This currently directs you to check agent config files directly (.cursor/mcp.json, etc.) as add-mcp doesn't yet support listing.