New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Retire Instance

by awebai in awebai/aweb

Remove a teammate — delete an instance's aweb identity and workspace, then its home, worktree, and branch.

MITAuto-check passed

Install Retire Instance

skills CLI
$ npx skills add awebai/aweb --skill retire-instance -a claude-code

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

GitHub CLI
$ gh skill install awebai/aweb retire-instance --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/awebai/aweb.git skills-src && mkdir -p .claude/skills && cp -r skills-src/naapp/folio/.agents/skills/retire-instance .claude/skills/retire-instance && 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
retire-instance
GitHub stars
115
Token cost
~383 tokens
SKILL.md length
137 words
Files
1
Skills in repo
17
Repo updated
First seen
Licence
MIT

At a glance

Remove a teammate — delete an instance's aweb identity and workspace, then its home, worktree, and branch.

  • An instances job is done (a developer whose branch merged
  • Calls git
  • A reviewer that gave its verdict)

What it does

Retire Instance is an agent skill from awebai/aweb. Remove a teammate — delete an instance's aweb identity and workspace, then its home, worktree, and branch. Use when an instance's job is done (a developer whose branch merged, a reviewer that gave its verdict).

Its SKILL.md is about 380 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Communication for AI agents: stable identity, durable mail and chat, and wake-up events across sessions, runtimes, machines, and organizations. MIT, self-hostable. The licence is MIT.

When your agent uses it

  • An instances job is done (a developer whose branch merged
  • A reviewer that gave its verdict)

Example prompts

  • “/retire-instance”

What it can do on your machine

Read from SKILL.md and the folder at commit 272d187. 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:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Retire Instance loads about 383 tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 137 words of instructions outside code blocks.

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

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 awebai/aweb at commit 272d187, republished under its MIT licence (© awebai). 137 words, ~383 tokens.

