cc-skills

A thin wrapper around npx skills add for CC-MIRROR Claude Code instances.

It discovers one or more CC-MIRROR variants, sets CLAUDE_CONFIG_DIR to the target instance's config/ directory, and then delegates the actual install to npx skills add.

中文文档

Features

• Multi-instance support - Install skills to one or more CC-MIRROR instances
• Automatic discovery - Detects CC-MIRROR instances automatically
• Zero dependencies - Uses only Node.js built-in modules
• Dry-run mode - Preview commands before execution
• Graceful fallback - Works even without cc-mirror CLI

Why this exists

skills already knows how to install into a Claude Code config directory when CLAUDE_CONFIG_DIR is set.

What this package adds is only the instance orchestration layer:

• Discover CC-MIRROR instances
• Target one instance or all instances
• Loop over targets
• Set CLAUDE_CONFIG_DIR per instance
• Forward the real install to npx skills add

Installation

Run directly with npx:

npx cc-skills instances
npx cc-skills add better-auth/skills --instance mclaude-auth --copy -y

Or install globally:

npm install -g cc-skills
cc-skills instances
cc-skills add better-auth/skills --all-instances --skill "*" --copy -y

Usage

instances - List CC-MIRROR instances

cc-skills instances
cc-skills instances --json
cc-skills instances --cc-root ~/.cc-mirror

add - Install skills to instances

cc-skills add <source> (--instance <name> | --all-instances) [options]

Examples:

# Single instance
cc-skills add better-auth/skills --instance mclaude-auth --copy -y

# Multiple named instances
cc-skills add better-auth/skills --instance mclaude-auth --instance mclaude-security --copy -y

# All instances
cc-skills add better-auth/skills --all-instances --skill "*" --copy -y

# Dry run (preview without executing)
cc-skills add better-auth/skills --instance mclaude-auth --dry-run --copy -y

Options

Wrapper options (handled by cc-skills)

| Option | Description | |--------|-------------| | -i, --instance <name> | Target a specific CC-MIRROR instance (repeatable) | | --all-instances | Target all discovered instances | | --cc-root <path> | Custom CC-MIRROR root directory | | --cc-bin-dir <path> | Forwarded to cc-mirror list | | --dry-run | Print commands without executing them | | --fail-fast | Stop after the first failed install | | --verbose | Print the underlying npx commands |

Forwarded options (passed to npx skills add)

| Option | Description | |--------|-------------| | --copy | Copy files instead of symlinking | | -y | Skip confirmation prompts | | --skill <name> | Install specific skill (use * for all) | | --list | List available skills in source |

Important Behavior

This wrapper always injects:

-g -a claude-code

This means every install is done in the target instance's global Claude Code scope.

Do not use skills --all

The skills --all flag means all skills to all agents, which is broader than this wrapper's scope.

If you want all skills from a repository, use:

cc-skills add owner/repo --all-instances --skill "*" --copy -y

How It Works

Discovery phase:

npx -y cc-mirror list --json

Installation phase (per instance):

CLAUDE_CONFIG_DIR="~/.cc-mirror/<instance>/config" \
npx -y skills add <source> -g -a claude-code ...

Fallback Behavior

If cc-mirror list --json is unavailable or fails, the wrapper falls back to scanning the CC-MIRROR root directory and reading variant.json / config/ directly.

Development

# Run tests
npm test

# Run CLI locally
node bin/cc-skills.js help

# Create local tarball
npm run pack:local

Publishing

npm publish

License

MIT