Troubleshooting & FAQ

Agent skills

Runtype publishes six official coding-agent skills in the Runtype skills repository. Each skill packages instructions, references, and helper scripts that a coding agent loads on demand while you work with Runtype. The skills cover Runtype product schemas, MCP tools, flow step types, and SDK conventions. The standalone skills CLI supports more than 35 coding agents, including Claude Code, Cursor, Codex, Copilot, and Windsurf.

Install all Runtype skills

To install all six skills, run the following command:

Install all Runtype skills
$npx skills add runtypelabs/skills

The skills CLI detects coding agents on your machine and installs the skills in the selected scope. Run the command from a project directory for a project install, or from your home directory for a global install. After installation, restart your coding agent so it loads the skills.

Install skills with the Runtype CLI

If you installed the Runtype CLI globally with npm install -g @runtypelabs/cli, use its onboard command to install skills and connect the hosted MCP server. Run the following command:

Run Runtype onboarding
$npx -y @runtypelabs/cli@latest onboard

The command checks your Runtype sign-in state, detects the coding agent in the current session, and installs its Runtype skills. It configures the hosted OAuth MCP connection and prints restart or reload instructions. Complete any sign-in or OAuth action that the CLI reports, then restart or reload your coding agent.

Use runtype install-mcp when you want skills and MCP without CLI sign-in. Use runtype skills install when you want skills without MCP.

Global CLI installations check npm for a stable release every hour. When the CLI finds one, it stores the verified version in ~/.runtype/cli/versions/ and activates it for the next invocation. Automatic installation is disabled for CI, source checkouts, project-local installations, and npx or pnpm dlx runs.

To manage CLI updates manually, run one of the following commands:

  • Run runtype update --check to check for a new release without installing it.
  • Run runtype update to install an available release.
  • Run runtype update --rollback to activate the previous healthy managed version.

To keep a package-manager-installed version, set RUNTYPE_DISABLE_AUTO_UPDATE=true. To keep the managed version without checking for updates, set RUNTYPE_DISABLE_UPDATE_CHECK=true.

In an interactive terminal, the CLI offers a one-time skill installation prompt when it detects supported agents. It skips the prompt in CI and for skill, onboarding, and authentication commands.

Install specific skills

To review the available skills before installing, run the following command:

List available skills
$npx skills add runtypelabs/skills --list

To install one skill without selecting from a prompt, run the following command:

Install one skill
$npx skills add runtypelabs/skills --skill runtype-build-product -y

Target a specific agent

To install skills for selected coding agents, pass one or more agent IDs to the --agent option:

Target coding agents
$npx skills add runtypelabs/skills --agent claude-code cursor

Supported IDs include claude-code, cursor, codex, copilot, and windsurf. For the full list, see the skills.sh agent directory.

To see which agents the Runtype CLI detects, run the following command:

List detected agents
$runtype skills list

To install skills for selected agents with the Runtype CLI, run the following command:

Install skills for selected agents
$runtype skills install --agent claude cursor

Use short IDs such as claude, cursor, and codex. Add --yes to skip confirmation, --json for structured output, or --verbose to show installation progress.

Available skills

The following table lists the six official skills and the work that each skill covers:

SkillUse it for
runtypeRoute general Runtype requests to the focused skill.
runtype-adminInspect and manage a live Runtype account.
runtype-build-productBuild and validate hosted Runtype products.
runtype-personaEmbed, theme, and debug Persona chat widgets.
runtype-sdk-marathonUse the Runtype SDK, CLI, Marathon, and code-first workflows.
runtype-templatesCreate, validate, and package Full Product Object templates.

Install all six skills when you need the full Runtype workflow. The coding agent selects the focused skill based on your request.

Connect the MCP server

The skills provide instructions for using Runtype. Connect the hosted Runtype MCP server when you want your coding agent to inspect your account and create resources. Run npx -y @runtypelabs/cli@latest onboard to install skills and configure the connection.

Complete the sign-in and OAuth actions that the CLI reports, then restart or reload your coding agent. Use the Runtype agent onboarding site for the complete first-session sequence.

Update or remove skills

Use the following commands to update, list, or remove skills in the active scope:

Manage installed skills
$npx skills update
$npx skills list
$npx skills remove runtype-build-product

To target a global installation, add --global to the relevant command.

Next steps

Continue with one of these guides: