Skip to content
mcp/skillhub

Agent Skill

Topology Mutation And Seat Management skill

topology-mutation-and-seat-managementmvschwarz/openrigpackages/daemon/specs/agents/shared/skills/core/topology-mutation-and-seat-management/SKILL.md

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 that mutation must work while the rig is active, not just in clean fixtures.

8.1kApache-2.0

always on

125 tokname + description

once used

1,437 tokSKILL.md body

bundled files

0

repo stars

8.1kGitHub

Install the Topology Mutation And Seat Management skill

Skills CLI (Claude Code, Codex, Cursor and others)

npx skills add https://github.com/mvschwarz/openrig --skill topology-mutation-and-seat-management

Claude Code, by hand (all projects)

git clone --depth 1 https://github.com/mvschwarz/openrig.git /tmp/openrig
mkdir -p ~/.claude/skills
cp -R /tmp/openrig/packages/daemon/specs/agents/shared/skills/core/topology-mutation-and-seat-management ~/.claude/skills/topology-mutation-and-seat-management

For one project only, copy the folder into .claude/skills/ in that project instead. The agent picks it up when a task matches its description.

What it costs your context

Agent Skills load in three steps. Tokens counted with the o200k tokenizer; your model's count will differ a little.

WhenWhat loadsCost
Every sessionName and description125 tok
When the agent uses itThe SKILL.md instructions1,437 tok
Only if openedNo bundled files—

Until it is used, topology-mutation-and-seat-management costs about 11× less than the median MCP server we measured (1,362 tokens on every turn). Installing all 94 skills from mvschwarz/openrig would load 6,757 tokens of descriptions. Skills vs MCP study

Checks

Our checks found nothing to flag: it follows the Agent Skills specification's naming and size guidelines and doesn't pipe downloads into a shell.

Checked 2026-10-22 · method

What's inside

The headings of its SKILL.md. Read the full file on GitHub.

  • Topology Mutation and Seat Management
  • Use this when
  • Adding seats: rig grow first, a fragment when you need more
  • Don't use this when
  • Failure modes (4)
  • Proof standard
  • Stable roles during topology changes
  • Currently shipped surfaces
  • Choose the proving environment and authority
  • See also

More skills from mvschwarz/openrig

All skills in this repo
  1. agent-browsermvschwarz/openrig

    Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.

    8.1k108 tok idle · 3,477 in use
  2. agent-operated-softwaremvschwarz/openrig

    Use when designing, building, operating, or diagnosing an ongoing application whose live backend or control loop includes OpenRig agents, including applications with a Markdown, YAML, or JSON agent control plane or a thin surface over specialist agent roles.

    8.1k51 tok idle · 910 in use
  3. agent-operated-workflowsmvschwarz/openrig

    Use when a bounded real-world procedure has a deterministic happy path but brownfield, variable, or partially knowable state; when an operation must resume from verified evidence; or when deciding whether agent judgment or ordinary code should own a procedure's control loop.

    8.1k55 tok idle · 730 in use
  4. agent-startersmvschwarz/openrig

    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 + provenance.

    8.1k84 tok idle · 1,317 in use
  5. 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 transmits implementation without preserving product intent).

    8.1k95 tok idle · 1,276 in use
  6. Use before launching a team during agent-guided setup, or when a user asks to configure OpenRig command permissions, reduce repeated native approval prompts, or apply a selected rig/seat permission policy.

    8.1k46 tok idle · 2,819 in use
  7. backlog-capturemvschwarz/openrig

    Quickly capture product ideas, feature requests, or insights from meetings and conversations. Rapid documentation with smart categorization and deduplication.

    8.1k31 tok idle · 434 in use
  8. claude-compaction-restoremvschwarz/openrig

    Use when a Claude Code session is about to compact, has just compacted, reached its context limit, resumed after /compact, or must rebuild its working picture of a long-running seat from its own restore map, its JSONL transcript and the files it touched.

    8.1k260 tok idle · 3,982 in use