@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

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

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 skill-name@1.0.0        # 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

Publishing

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/pdf-reader@1.0.0

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

Current Tags

• 0.2.4                                ...           latest (2 months ago)

6 Versions

• 0.2.4                                ...           2 months ago
• 0.2.3                                ...           2 months ago
• 0.2.2                                ...           2 months ago
• 0.2.1                                ...           4 months ago
• 0.2.0                                ...           4 months ago
• 0.0.1                                ...           5 months ago