Agent skill

Retiring And Inheriting A Seat

by mvschwarz in mvschwarz/openrig

A skill your agent uses when you are a sitting agent near your context threshold (~85%) and a PLANNED seat transition is due — retire deliberately and hand your seat to a fresh successor primed from…

Apache-2.0Auto-check passedAgent Workflows

Install Retiring And Inheriting A Seat

skills CLI
$ npx skills add mvschwarz/openrig --skill retiring-and-inheriting-a-seat -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mvschwarz/openrig retiring-and-inheriting-a-seat --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mvschwarz/openrig.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/daemon/assets/plugins/openrig-core/skills/retiring-and-inheriting-a-seat .claude/skills/retiring-and-inheriting-a-seat && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
retiring-and-inheriting-a-seat
GitHub stars
6.8k
Token cost
~3.5k tokens
SKILL.md length
1,854 words
Files
2
Skills in repo
49
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when you are a sitting agent near your context threshold (~85%) and a PLANNED seat transition is due — retire deliberately and hand your seat to a fresh successor primed from…

  • Works in 6 steps: Trigger — the selected continuity… → Author the handover packet, deliberately… → Prime the fresh successor — rig walk the… → …
  • Rather than let compaction degrade you
  • SKILL.md covers Use this when, Don't use this when, Why planned handover beats… and The handover sequence, plus 7 more sections
  • Calls claude and codex

What it does

Retiring And Inheriting A Seat is an agent skill from mvschwarz/openrig. Use when you are a sitting agent near your context threshold (~85%) and a PLANNED seat transition is due — retire deliberately and hand your seat to a fresh successor primed from a packet, rather than let compaction degrade you. Covers the handover packet, the append-only lineage ledger (one row per tenure), physical-seat continuity, the do-not-over-inherit framing, the optional warm-handoff window, and wake-v0 (consulting a retired predecessor). NOT for unplanned compaction/crash recovery…

Its SKILL.md is about 3.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `CHANGELOG.md`).

It sits in Agent Workflows. The repository describes itself as: Build your own network of agents from Claude Code, Codex and Pi: persistent teams with roles, shared context and owned work. The licence is Apache-2.0.

When your agent uses it

  • Rather than let compaction degrade you

