Commands

rolecraft ships 25 commands. You probably need three of them.

Start here

Command	What it does
`rolecraft setup`	Detect every AI agent on the machine and install a skill and its MCP servers everywhere
`rolecraft install`	Install one skill from a local path, GitHub shorthand, or any git URL
`rolecraft search`	Find skills on GitHub
`rolecraft list`	List installed skills with scope, date and source
`rolecraft update`	Re-fetch skills from their source
`rolecraft remove`	Uninstall a skill and restore the previous state

Author and maintain

Command	What it does
`rolecraft init`	Scaffold a new skill from a built-in template
`rolecraft bundle`	Export installed skills into a single portable directory
`rolecraft compose`	Compose skills from multiple sources into one target
`rolecraft convert`	Convert skills between agent formats
`rolecraft check`	Run the security scanner without installing
`rolecraft test`	Validate a skill's frontmatter and structure
`rolecraft verify`	Verify installed skills against their lockfile hashes
`rolecraft diff`	Show what changed between two snapshots or sources
`rolecraft doctor`	Diagnose the local installation
`rolecraft watch`	Re-run a command when the source changes
`rolecraft rollback`	Restore a previous snapshot

Agents, MCP and platform

Command	What it does
`rolecraft agents`	List detected agents and their skill directories
`rolecraft agents-xml`	Emit the agent manifest as XML
`rolecraft mcp`	Install and manage MCP server configuration
`rolecraft profile`	Save and apply a named set of agent skills
`rolecraft ci`	Non-interactive re-install for pipelines
`rolecraft use`	Activate a profile for the current shell
`rolecraft upgrade`	Update the rolecraft CLI itself
`rolecraft completions`	Print a shell completion script

See also

CLI Reference — every command with all flags on one page.
Node.js API — use rolecraft as a library.
Getting Started — a five-minute walkthrough.