rolecraft setup

One command. All agents. Skills + MCP servers. Zero configuration.

Detect every AI agent on your machine and install a skill to all of them at once, plus its MCP servers for the agents that support MCP.

Usage

rolecraft setup                    # detect agents only
rolecraft setup <source>           # detect + install to all agents, MCP where supported
rolecraft setup <source> --list    # list skills without installing
rolecraft setup <source> --skill <names>  # install specific skills

Description

rolecraft setup is the onboarding command. It:

1. Scans your system for all installed AI agent directories (opencode, cursor, claude-code, copilot, aider, etc.)
2. When a source is provided: resolves the skill(s), installs to every detected agent, and sets up any MCP servers declared in SKILL.md

For sources with multiple skills, you'll be prompted to select which skills to install. Use --yes to install all, or --skill to pick specific ones.

This is the fastest way to go from zero to productive — one command configures every AI agent you use.

Options

Flag	Description
--yes, -y	Install all skills without prompt
--dry-run	Preview without installing
--list	List available skills without installing
--skill <names>	Install specific skills by name (comma-separated)

Examples

Detect agents only

rolecraft setup

Shows which agents are installed and how many skills each has.

Install to all agents

rolecraft setup ./my-skill
rolecraft setup sametcelikbicak/coverage-guard
rolecraft setup npm:@org/agent-rules

Installs the skill to every detected agent automatically. No need to specify --cursor, --claude, etc.

Multi-skill source

# Show skills in a multi-skill source without installing
rolecraft setup ./my-multi-skill-repo --list

# Install specific skills
rolecraft setup ./my-multi-skill-repo --skill "skill-a,skill-b"

# Install all with --yes
rolecraft setup ./my-multi-skill-repo -y

With MCP servers

If the skill's SKILL.md declares MCP servers:

mcp_servers:
  - name: filesystem
    source: npm:@modelcontextprotocol/server-filesystem

rolecraft setup ./my-skill installs the skill to all agents and configures the MCP servers for the agents that support MCP (see MCP Server Management).

Non-interactive (CI)

rolecraft setup ./my-skill -y
rolecraft setup ./my-skill --dry-run -y    # preview without installing

Team onboarding

# First team member creates a bundle
rolecraft bundle create team-defaults

# New members run
rolecraft setup ./team-defaults    # after cloning the repo

See also

• Onboarding guide — full walkthrough
• rolecraft install — single-agent installation with scope flags
• rolecraft bundle — multi-skill installation
• rolecraft doctor — system health check

Node.js API

This command is also available as a programmatic function. See the Node.js API documentation for detailed usage.

import { setup } from 'rolecraft'
const result = await setup('./my-skill', { yes: true })