Example prompts

  • “/retiring-and-inheriting-a-seat”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Trigger — the selected continuity threshold or a deliberate role transition.
  2. Author the handover packet, deliberately — a composed context pack carrying current
  3. Prime the fresh successor — rig walk the packet into the seat (paced delivery lets the
  4. Assess before cutover. If an apprenticeship or warm handoff is selected,
  5. Preserve the physical seat at cutover — follow the portable SOP linked from
  6. Write the lineage-ledger row and tombstone (below). Record the actual

What it can do on your machine

Read from SKILL.md and the folder at commit bed4d45. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • claude
    • codex

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Retiring And Inheriting A Seat loads about 3.5k tokens when it runs. Until then it costs about 166 tokens; SKILL.md has 1,854 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~166
When it runs · the whole SKILL.md, loaded when a task matches
~3.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from mvschwarz/openrig at commit bed4d45, republished under its Apache-2.0 licence (© mvschwarz). 1,854 words, ~3,504 tokens.

Download SKILL.mdSave it as .claude/skills/retiring-and-inheriting-a-seat/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
retiring-and-inheriting-a-seat
description
Use when you are a sitting agent near your context threshold (~85%) and a PLANNED seat transition is due — retire deliberately and hand your seat to a fresh successor primed from a packet, rather than let compaction degrade you. Covers the handover packet, the append-only lineage ledger (one row per tenure), physical-seat continuity, the do-not-over-inherit framing, the optional warm-handoff window, and wake-v0 (consulting a retired predecessor). NOT for unplanned compaction/crash recovery (session-compaction-and-restore / claude-compaction-restore) and NOT the seat-binding primitive mechanics (seat-continuity-and-handover).

Retiring and Inheriting a Seat

A planned seat transition. A long-lived seat accumulates context; as it nears the window's edge, don't wait for compaction to degrade you into a cold-started agent — retire deliberately and hand the seat to a fresh successor primed from a packet plus the seat's accumulated lineage. The seat address is stable; its occupants are a lineage. Keep the transition and its authority explicit.

Use this when

  • You are a sitting agent near your context threshold (~85%) with a planned transition (or a deliberate role change), and want the successor to start clean.
  • You are priming a fresh successor into an existing seat.
  • You are recording a tenure in the seat's lineage ledger / writing your tombstone.
  • You are inheriting a seat and need the do-not-over-inherit framing.
  • You want to consult the agent who sat in this seat before you.

Don't use this when

  • Unplanned compaction or a crash already happened — that is the backstop path: session-compaction-and-restore / claude-compaction-restore.
  • You need the seat-binding primitive mechanics (rebuild/fork/fresh, the two-outcome honesty model, the provenance schema) — seat-continuity-and-handover.
  • The seat is fresh with no occupant to retire — rig launch / agent-starters.

Why planned handover beats riding compaction

Compaction is the crash-class backstop (it stays that). A planned handover is deliberate: you author the packet with a clear head before degradation sets in, the successor starts on a clean context, and the transition is auditable. Reach for this at a threshold you can see coming; fall back to compaction only when a transition wasn't planned.

The handover sequence

  1. Trigger — the selected continuity threshold or a deliberate role transition. Use the configured policy and named transition owner; a context estimate alone does not authorize a cutover.
  2. Author the handover packet, deliberately — a composed context pack carrying current work + next owner, the seat's durable pointers, constraints and authority boundaries, and the accumulated lineage wisdom ("those before you learned X"). This IS a restore packet in the session-compaction-and-restore 16-field contract — reuse that contract, don't reinvent it. Compose it with rig context compose (see openrig-user → "Context packs and paced delivery"). Enumerate the seat's standing duties as first-class packet content: what recurs, at what cadence, on which surface, and who will hold it after cutover. Carry each duty both in this packet and in durable seat state, because recurring duties are the content most often lost at a generation boundary while urgent one-off work carries cleanly. Write the seat's recap too: run rig context recap-write --rig <rig> --seat <seat> --file <draft> alongside updating LEARNED.md. A rebuild reads RECAP.md before anything else. The format the store checks is in seat-continuity-and-handover, "Write the seat's recap before a handover".
  3. Prime the fresh successor — rig walk the packet into the seat (paced delivery lets the successor absorb it in order), or launch-with-packet. The successor reads it as inheritance, not identity. The packet's first-read line MUST point the successor at orienting-to-an-inherited-seat — its world model of what a handover is. Carry that pointer in the durable packet artifact itself; never inject it as a runtime prompt keyed to the seat name (that runtime mechanism is the ghost-prompt class the orientation skill teaches successors to refuse). Artifact-carried survives the swap for free and needs no enabled gate.
  4. Assess before cutover. If an apprenticeship or warm handoff is selected, use that staged window for questions and domain work before the owner decides. The incumbent retains authority until the owner-worded cutover; do not retire it merely to free a name while waiting for that decision.
  5. Preserve the physical seat at cutover — follow the portable SOP linked from seat-continuity-and-handover. Keep the canonical tmux session, window and pane; resume the exact accepted successor history there and reconcile binding, environment, queue identity and attached clients. Preserve the incumbent's exact token as a cold-advisor handle when that is the selected disposition. Renaming tmux sessions is a repair fallback, not the default sequence.
  6. Write the lineage-ledger row and tombstone (below). Record the actual outcomes and transfer each standing duty explicitly. Complete the successor's post-cutover self-check before unfreezing authority.

Apprentice mode — incumbent

An apprentice-handover policy gives you an early preparation boundary, not permission to automate the succession decision. Create a fresh, staged, unbound successor; prove the pinned model before installing context; then open a conversation, not a gauntlet. Give coached errands, answer questions, and judge work in the real domain. Scored probes are optional tools whose rigor must match the stakes, not mandatory ceremony.

Stay the authority-bearing incumbent until the named owner words the gate and the mechanic records the effect receipt. Before that word, the apprentice may observe, ask, and produce evidence but may not act as the seat. Enumerate deposits and transfer every standing duty explicitly, because recurring duties are otherwise easy to lose while visible one-off work appears complete. Put the mechanical cutover in the portable SOP linked from seat-continuity-and-handover; do not duplicate or improvise it here.

The lineage ledger (append-only, one row per tenure)

The seat's tenure record, written at handover by the retiring agent. One tiny row per tenure:

  • generation — v1, v2, … (a seat accumulates 20–40 tenures over months)
  • harness session id — captured AT BOOT, not at retirement (a crash never gets the chance to write it later)
  • started / retired timestamps
  • handover-packet pointer — the pack ref
  • tombstone — one line: what this tenure did, written by the retiring agent itself

Why it works (zero search infrastructure): any timestamped record — a git commit, a qitem, a NOTES.md line, a stream item — joins to the seat's ledger by interval match → generation + session token → wake that tenure. One row per handover, append-only. The ledger is the tenure record; work-tree notes remain lived context, not identity state.

Crash-ended tenures get their row appended post-hoc by the crash-cart / restore path, flagged honest-approximate (the boot-captured session id is what makes this recoverable).

Inherit the seat, not the predecessor's identity

You are inheriting a seat, not becoming your predecessor. Frame it explicitly to the successor: "agents sat here before you and learned X; you carry the seat's mission, not their identity." Do not claim a predecessor's work as your own or use its stale identity as the current binding. Inherit the seat's mission and hard-won lessons; keep your own fresh identity and session.

Show full SKILL.md (823 more words)Show less

Reach back to a retained predecessor

A retired tenure is a cold advisor you can consult. Look up the seat's ledger → get that generation's session token → resume it for one question, then let it sleep again:

  • Claude: claude -p --resume <session>
  • Codex: codex exec (resume the rollout)

Use rig ask <rig> "<q>" --wake <seat[@gen]|token> for an explicit bounded consultation (introduced in CLI 0.5.1). Check rig ask --help for --runtime and --wake-timeout. The wrapper uses a runtime resume; its presence is not proof that a particular retained history is available. For a Claude history, claude -p --resume <full-uuid> is the runtime-level fallback when supported. Diagnose the specific failure before declaring the channel unavailable.

What to write in your packet about reaching you — your successor asking you questions is the reason this is a handover and not a compaction:

  • Give your verbatim resume handle and known availability limits. Retirement alone does not expire retained history. Resuming still depends on that history, runtime access and remaining context; distinguish these failure modes. The advisor supplies testimony and does not regain the live seat's authority.
  • Pre-form the questions. Inventory what only you hold and write the questions out. An affordance needs a trigger: name the tradeoff, missing rationale or conflict that should prompt a question.

Wake-tenancy — the identity halves (a woken tenure can mistake itself for the live seat). The hardest thing to apply checked-not-believed to is your own identity — a retired tenure resumed for a question can answer, and act, as if it still held the seat. Two rules close it:

  • Waker: disclose the target's tenure status in the wake prompt. Open with "you are retired; gen-N holds this seat now — I'm consulting you for one question." An oriented tenure gives honest testimony; an un-oriented one may reason as the live occupant.
  • Woken: verify your OWN tenancy before your first act. If you are being resumed / woken (a parked or retired session, or any session waking on a seat that already issued READY), your first check is rig whoami + a successor check — confirm whether you are still the live occupant or a successor now holds the seat, before you do anything. Answer the question; do not resume the job.

Failure modes

  1. Riding compaction when a planned handover was available — a degraded agent authors a degraded packet. Retire deliberately at the threshold you can see coming.
  2. Over-inheriting — the successor believes it is the predecessor (stale self-model, mis-claimed history). Frame inheritance explicitly; keep a fresh identity.
  3. Session id captured at retirement, not boot — a crash then leaves no row, or an unfindable tenure. Capture at boot.
  4. Suffixing the LIVE seat (<seat>-v2 as the active address) — lineage leaking into identity, the wrong shape. The live address stays clean; generation belongs in the ledger.
  5. Tombstone omitted or vague — the ledger can no longer answer "who did this / who to wake." One honest line, every tenure.

Checks around a planned transition

  • Stage and assess before the owner calls cutover. Use startup context when the successor is unbound; check its actual address before relying on registry-routed delivery. Keep incumbent authority and physical-pane custody until the selected SOP's cutover steps apply. A rejected candidate does not require renaming the incumbent back into a seat it should still hold.
  • Preserve exact resume handles. A retained advisor may have no managed node or live pane. The ledger identifies its history independently of the live-seat registry; absence from rig ps alone does not prove that history is gone.
  • Recheck work at the boundary. Queue items can arrive after the packet was frozen. The successor reads its current owned queue, reconciles transition-window work and staged inputs, and records every remaining obligation.
  • Verify identity across surfaces. Canonical binding, provider history, process environment, queue identity and attached clients must agree. Correct a staged identity residue through the supported cutover/reconciliation path; renaming a tmux session alone is not proof that those surfaces agree.
  • Keep incomplete evidence explicit. Flag unavailable activity telemetry as unavailable, and mark a tombstone written by someone else as approximate.
  • Coordinate the maintenance window. Tell the routing/monitoring owner the target and expected window before an authorized cutover. Only an explicitly configured suppression changes monitoring behavior; close the window with the actual effect receipt, deviations and unresolved gaps.

These are verification prompts, not a claim that a particular runtime transition has passed. Use the linked portable SOP for mechanics and record the actual run.

See also

  • orienting-to-an-inherited-seat — the successor-side world model your packet points them at (loaded at boot); the load-bearing counterpart to this driver-side mechanic.
  • session-compaction-and-restore — the 16-field packet contract this practice reuses, and the UNPLANNED-compaction backstop it replaces for planned transitions.
  • seat-continuity-and-handover — the seat-binding primitive mechanics + stable-seat-identity architecture; the lineage ledger is the concrete form of its abstract provenance record.
  • openrig-user → "Context packs and paced delivery" — rig context compose + rig walk, to author and deliver the packet.
  • claude-compaction-restore — the Claude crash-class restore SOP.
  • agent-starters — composing a primed starting point for the successor.

© mvschwarz, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in packages/daemon/assets/plugins/openrig-core/skills/retiring-and-inheriting-a-seat of mvschwarz/openrig.

  • SKILL.md
  • CHANGELOG.md

Open the folder on GitHubat commit bed4d45

Compare with similar skills

Retiring And Inheriting A Seat next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Retiring And Inheriting A Seat compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Retiring And Inheriting A Seat this skillmvschwarz/openrig6.8k—~3.5kAutomated safety check: PassApache-2.0
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
Hook Development for Claude Code Pluginsanthropics/claude-plugins-official38k10 repos~4.1kAutomated safety check: NotesApache-2.0
Using Superpowersfarm-fe/farm5.6k36 repos~1.4kAutomated safety check: PassMIT
Executing Plans Inlineobra/superpowers297k2 repos~5.1kAutomated safety check: PassMIT
Skill CreatorAzure/azqr79689 repos~8.2kAutomated safety check: PassApache-2.0

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • Hook Development for Claude Code Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.

    38k GitHub starsUsed in 10 repos~4.1k tokens
    Agent WorkflowsAuto-check: notes
  • Using Superpowers

    farm-fe/farm

    A skill your agent uses when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions

    5.6k GitHub starsUsed in 36 repos~1.4k tokens
    Agent WorkflowsAuto-check passed
  • Executing Plans Inline

    obra/superpowers

    Has the agent carry out an implementation plan itself, task by task in the current session, keeping a ledger, proving each step with a test and ending with one whole-branch review.

    297k GitHub starsUsed in 2 repos~5.1k tokens
    Agent WorkflowsAuto-check passed
  • Skill Creator

    Azure/azqr

    Official

    Create new skills, modify and improve existing skills, and measure skill performance.

    796 GitHub starsUsed in 89 repos~8.2k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Agent Development

    anthropics/claude-plugins-official

    Official

    Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.

    38k GitHub starsUsed in 7 repos~2.8k tokens
    Agent WorkflowsAuto-check passed

More from mvschwarz/openrig

All 49 skills in this repo
  • OpenRig Upgrade Procedure

    mvschwarz/openrig

    Walks an agent through upgrading the OpenRig CLI and daemon one observed step at a time, keeping live seats alive and reconciling managed plugin files.

    6.8k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Agent Refocusing

    mvschwarz/openrig

    Re-grounds a long-running agent in the current product outcome by running a path-based trace to the root of its topology and work trees.

    6.8k GitHub stars~864 tokensUpdated today
    Auto-check passed
  • OpenRig Software Factory

    mvschwarz/openrig

    Helps set up a continuing agent software team for a real repository with OpenRig, choosing between manual work, queue handoffs and an explicit Workflow.

    6.8k GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • Separates a stable agent seat's identity from its changing occupant, and records honest, two-part provenance whenever one occupant replaces another.

    6.8k GitHub stars~2.5k tokensUpdated today
    Auto-check passed
  • Loads one section of a Markdown file by its path#h2-slug address with a bundled resolver script, for use outside OpenRig's context library.

    6.8k GitHub stars~341 tokensUpdated today
    Auto-check passed
  • Agent Starters

    mvschwarz/openrig

    Covers authoring, inspecting, refreshing, promoting and deprecating named Agent Starters, the reusable starting points for agent seats in a rig.

    6.8k GitHub stars~1.7k tokensUpdated today
    Auto-check passed

Categories

Questions about Retiring And Inheriting A Seat

What does Retiring And Inheriting A Seat do?

A skill your agent uses when you are a sitting agent near your context threshold (~85%) and a PLANNED seat transition is due — retire deliberately and hand your seat to a fresh successor primed from…. Retiring And Inheriting A Seat is an agent skill from mvschwarz/openrig. Use when you are a sitting agent near your context threshold (~85%) and a PLANNED seat transition is due — retire deliberately and hand your seat to a fresh successor primed from a packet, rather than let compaction degrade you.

When should I use Retiring And Inheriting A Seat?

Retiring And Inheriting A Seat fits situations like: rather than let compaction degrade you.

How do I install Retiring And Inheriting A Seat in Claude Code?

Run `npx skills add mvschwarz/openrig --skill retiring-and-inheriting-a-seat -a claude-code`. Or copy the skill folder (packages/daemon/assets/plugins/openrig-core/skills/retiring-and-inheriting-a-seat in mvschwarz/openrig) into .claude/skills/retiring-and-inheriting-a-seat in your project. Claude Code loads it when a task matches its description.

How do I install Retiring And Inheriting A Seat in Codex?

Run `npx skills add mvschwarz/openrig --skill retiring-and-inheriting-a-seat -a codex`. Or copy the skill folder (packages/daemon/assets/plugins/openrig-core/skills/retiring-and-inheriting-a-seat in mvschwarz/openrig) into .agents/skills/retiring-and-inheriting-a-seat in your project. Codex loads it when a task matches its description.

Can I use Retiring And Inheriting A Seat in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mvschwarz/openrig --skill retiring-and-inheriting-a-seat -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/retiring-and-inheriting-a-seat, .gemini/skills/retiring-and-inheriting-a-seat, .github/skills/retiring-and-inheriting-a-seat and .opencode/skills/retiring-and-inheriting-a-seat in your project.

What does Retiring And Inheriting A Seat need to run?

Going by SKILL.md and its folder, Retiring And Inheriting A Seat needs the command-line tools its instructions call (claude and codex).

Does Retiring And Inheriting A Seat access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Retiring And Inheriting A Seat safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Retiring And Inheriting A Seat use?

Retiring And Inheriting A Seat is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Retiring And Inheriting A Seat use?

About 3.5k tokens (SKILL.md is roughly 14k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Retiring And Inheriting A Seat?

Skills that share tags, products or a category with Retiring And Inheriting A Seat: MCP Server Builder (anthropics/skills, 180k stars), Hook Development for Claude Code Plugins (anthropics/claude-plugins-official, 38k stars), Using Superpowers (farm-fe/farm, 5.6k stars) and Executing Plans Inline (obra/superpowers, 297k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Retiring And Inheriting A Seat?

mvschwarz (a GitHub user) maintains it in mvschwarz/openrig, which has 6,785 GitHub stars. The repository holds 49 skills in this directory. The repository was last updated on October 11, 2026.

Source: mvschwarz/openrig on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.