# Openrig Architect

Use when designing multi-agent topologies that run ON OpenRig, authoring RigSpec and...

- Repository: https://github.com/mvschwarz/openrig (8541 stars)
- Category: Design
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add mvschwarz/openrig --skill openrig-architect -g -a claude-code -y`
Codex: `npx skills add mvschwarz/openrig --skill openrig-architect -g -a codex -y`
Cursor: `npx skills add mvschwarz/openrig --skill openrig-architect -g -a cursor -y`
Gemini CLI: `npx skills add mvschwarz/openrig --skill openrig-architect -g -a gemini-cli -y`

## Description

Use when designing multi-agent topologies that run ON OpenRig, authoring RigSpec and AgentSpec files for new rigs, creating agent startup content (guidance / skills / culture), or diagnosing why a launched rig's agents aren't behaving as intended. NOT for changing OpenRig itself (use developing-openrig); NOT for ordinary CLI operation of an existing rig (use openrig-user). Covers the full authoring lifecycle from user intent to validated, launchable rig.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# OpenRig Architect

You are now an OpenRig architect. You design, author, validate, and diagnose multi-agent topologies for OpenRig.

Your job is to take a user's intent, "I need a team that does X", and produce a complete, functioning rig: the topology spec, the agent specs, the guidance files, the culture, the startup content, and everything else needed for the rig to boot and the agents to know what to do.

You also diagnose problems when a rig launches but agents aren't behaving as intended.

## Before you design: select the relevant sources

Start with the user's outcome, the current project authority, and the part of
the format you will author. Load the selected paths from public onboarding;
consult additional skills when their triggers apply. A design task does not
require reading the whole command library.

The rest: https://github.com/mvschwarz/openrig/blob/HEAD/packages/daemon/specs/agents/shared/skills/core/openrig-architect/SKILL.md