Updated today
by mvschwarz
openrig
Build your own network of agents from Claude Code, Codex and Pi: persistent teams with roles, shared context and owned work.
8.7k GitHub stars (8,665)
+3.1k in 30 days
| Period | New stars |
|---|---|
| Sep 27 | +22 |
| Sep 28 | +414 |
| Sep 29 | +1,083 |
| Sep 30 | +796 |
| Oct 1 | +174 |
| Oct 2 | +699 |
| Oct 3 | +583 |
| Oct 4 | +373 |
| Oct 5 | +300 |
| Oct 6 | +255 |
| Oct 7 | +281 |
| Oct 8 | +261 |
| Oct 9 | +372 |
| Oct 10 | +305 |
| Oct 11 | +277 |
| Oct 12 | +242 |
| Oct 13 | +273 |
| Oct 14 | +152 |
| Oct 15 | +57 |
| Oct 16 | +53 |
| Oct 17 | +148 |
| Oct 18 | +42 |
| Oct 19 | +100 |
| Oct 20 | +104 |
| Oct 21 | +131 |
| Oct 22 | +22 |
| Oct 23 | +34 |
| Oct 24 | +46 |
| Oct 25 | +29 |
| Oct 26 | +26 |
| Oct 27 | +28 |
| Oct 28 | +40 |
| Oct 29 | +22 |
| Oct 30 | +45 |
| Oct 31 | +50 |
| Nov 1 | +105 |
| Nov 2 | +57 |
| Nov 3 | +20 |
| Nov 4 | +30 |
| Nov 5 | +21 |
| Nov 6 | +53 |
- 29 skills (29 skills found in its SKILL.md files)
- 722 forks (722 forks)
- Today last update (Last updated today)
Install
Skills CLI
npx skills add mvschwarz/openrig
Asks which skills and agents to install. Just one: npx skills add mvschwarz/openrig --skill rigs — add -g for every project.
Claude Code
git clone https://github.com/mvschwarz/openrigcp -r "openrig/skills/rigs" ~/.claude/skills/
Copies the rigs skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add mvschwarz/openrig
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md — showing the first 29 of 94 files.
-
rigs
Use when a person in their own Claude Code or Codex session mentions OpenRig, rigs or the rig command, or wants a team of coding agents (Claude Code, Codex) on their project. That includes installing, setting up, starting or updating OpenRig, seeing, getting back to or re-attaching to their OpenRig agents (including bringing a stopped team back), TUI or operator, starting or sharing a team, and j…
skills/rigs/ on GitHub (opens in a new tab)SKILL.md -
developing-openrig
Use when changing OpenRig's own source in a clone of the openrig repository: finding which package or file owns a behaviour, choosing which tests to run, testing a change without disturbing the OpenRig daemon your own session runs on, judging whether a diff touches a high-risk area, or preparing a pull request. Not for operating rigs (openrig-skills) or designing rig topologies.
.agents/skills/ on GitHub (opens in a new tab)developing-openrig/ SKILL.md -
agent-starters
Use when creating, refreshing, packaging, inspecting, promoting, or deprecating a named per-seat starting point — Agent Starter manifest authoring, the 6-state lifecycle (captured → named → inspectable → used → promoted → deprecated), provenance honesty, and refusal rules. NOT a VM image; a managed starting point composed from agent role + startup context + optional native session source + proven…
skills/_canonical/ on GitHub (opens in a new tab)core/ agent-starters/ SKILL.md -
agent-startup-and-context-ingestion
Use when designing or auditing how an agent becomes useful after launch — AGENTS.md overlays, role files, skills, rig specs, workflow specs, startup checklists, refocus messages, "rig context" surface. Covers the 4 failure modes that make startup context fail (old rig spec misses current operating mode; current agents never told about new guidance; startup file as dumping ground; orchestrator tra…
skills/_canonical/ on GitHub (opens in a new tab)core/ agent-startup-and-context-ingestion/ SKILL.md -
cross-host-rig-commands
Use when addressing a registered remote OpenRig host, choosing its transport, or interpreting a cross-host result.
skills/_canonical/ on GitHub (opens in a new tab)core/ cross-host-rig-commands/ SKILL.md -
human-in-the-loop
Use when classifying a slice closeout (auto-continue / human gate / park), routing a real decision to a human, or designing a human queue/dashboard surface. Treats humans as durable network participants with attention surfaces, queues, and decision records — escalation lands as a durable attention item, not a chat message. Approval is NOT required for every clean closeout; the default RSI conveyo…
skills/_canonical/ on GitHub (opens in a new tab)core/ human-in-the-loop/ SKILL.md -
messaging-the-human
Use when project policy calls for a human decision or update, a human delivery is pending or failed, or a reply must resume the right work.
skills/_canonical/ on GitHub (opens in a new tab)core/ messaging-the-human/ SKILL.md -
openrig-architect
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 author…
skills/_canonical/ on GitHub (opens in a new tab)core/ openrig-architect/ SKILL.md -
openrig-cmux
Use when opening OpenRig fleet terminals into cmux — turning a rig, pod, mission, slice, or saved view into live agent tiles via `rig terminal --provider cmux`, or driving cmux on an agent's request. Same OpenRig view semantics as openrig-herdr (the verbs, honest-partial/degrade, read-only cross-rig, scroll/copy, same-size-only duplicates); cmux is the **best-effort** provider (herdr is the defau…
skills/_canonical/ on GitHub (opens in a new tab)core/ openrig-cmux/ SKILL.md -
openrig-herdr
Use when opening OpenRig fleet terminals as a herdr wall — turning a rig, pod, mission, slice, or saved view into live interactive agent tiles via `rig terminal`, watching another rig read-only, or driving herdr on an agent's request ("open all my rigs + a mission as views"). Covers the `rig terminal open|views|status` verbs, the honest-partial/degrade reading of the result, the read-only-by-cons…
skills/_canonical/ on GitHub (opens in a new tab)core/ openrig-herdr/ SKILL.md -
openrig-skills
Use when an agent running inside OpenRig needs the right skill or context for fleet recovery, seat handover, new-seat orientation, a watchdog wake, cross-host reach to an agent on another machine, rig packaging, an OpenRig upgrade, systematic debugging, queue triage, or implementation planning; also when the agent doesn't know what applies or nothing is projected on cold boot. Installing, startin…
skills/_canonical/ on GitHub (opens in a new tab)core/ openrig-skills/ SKILL.md -
openrig-software-factory
Use when a user wants a continuing software team for a real repository, or has a first OpenRig team and needs a repeatable path for reviewed work and later tasks.
skills/_canonical/ on GitHub (opens in a new tab)core/ openrig-software-factory/ SKILL.md -
openrig-upgrade
Use when an agent is preparing or performing an OpenRig CLI/daemon upgrade and must preserve live seats, verify each mutation, or reconcile managed plugin and skill files without overwriting local work.
skills/_canonical/ on GitHub (opens in a new tab)core/ openrig-upgrade/ SKILL.md -
rig-bundles-and-shareable-artifacts
Use when authoring or installing a rig bundle (packaged, shareable artifact that instantiates an opinionated OpenRig topology + workflow), reasoning about the bundle vs extension boundary, or auditing a bundle for portability. Covers the 4 failure modes that prevent bundles from working anywhere but the operator's machine, and the inspect-before-install discipline.
skills/_canonical/ on GitHub (opens in a new tab)core/ rig-bundles-and-shareable-artifacts/ SKILL.md -
rig-lifecycle
Use when reasoning about the rig lifecycle operations family (create / start / stop / resume / restore / snapshot / release / unclaim / destroy), reading or trusting `rig ps` / lifecycle projections after recovery, or designing proof for a lifecycle scenario. Covers the 4 failure modes (auto-restore creates partial rig; projections report healthier than reality; provider auth treated as impl work…
skills/_canonical/ on GitHub (opens in a new tab)core/ rig-lifecycle/ SKILL.md -
session-source-fork
Use when authoring a rig spec member or `rig expand` payload that needs to start a new managed seat from a prior runtime conversation source — `session_source: { mode: fork, ref: { kind, value } }`. v1 supports `mode: fork` with `ref.kind: native_id` for Claude and Codex. The new seat persists a NEW post-fork token; the parent token is NEVER written onto the new seat. NOT for restoring an existin…
skills/_canonical/ on GitHub (opens in a new tab)core/ session-source-fork/ SKILL.md -
specification-system
Use when authoring rig specs, agent specs, workflow specs, startup/context fragments, operating-mode declarations, or designing the user spec library. Covers the 4 failure modes (spec instantiates topology but not workflow/mode; spec depends on local paths and fails on another host; agents modify specs as one-off files instead of preserving reusable intent; validation proves YAML shape but not wh…
skills/_canonical/ on GitHub (opens in a new tab)core/ specification-system/ SKILL.md -
topology-mutation-and-seat-management
Use when changing a rig while it is alive — `rig grow` / `rig expand` / `rig shrink` / `rig launch` / `rig remove` / `rig discover` / `rig bind` / `rig adopt` / `rig attach`. Covers the 4 failure modes (newly created seat lacks queue/startup/role; edges and permissions not updated; adopt/bind succeeds at tmux but not OpenRig identity; shrink/remove leaves stale topology references) and the rule t…
skills/_canonical/ on GitHub (opens in a new tab)core/ topology-mutation-and-seat-management/ SKILL.md -
watchdog
Use when configuring `rig watchdog` policies, authoring wake/refocus/alignment-checkpoint messages, or choosing the right intervention level for a stale-owner situation. The 3-level continuity-check stack (wake / refocus / alignment-checkpoint), the discipline that prevents cadence pollution and bureaucracy theater, and the artifact-pool loop-edge pattern for evidence-aware waking.
skills/_canonical/ on GitHub (opens in a new tab)core/ watchdog/ SKILL.md -
backlog-capture
Quickly capture product ideas, feature requests, or insights from meetings and conversations. Rapid documentation with smart categorization and deduplication.
skills/_canonical/ on GitHub (opens in a new tab)pm/ backlog-capture/ SKILL.md -
context-builder
Gather and distill context from meetings, competitors, regulatory sources, and internal discussions. Produces background.md for a feature and updates shared context docs when new knowledge is discovered.
skills/_canonical/ on GitHub (opens in a new tab)pm/ context-builder/ SKILL.md -
exec-summary
Generate a 1-2 page executive summary for a feature — orients sales, leadership, and engineering from a single document.
skills/_canonical/ on GitHub (opens in a new tab)pm/ exec-summary/ SKILL.md -
office-hours
YC-style product validation using six forcing questions. Pressure-tests a feature idea before it becomes a requirement — ensuring real demand, a clear wedge, and evidence behind assumptions.
skills/_canonical/ on GitHub (opens in a new tab)pm/ office-hours/ SKILL.md -
plan-review
Multi-perspective review of a feature plan or requirements doc before development begins. Evaluates from strategy, design/UX, and engineering angles to catch gaps early.
skills/_canonical/ on GitHub (opens in a new tab)pm/ plan-review/ SKILL.md -
requirements-writer
Use when converting PM intake into a slice SPEC.md with observable acceptance outcomes, explicit scope, and advisory sibling build dependencies.
skills/_canonical/ on GitHub (opens in a new tab)pm/ requirements-writer/ SKILL.md -
ui-mockup
Create UI mockups at three fidelity levels — ASCII wireframes for quick iteration, standalone HTML mockups for delivery with requirements, and live prototypes for interaction testing.
skills/_canonical/ on GitHub (opens in a new tab)pm/ ui-mockup/ SKILL.md -
development-team
Use when a development pod begins or hands off implementation, QA, or design work.
skills/_canonical/ on GitHub (opens in a new tab)pods/ development-team/ SKILL.md -
orchestration-team
Use when coordinating assignments, selected review boundaries, or blocked work across a rig.
skills/_canonical/ on GitHub (opens in a new tab)pods/ orchestration-team/ SKILL.md -
oversight-team
Use when you are a seat on the oversight pod (a standing monitor-mode rig that keeps OTHER rigs healthy), configuring or running the drift detectors, or choosing whether to intervene vs escalate. Covers the pull-not-poll posture, the v0 detectors (premature-park, process-drift, off-task, token-burn), the intervention ladder (orchestrator-ping -> refocus -> human escalation), and the cheap+deep mo…
skills/_canonical/ on GitHub (opens in a new tab)pods/ oversight-team/ SKILL.md
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.