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

Legacy aweb Bootstrap Recovery

by awebai in 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.

MITAuto-check passedAgent Workflows

Install Legacy aweb Bootstrap Recovery

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

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

GitHub CLI
$ gh skill install awebai/aweb aweb-bootstrap --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/skills/aweb-bootstrap .claude/skills/aweb-bootstrap && 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
aweb-bootstrap
GitHub stars
115
Token cost
~701 tokens
SKILL.md length
300 words
Files
2 (incl. references)
Skills in repo
17
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 4 steps: Inspect before mutating → Back up any .aw/ directory before moving… → Recreate needed workspaces with current… → …
  • Finding an old `agents/team.yaml` layout in a repository
  • SKILL.md covers How to recognize an old…, Safe recovery policy and Migration guidance
  • Calls git

What it does

The old `aw agents bootstrap` command family no longer exists, so this skill is for recognizing a legacy layout rather than running it. It describes what an old repo looks like, typically an `agents/` folder with `team.yaml`, home directories and worktrees, and sometimes an ignored `.aw/` folder holding signing keys and identity state that must be treated as private and never deleted casually.

Its safe recovery policy inspects before mutating, backs up any `.aw/` directory before moving or deleting a legacy home, then recreates workspaces with current primitives such as `aw team admin create`, `aw init` or `git worktree add`. Roles and instructions from the old layout can be copied into a resource pack or applied directly, but final names, certificates and `.aw` state must stay local rather than being committed.

When your agent uses it

  • Finding an old `agents/team.yaml` layout in a repository
  • Deciding whether to back up or delete a legacy `.aw/` directory
  • Migrating bootstrap-era roles and instructions into a resource pack

Example prompts

  • “This repo still has an old agents/team.yaml, help me migrate it safely.”
  • “I found a legacy .aw directory, should I back it up before removing it?”
  • “Move the roles from agents/roles into a resource pack for the new setup.”

Requirements

  • The `aw` CLI
  • Pre-approved tools (allowed-tools): Bash(aw *)

Workflow steps

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

  1. Inspect before mutating
  2. Back up any .aw/ directory before moving or deleting a legacy home.
  3. Recreate needed workspaces with current primitives
  4. Apply reusable resources from current team blueprints / resource packs rather

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(aw *)

    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

Legacy aweb Bootstrap Recovery loads about 701 tokens when it runs, and up to ~1.2k if it reads all its reference files. Until then it costs about 73 tokens; SKILL.md has 300 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~73
When it runs · the whole SKILL.md, loaded when a task matches
~701
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.2k

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 a6ca92a, republished under its MIT licence (© awebai). 300 words, ~701 tokens.

Download SKILL.mdSave it as .claude/skills/aweb-bootstrap/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
aweb-bootstrap
description
This skill should be used when recognizing or manually recovering legacy bootstrap-era `agents/` directories, or when migrating old bootstrap template repos toward primitive-first setup and resource packs. The `aw agents` command family is retired; do not recommend running it.
allowed-tools
Bash(aw *)

aweb Bootstrap (retired command family)

The aw agents bootstrap / aw agents ... command family has been retired. Use this skill only to recognize old bootstrap-era layouts and migrate them to primitive-first setup. Do not instruct users to run aw agents ....

For new setup, use:

  • aweb-team-membership for invites, joins, certificates, switching, and hosted vs BYOT authority decisions;
  • aweb-identity for local/global identity state, custody, keys, and address claims;
  • ordinary git worktree / filesystem operations for worktrees and copied resources;
  • team blueprints / resource packs for reusable roles, instructions, skills, and harness adapters.

How to recognize an old bootstrap layout

Legacy repos may contain:

text
agents/
  team.yaml
  docs/
  roles/
  home/<responsibility>/AGENTS.md
  worktrees/<name>/

Some homes or worktrees may contain ignored .aw/ state and signing keys. Treat that state as private identity material. Never delete it casually.

