Skills Primer

skills-primer

Prime your Claude Code sessions with preloaded skills.

Installation

# With bun (recommended)
bun install -g skills-primer

# With npm
npm install -g skills-primer

**Note:** Requires [Bun](https://bun.sh) runtime and [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)

Quick Start

# Launch interactive skill selector
sp

# List available skills
sp --list

# Skip permission prompts (dangerous mode)
spx

Usage

sp                    # Standard mode
spx                   # Dangerous mode (skips permission prompts)
skills-primer         # Full command name

What happens when you run `sp`:

1. Scans ~/.claude/skills/ (global) and ./.claude/skills/ (local)
2. Shows interactive selector with autocomplete filtering (type to search)
3. Recently used skills appear first with ⏱ icon
4. Launches Claude with selected skills injected via --append-system-prompt

Examples

# Basic usage - select skills interactively
sp

# Use with Opus model
sp -- --model opus

# Non-interactive prompt with skills
sp -- -p "refactor this function"

# Continue previous conversation with skills
sp -- -c

# Dangerous mode (no permission prompts) + Opus
spx -- --model opus

# List all available skills
sp --list

# Clear recently used skills cache
sp --clear-recent

Commands

Command	Description
sp	Standard mode - prompts for permissions
spx	Dangerous mode - auto-passes --dangerously-skip-permissions
skills-primer	Full command (same as sp)

Options

-h, --help        Show help message
-l, --list        List available skills and exit
--clear-recent    Clear the recent skills cache

Passing Options to Claude

Use `--` to separate skills-primer options from Claude options:

sp -- --model opus           # Use Opus model
sp -- --model sonnet         # Use Sonnet model
sp -- -p "prompt"            # Non-interactive pro