@daymade/ccpm

npm-like package manager for Claude Code skills.

CCPM makes it easy to discover, install, and share Claude Code skills. Think of it as npm for Claude Code.

Quick Start

# Install CCPM globally
npm install -g @daymade/ccpm

# Search for skills
ccpm search pdf

# Install a skill
ccpm install pdf-reader

# List installed skills
ccpm list

Installation

# npm
npm install -g @daymade/ccpm

# Or use npx (no installation needed)
npx @daymade/ccpm search pdf

Requirements: Node.js 18+

Registry Authentication (Zero-Config)

CCPM CLI uses a built-in Supabase publishable key for registry access by default.

• No SUPABASE_ANON_KEY setup is required.
• No SUPABASE_PUBLISHABLE_KEY setup is required.
• No VITE_SUPABASE_PUBLISHABLE_KEY setup is required.

Use CCPM_API_URL only when you intentionally want a different backend (for example local Supabase):

CCPM_API_URL=\"http://127.0.0.1:55421/functions/v1\" ccpm search test

Commands

Discovery

| Command | Alias | Description | |---------|-------|-------------| | ccpm search <query> | | Search skills in registry | | ccpm popular | | Show most downloaded skills | | ccpm recent | | Show recently published skills | | ccpm info <name> | | Show skill details |

Search options:

ccpm search pdf                      # Basic search
ccpm search pdf --limit 50           # More results
ccpm search pdf --tags document      # Filter by tag
ccpm search pdf --author daymade     # Filter by author
ccpm search pdf --smart              # Extended multi-source search (slower)

Installation

| Command | Alias | Description | |---------|-------|-------------| | ccpm install <name> | i | Install a skill | | ccpm install-bundle <name> | ib | Install a curated bundle (shortcut for ccpm install bundle:<name>) | | ccpm update <name> | | Update to latest version | | ccpm uninstall <name> | remove | Uninstall a skill | | ccpm list | ls | List installed skills |

Installation options:

ccpm install skill-name              # Install to user skills (~/.claude/skills)
ccpm install skill-name --project    # Install to project skills (./.claude/skills)
ccpm install [email protected]        # Install specific version
ccpm install @daymade/skill-name     # Install namespaced skill
ccpm install @daymade                # Install a user's public skill stack
ccpm install @daymade/video-creator  # Install scoped skill @daymade/video-creator
ccpm install bundle:@daymade/video-creator # Install a user's public bundle (strict)
ccpm install bundle:web-dev          # Install a curated bundle
ccpm install skill-name --force      # Force reinstall

Reviews

| Command | Description | |---------|-------------| | ccpm reviews <skill-name> | View reviews for a skill | | ccpm review-create <skill-name> | Write a review | | ccpm review-update <review-id> | Update your review | | ccpm review-delete <review-id> | Delete your review |

Publishing

| Command | Description | |---------|-------------| | ccpm login | Authenticate with GitHub | | ccpm logout | Clear authentication | | ccpm whoami | Show current user info | | ccpm init | Initialize new skill package | | ccpm link | Symlink for local testing | | ccpm version <bump> | Bump version (major/minor/patch) | | ccpm publish | Publish skill to registry | | ccpm unpublish <name> | Remove from registry |

Authentication

CCPM uses GitHub OAuth for authentication. Run ccpm login to start the authentication flow:

ccpm login
# Opens browser for GitHub authentication
# Callback handled automatically

ccpm whoami
# Shows your username and namespaces

Publishing Skills

1. Initialize

mkdir my-skill && cd my-skill
ccpm init
# Follow prompts to create SKILL.md

2. Create SKILL.md

Your skill needs a SKILL.md file:

---
name: my-awesome-skill
version: 1.0.0
description: A brief description
author: your-github-username
keywords:
  - productivity
  - automation
---

# My Awesome Skill

Instructions for Claude...

3. Test locally

ccpm link
# Creates symlink in ~/.claude/skills for testing

4. Publish

ccpm publish
# Validates and uploads to registry

Skill Naming

CCPM supports both global and namespaced skills:

# Global skill (no namespace)
ccpm install pdf-reader

# Namespaced skill
ccpm install @daymade/pdf-reader

# With version
ccpm install @daymade/[email protected]

Resolution rule (npm-style):

• Bare names (e.g. pdf-reader) resolve global skills only.
• Scoped names (e.g. @daymade/pdf-reader) require explicit namespace.

Skill Stacks and User Bundles

You can also install a user's public skill stack or a public bundle:

ccpm install @daymade                # Install a user's public skill stack
ccpm install @daymade/video-creator  # Install scoped skill @daymade/video-creator
ccpm install bundle:@daymade/video-creator # Install a user's public bundle

Deterministic routing: @username/bundle-name is always treated as a scoped skill. Use bundle:@username/bundle-name for user bundles.

To force a specific interpretation:

ccpm install stack:@daymade               # Always treat as a user skill stack
ccpm install bundle:@daymade/video-creator # Always treat as a user bundle (fails if not found)
ccpm install skill:@daymade/video-creator  # Always treat as a scoped skill

Naming Rules

• Use lowercase letters, numbers, and hyphens
• No path separators (/, \, ..)
• No shell metacharacters (;, &, |, $, `)
• 1-100 characters

Configuration

CCPM stores configuration in ~/.ccpm/:

~/.ccpm/
├── config.json      # API settings, preferences
├── auth.json        # GitHub OAuth tokens (gitignored)
└── cache/           # Temporary cache

Optional runtime overrides:

• CCPM_API_URL: override Edge Functions base URL
• CCPM_HOME: override config directory
• CLAUDE_SKILLS_DIR: override user skills install path
• CCPM_PROJECT_SKILLS_DIR: override project skills install path

Troubleshooting

"Skill not found" error

# Try searching first
ccpm search <partial-name>

# Check if it's namespaced
ccpm search @daymade/<name>

Authentication issues

# Clear and re-authenticate
ccpm logout
ccpm login

Update failed

# Force reinstall
ccpm install <name> --force

Links

• Website: https://ccpm.dev
• Registry: https://ccpm.dev/registry
• GitHub: https://github.com/daymade/ccpm
• Issues: https://github.com/daymade/ccpm/issues

Related Packages

• ccpm-cli - Alias package for npx ccpm-cli
• install-skills - Shortcut for npx install-skills <name>

License

MIT