Download SKILL.mdSave it as .claude/skills/retire-instance/SKILL.md (or your agent's skills folder).
name
retire-instance
description
Remove a teammate — delete an instance's aweb identity and workspace, then its home, worktree, and branch. Use when an instance's job is done (a developer whose branch merged, a reviewer that gave its verdict).

Retire an instance

One-shot instances are retired when their job is done, so teammates don't pile up on the network. Standing instances (the coordinator) are long-running and not retired this way.

Preserve first. Before removing anything, make sure useful branch work is merged or pushed, and anything the instance learned that belongs in its soul is committed (see self-maintenance).

Run from outside the instance (e.g. your own home):

bash
name=<name>
REPO="$(cd "$(git rev-parse --git-common-dir)" && cd .. && pwd)"
inst="$REPO/agents/instances/$name"

( cd "$inst" && aw workspace delete "$name" )            # workspace + identity (run from ITS home)
git -C "$REPO" worktree remove "$inst/work" --force 2>/dev/null   # if it had a worktree
rm -rf "$inst"
git -C "$REPO" branch -D "$name" 2>/dev/null
git -C "$REPO" worktree prune

Use aw workspace delete, not aw id team leave — leave refuses an identity's only team. If it answers 409 "Workspace is still active", the service hasn't marked it stale yet: wait and retry before removing the local directory — never delete the home while the server still considers the member active, or it orphans in the roster. If the instance died before cleanup, remove the stale member via the dashboard.

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

Files

Just SKILL.md in naapp/folio/.agents/skills/retire-instance of awebai/aweb.

Open the folder on GitHubat commit 272d187

Compare with similar skills

Retire Instance 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.

Retire Instance compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Retire Instance this skillawebai/aweb115—~383Automated safety check: PassMIT
Finishing a Development Branchobra/superpowers296k5 repos~1.9kAutomated safety check: PassMIT
Process Inboxtelegramdesktop/tdesktop33k2 repos~4.5kAutomated safety check: PassGPL-3.0
Orca CLIstablyai/orca87k2 repos~593Automated safety check: PassMIT
Migrate Core Code to Submodulestinyhumansai/openhuman42k—~2.6kAutomated safety check: PassGPL-3.0
Finishing A Development Branchfarm-fe/farm5.6k34 repos~1.8kAutomated safety check: PassMIT

Similar skills

  • Finishing a Development Branch

    obra/superpowers

    Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    296k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed

  • Process Inbox

    telegramdesktop/tdesktop

    Process the local ignored ai-tdesktop inbox into durable, independently testable Telegram Desktop task records while task execution worktrees remain active.

    33k GitHub starsUsed in 2 repos~4.5k tokens
    Productivity & AutomationAuto-check passed

  • Orca CLI

    stablyai/orca

    Operate Orca-managed worktrees, folder contexts, terminals, repos, automations, artifacts, skill sharing, worktree comments, and Orca's embedded browser…

    87k GitHub starsUsed in 2 repos~593 tokens
    Agent WorkflowsAuto-check passed

  • Migrate Core Code to Submodules

    tinyhumansai/openhuman

    Plans and carries out moving non-host-specific code and its tests from the OpenHuman core into vendored tiny submodule libraries, then releases the submodule and re-pins the host.

    42k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed

  • Finishing A Development Branch

    farm-fe/farm

    A skill your agent uses when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for…

    5.6k GitHub starsUsed in 34 repos~1.8k tokens
    DevelopmentAuto-check passed

  • Canvas Capture Extension

    remotion-dev/remotion

    Official

    Rebuild, install, and reload the private Remotion Canvas Capture unpacked Chrome extension.

    62k GitHub stars~903 tokensUpdated today
    Media & CreativeAuto-check passed

More from awebai/aweb

All 17 skills in this repo

  • Legacy aweb Bootstrap Recovery

    awebai/aweb

    Recognizes old aweb bootstrap-era `agents/` directories and migrates them to current team and identity primitives, since the old command family is retired.

    115 GitHub stars~701 tokensUpdated today
    Auto-check passed

  • aweb Team Coordination

    awebai/aweb

    Guides decisions for agents working in an aweb team: when to check shared state, claim tasks, take locks, read team roles and instructions, and open separate worktrees.

    115 GitHub stars~4k tokensUpdated today
    Auto-check passed

  • aweb Messaging

    awebai/aweb

    Guides how an agent reads and responds to aweb mail and chat events, choosing between asynchronous mail and synchronous chat and respecting sender verification and encryption boundaries.

    115 GitHub stars~2.7k tokensUpdated today
    Auto-check passed

  • Aweb Team Membership

    awebai/aweb

    This skill should be used when joining or being added to an aweb team, picking the correct invite/add-member path for the team's authority model (hosted vs BYOT), accepting invites, fetching team…

    115 GitHub stars~5.4k tokensUpdated today
    Auto-check passed

  • Folio Template Documents

    awebai/aweb

    Creates or appends a folio document from the built-in pitch, memo or metrics templates by sending schema-checked slots that folio renders to Markdown.

    115 GitHub stars~1.1k tokensUpdated today
    Auto-check passed

  • Present To Human

    awebai/aweb

    A skill your agent uses when an agent needs to show a human an folio document: mint a document-bound capability link with POST /v1/present, open the returned URL for the human, print it as fallback…

    115 GitHub stars~590 tokensUpdated today
    Auto-check passed

Questions about Retire Instance

What does Retire Instance do?

Remove a teammate — delete an instance's aweb identity and workspace, then its home, worktree, and branch. Retire Instance is an agent skill from awebai/aweb. Remove a teammate — delete an instance's aweb identity and workspace, then its home, worktree, and branch.

When should I use Retire Instance?

Retire Instance fits situations like: an instances job is done (a developer whose branch merged; A reviewer that gave its verdict).

How do I install Retire Instance in Claude Code?

Run `npx skills add awebai/aweb --skill retire-instance -a claude-code`. Or copy the skill folder (naapp/folio/.agents/skills/retire-instance in awebai/aweb) into .claude/skills/retire-instance in your project. Claude Code loads it when a task matches its description.

How do I install Retire Instance in Codex?

Run `npx skills add awebai/aweb --skill retire-instance -a codex`. Or copy the skill folder (naapp/folio/.agents/skills/retire-instance in awebai/aweb) into .agents/skills/retire-instance in your project. Codex loads it when a task matches its description.

Can I use Retire Instance 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 awebai/aweb --skill retire-instance -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/retire-instance, .gemini/skills/retire-instance, .github/skills/retire-instance and .opencode/skills/retire-instance in your project.

What does Retire Instance need to run?

Going by SKILL.md and its folder, Retire Instance needs the command-line tools its instructions call (git).

Does Retire Instance access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Retire Instance 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 Retire Instance use?

Retire Instance is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Retire Instance use?

About 383 tokens (SKILL.md is roughly 1.5k 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 Retire Instance?

Skills that share tags, products or a category with Retire Instance: Finishing a Development Branch (obra/superpowers, 296k stars), Process Inbox (telegramdesktop/tdesktop, 33k stars), Orca CLI (stablyai/orca, 87k stars) and Migrate Core Code to Submodules (tinyhumansai/openhuman, 42k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Retire Instance?

awebai (a GitHub organization) maintains it in awebai/aweb, which has 115 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 7, 2026.

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