rolecraft install

Install a skill from a local path, GitHub repository, or npm package.

Usage

rolecraft install <source> [flags]

Source types

Local path

Any directory containing SKILL.md:

rolecraft install ./my-skill
rolecraft install ~/projects/my-skill
rolecraft install /absolute/path/to/skill

GitHub repo

Shorthand owner/repo:

rolecraft install sametcelikbicak/task-decomposer
rolecraft install sametcelikbicak/coverage-guard

The CLI clones with --depth 1, finds SKILL.md recursively, installs it, and cleans up.

npm package

Install any npm package that contains a SKILL.md:

rolecraft install npm:lodash
rolecraft install npm:@scope/package
rolecraft install npm:package@1.0.0
rolecraft install npm:@scope/package@latest

The CLI fetches package metadata from the npm registry, downloads and extracts the tarball, finds SKILL.md recursively, installs it, and cleans up.

Scope flags

Flag	Target directory
--project	./.agents/skills/ (default)
--global	~/.agents/skills/
--all	all known agent directories
--claude	~/.claude/skills/
--cursor	~/.cursor/skills/
--devin	~/.devin/skills/
(and 25+ more — see docs/agents.md)

Mode flags

Flag	Description
--symlink	Symlink instead of copy
--copy	Force copy (default)
--dry-run	Preview without copying files
--frozen-lockfile	Fail if skill is already installed

Examples

# Install from local folder (default: project scope)
rolecraft install ./my-skill

# Install from GitHub
rolecraft install sametcelikbicak/task-decomposer

# Install from npm
rolecraft install npm:some-skill-package
rolecraft install npm:@org/skill-package@1.0.0

# Install for specific agents
rolecraft install ./my-skill --claude --cursor

# Combine multiple agents
rolecraft install ./my-skill --claude --cursor --devin

# Global install
rolecraft install ./my-skill --global

# Symlink instead of copy
rolecraft install ./my-skill --symlink

# Preview only
rolecraft install ./my-skill --dry-run

# Fail if already installed
rolecraft install ./my-skill --frozen-lockfile