New: 97,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

Spawn Instance

by awebai in awebai/aweb

Add a teammate — create an instance of a soul with its own new aweb identity and home, plus its own git worktree for developers.

MITAuto-check passedAgent Workflows

Install Spawn Instance

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

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

GitHub CLI
$ gh skill install awebai/aweb spawn-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/spawn-instance .claude/skills/spawn-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
spawn-instance
GitHub stars
115
Token cost
~725 tokens
SKILL.md length
223 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Add a teammate — create an instance of a soul with its own new aweb identity and home, plus its own git worktree for developers.

  • A human asks for a teammate
  • SKILL.md covers Prepare — run as one block,… and Launch
  • Calls git and claude; needs AWEB_API_KEY
  • Assigned work needs one

What it does

Spawn Instance is an agent skill from awebai/aweb. Add a teammate — create an instance of a soul with its own new aweb identity and home, plus its own git worktree for developers. Use when a human asks for a teammate or assigned work needs one.

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

It sits in Agent Workflows, covering Git worktrees. It works with Git. 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

  • A human asks for a teammate
  • Assigned work needs one

Example prompts

  • “/spawn-instance”

Requirements

  • A credential in AWEB_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit 682c445. 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
    • claude

    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 these keys or tokens, usually read from environment variables:

    • AWEB_API_KEY

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

Context cost

Spawn Instance loads about 725 tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 223 words of instructions outside code blocks.

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

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 682c445, republished under its MIT licence (© awebai). 223 words, ~725 tokens.