Safe recovery policy

  1. Inspect before mutating:
    • list agents/team.yaml, agents/home/*, agents/worktrees/*;
    • check for .aw/signing.key, .aw/identity.yaml, .aw/teams.yaml, and .aw/team-certs/ under homes/worktrees;
    • run aw workspace status only from a concrete home/worktree, not from an uninitialized repo root.
  2. Back up any .aw/ directory before moving or deleting a legacy home.
  3. Recreate needed workspaces with current primitives:
    • create/join teams with aw team admin create, aw team invite, aw team join, or controller-side aw id team ... primitives;
    • connect existing certs with aw init, aw workspace connect, or aw service init;
    • create worktrees with git worktree add or the narrower aw workspace add-worktree helper when appropriate.
  4. Apply reusable resources from current team blueprints / resource packs rather than treating old team.yaml as authority.

Migration guidance

  • Roles and instructions from agents/roles/ and agents/instructions.md can be copied into a resource pack or applied explicitly with aw roles / aw instructions.
  • Per-agent startup text from agents/home/<responsibility>/AGENTS.md can move into blueprint profile instructions or a manually maintained home.
  • Final names, DIDs, addresses, certificates, and .aw state must remain local runtime state; do not commit them into resource packs.

© 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

SKILL.md and 1 other file (references) in skills/aweb-bootstrap of awebai/aweb.

  • SKILL.md
  • references/bootstrap-scenarios.md

Open the folder on GitHubat commit a6ca92a

Compare with similar skills

Legacy aweb Bootstrap Recovery 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.

Legacy aweb Bootstrap Recovery compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Legacy aweb Bootstrap Recovery this skillawebai/aweb115—~701Automated safety check: PassMIT
Darwin Skill Optimizeralchaincyf/darwin-skill6.2k1 repos~4.7kAutomated safety check: PassMIT
ToolJet Skill ManagerToolJet/ToolJet41k—~867Automated safety check: PassAGPL-3.0
Dotagentsgetsentry/sentry-wizard295—~900Automated safety check: PassCustom licence
Sandboxed.sh Library ManagementTh0rgal/sandboxed.sh516—~931Automated safety check: PassNone
Skill Managerbuzhangsan/skill-manager321—~1.8kAutomated safety check: NotesMIT

Similar skills

  • Darwin Skill Optimizer

    alchaincyf/darwin-skill

    Scores SKILL.md files on a nine-dimension rubric, then improves them in a keep-or-revert loop with independent judge agents, test prompts, git history and human checkpoints.

    6.2k GitHub starsUsed in 1 repo~4.7k tokens
    Agent WorkflowsAuto-check passed

  • ToolJet Skill Manager

    ToolJet/ToolJet

    Decides where a new agent skill belongs in the ToolJet repo, public root or private ee submodule, then wires the symlinks so it loads in Claude Code, Cursor and Codex.

    41k GitHub stars~867 tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Dotagents

    getsentry/sentry-wizard

    Official

    Manage agent skill dependencies with dotagents. An agent skill from getsentry/sentry-wizard.

    295 GitHub stars~900 tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Sandboxed.sh Library Management

    Th0rgal/sandboxed.sh

    Reads and updates the Sandboxed.sh Library, a git-backed store of skills, agents, commands, tools, rules and MCP servers, through its library tools.

    516 GitHub stars~931 tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Skill Manager

    buzhangsan/skill-manager

    A Claude Code skill that allows you to search, browse, and install skills from a database of 31,767+ community skills with intelligent folder-level downloads.

    321 GitHub stars~1.8k tokensUpdated 8 mo ago
    Agent WorkflowsAuto-check: notes

  • Watchmen Setup

    firstbatchxyz/watchmen

    Walks through installing watchmen, running its init wizard, wiring the plugin into Codex or Claude Code and checking the result with doctor.

    296 GitHub stars~1.1k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check: notes

More from awebai/aweb

All 17 skills in this repo

  • 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

  • Set Theme

    awebai/aweb

    A skill your agent uses when an agent needs to brand folio presentation pages for its team: read or update GET/PUT /v1/theme with colors, fonts, header/footer, and an optional base64 raster logo.

    115 GitHub stars~669 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Legacy aweb Bootstrap Recovery

What does Legacy aweb Bootstrap Recovery do?

Recognizes old aweb bootstrap-era `agents/` directories and migrates them to current team and identity primitives, since the old command family is retired. The old `aw agents bootstrap` command family no longer exists, so this skill is for recognizing a legacy layout rather than running it.aw/` folder holding signing keys and identity state that must be treated as private and never deleted casually.

When should I use Legacy aweb Bootstrap Recovery?

Legacy aweb Bootstrap Recovery fits situations like: finding an old `agents/team.yaml` layout in a repository; deciding whether to back up or delete a legacy `.aw/` directory; migrating bootstrap-era roles and instructions into a resource pack.

How do I install Legacy aweb Bootstrap Recovery in Claude Code?

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

How do I install Legacy aweb Bootstrap Recovery in Codex?

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

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

What does Legacy aweb Bootstrap Recovery need to run?

Going by SKILL.md and its folder, Legacy aweb Bootstrap Recovery needs the command-line tools its instructions call (git). Our summary lists: The `aw` CLI. Its frontmatter pre-approves these tools: Bash(aw *).

Does Legacy aweb Bootstrap Recovery 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 Legacy aweb Bootstrap Recovery 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 Legacy aweb Bootstrap Recovery use?

Legacy aweb Bootstrap Recovery 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 Legacy aweb Bootstrap Recovery use?

About 701 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 491 tokens, read only when the agent opens those files.

What are the alternatives to Legacy aweb Bootstrap Recovery?

Skills that share tags, products or a category with Legacy aweb Bootstrap Recovery: Darwin Skill Optimizer (alchaincyf/darwin-skill, 6.2k stars), ToolJet Skill Manager (ToolJet/ToolJet, 41k stars), Dotagents (getsentry/sentry-wizard, 295 stars) and Sandboxed.sh Library Management (Th0rgal/sandboxed.sh, 516 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Legacy aweb Bootstrap Recovery?

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 9, 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.