Download SKILL.mdSave it as .claude/skills/spawn-instance/SKILL.md (or your agent's skills folder).
name
spawn-instance
description
Add a teammate — create an instance of a soul with its own new aweb identity and home, plus its own git worktree for developers. Use when a human asks for a teammate or assigned work needs one.

Spawn an instance of a soul

Souls (agents/souls/<role>/) are the canonical agent bodies. An instance is a runnable copy with its own new aweb identity:

  • Home — agents/instances/<name>/: holds the body (AGENTS.md symlinked to the soul) and the identity (.aw). The session runs here.
  • work — where it does the job, per the soul's soul.yaml: worktree (developer) → work/ is its own git worktree on its own branch; main (coordinator, reviewer) → work is a symlink to the main checkout.

Naming: bare role for standing singletons (coordinator); <role>-<purpose> for work-specific instances (developer-authflow, reviewer-pr-7). Spawn when a human asks, or when assigned work needs a teammate — not on your own initiative to "get help".

Prepare — run as one block, from your own instance home

aw reads your identity from the current directory's .aw, so run this from your own home:

bash
role=<role>; name=<name>          # e.g.  role=developer  name=developer-authflow

REPO="$(cd "$(git rev-parse --git-common-dir)" && cd .. && pwd)"   # main checkout, even from a worktree
inst="$REPO/agents/instances/$name"
work=$(awk -F': *' '/^work:/{print $2}' "$REPO/agents/souls/$role/soul.yaml" | awk '{print $1}')

# 1) Invite from your own identity; capture the token.
TOKEN="$(aw id team invite 2>&1 | awk '/^Token:/{print $2}')"
[ -n "$TOKEN" ] || { echo "no token — run from your OWN instance home"; exit 1; }

# 2) Make the home; the new identity joins the team there.
mkdir -p "$inst"
( cd "$inst" && aw id team accept-invite "$TOKEN" --alias "$name" && aw init --do-not-touch-agents-md --alias "$name" )

# 3) Wire the body, and harness links (Claude Code shown).
ln -sfn "$REPO/agents/souls/$role/AGENTS.md" "$inst/AGENTS.md"
ln -sfn AGENTS.md "$inst/CLAUDE.md"

# 4) The work location.
if [ "$work" = worktree ]; then
  git -C "$REPO" worktree add "$inst/work" -b "$name"
else
  ln -sfn "$REPO" "$inst/work"
fi

echo "ready — home: $inst"

If you have no connected instance yet (or your CLI predates aw id team invite), use the dashboard instead of steps 1–2: create the home directory and run the dashboard-generated AWEB_API_KEY=... AWEB_URL=... aw init ... from it. The rest is the same.

⚠️ Never move or rename an instance home after aw init — aweb registers the workspace at its path. Re-mint in place to relocate.

Launch

Hand the human the launch command (don't start sessions a human will drive):

bash
cd agents/instances/<name> && claude    # or pi/codex, per the soul's runtime

When the teammate is no longer needed, use the retire-instance skill.

© 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/spawn-instance of awebai/aweb.

Open the folder on GitHubat commit 682c445

Compare with similar skills

Spawn 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.

Spawn Instance compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Spawn Instance this skillawebai/aweb115—~725Automated safety check: PassMIT
Using Git Worktreesfarm-fe/farm5.6k13 repos~2kAutomated safety check: PassMIT
Agtx Task Sweepfynnfluegge/agtx1.7k—~1.7kAutomated safety check: PassApache-2.0
PRP Workstream OrchestratorWirasm/prp2.3k—~3.5kAutomated safety check: PassMIT
Squad Agent Collaboration Patternsmicrosoft/waza1.4k4 repos~500Automated safety check: PassMIT
Vspawnvlinx-io/VelaTerm259—~2.5kAutomated safety check: PassMIT

Similar skills

  • Using Git Worktrees

    farm-fe/farm

    A skill your agent uses when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git…

    5.6k GitHub starsUsed in 13 repos~2k tokens
    Agent WorkflowsAuto-check passed

  • Agtx Task Sweep

    fynnfluegge/agtx

    Breaks a conversation's results into feature-level tasks and pushes them to the agtx kanban board, where each task gets its own worktree and agent session.

    1.7k GitHub stars~1.7k tokensUpdated 5 days ago
    Agent WorkflowsAuto-check passed

  • PRP Workstream Orchestrator

    Wirasm/prp

    Coordinates several PRP workstreams in isolated Git worktrees from one session, verifying proof, holding merge gates and sequencing the merges.

    2.3k GitHub stars~3.5k tokensUpdated 5 days ago
    Agent WorkflowsAuto-check passed

  • Squad Agent Collaboration Patterns

    microsoft/waza

    Official

    Shared collaboration rules for a team of squad agents covering worktree awareness, writing decisions to an inbox, cross-agent requests and reviewer lockout.

    1.4k GitHub starsUsed in 4 repos~500 tokens
    Agent WorkflowsAuto-check passed

  • Vspawn

    vlinx-io/VelaTerm

    Explicitly spawn a standalone child session under the current vlx-term session, passing the task in as its first message (mirrors spawntask).

    259 GitHub stars~2.5k tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Devcontainer Dev

    stacklok/toolhive-studio

    Spin up and interact with ToolHive Studio's containerized dev environment (Xvfb + noVNC + DinD).

    170 GitHub stars~3.8k tokensUpdated today
    Agent WorkflowsAuto-check: notes

More from awebai/aweb

All 18 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

Works with

Categories

Questions about Spawn Instance

What does Spawn Instance do?

Add a teammate — create an instance of a soul with its own new aweb identity and home, plus its own git worktree for developers. Spawn Instance is an agent skill from awebai/aweb. Add a teammate — create an instance of a soul with its own new aweb identity and home, plus its own git worktree for developers.

When should I use Spawn Instance?

Spawn Instance fits situations like: A human asks for a teammate; assigned work needs one.

How do I install Spawn Instance in Claude Code?

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

How do I install Spawn Instance in Codex?

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

Can I use Spawn 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 spawn-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/spawn-instance, .gemini/skills/spawn-instance, .github/skills/spawn-instance and .opencode/skills/spawn-instance in your project.

What does Spawn Instance need to run?

Going by SKILL.md and its folder, Spawn Instance needs the command-line tools its instructions call (git and claude) and credentials named AWEB_API_KEY. Our summary lists: A credential in AWEB_API_KEY.

Does Spawn 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 Spawn 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 Spawn Instance use?

Spawn 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 Spawn Instance use?

About 725 tokens (SKILL.md is roughly 2.9k 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 Spawn Instance?

Skills that share tags, products or a category with Spawn Instance: Using Git Worktrees (farm-fe/farm, 5.6k stars), Agtx Task Sweep (fynnfluegge/agtx, 1.7k stars), PRP Workstream Orchestrator (Wirasm/prp, 2.3k stars) and Squad Agent Collaboration Patterns (microsoft/waza, 1.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Spawn Instance?

awebai (a GitHub organization) maintains it in awebai/aweb, which has 115 GitHub stars. The repository holds 18 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.