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

Plugin Guide Maintenance

by get-bb in get-bb/bb

Update Plugin Guide cards, fixtures, and annotations when public SDK contracts or Guide presentation change.

MITAuto-check passed

Install Plugin Guide Maintenance

skills CLI
$ npx skills add get-bb/bb --skill plugin-guide-maintenance -a claude-code

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

GitHub CLI
$ gh skill install get-bb/bb plugin-guide-maintenance --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/get-bb/bb.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.bb/skills/plugin-guide-maintenance .claude/skills/plugin-guide-maintenance && 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
plugin-guide-maintenance
GitHub stars
4.2k
Token cost
~1.3k tokens
SKILL.md length
637 words
Files
1
Skills in repo
33
Repo updated
First seen
Licence
MIT

At a glance

Update Plugin Guide cards, fixtures, and annotations when public SDK contracts or Guide presentation change.

  • Works in 3 steps: The app component that shows the surface. → The slot, collector, or adapter that… → The closest app test that defines the…
  • SKILL.md covers Confirm a public API change, Find the product source, Add the Guide entry and Maintain annotation layout, plus 1 more section
  • Calls pnpm and git

What it does

Plugin Guide Maintenance is an agent skill from get-bb/bb. Update Plugin Guide cards, fixtures, and annotations when public SDK contracts or Guide presentation change.

Its SKILL.md is about 1.3k 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: The agent IDE that builds itself. The licence is MIT.

Example prompts

  • “/plugin-guide-maintenance”

Workflow steps

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

  1. The app component that shows the surface.
  2. The slot, collector, or adapter that inserts the plugin content.
  3. The closest app test that defines the real states.

What it can do on your machine

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

    • pnpm
    • git

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

  • Network

    No URLs in SKILL.md. Its commands use pnpm and 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

Plugin Guide Maintenance loads about 1.3k tokens when it runs. Until then it costs about 33 tokens; SKILL.md has 637 words of instructions outside code blocks.

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

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 get-bb/bb at commit 68a1e8b, republished under its MIT licence (© get-bb). 637 words, ~1,284 tokens.

Download SKILL.mdSave it as .claude/skills/plugin-guide-maintenance/SKILL.md (or your agent's skills folder).
name
plugin-guide-maintenance
description
Update Plugin Guide cards, fixtures, and annotations when public SDK contracts or Guide presentation change.

Maintain the Plugin Guide

The Plugin Guide is bb's public Plugin SDK reference. For a public API change, follow the full workflow. For annotation-only maintenance, start at Maintain annotation layout, skip the public-API section, and then follow the annotation-only verification path.

Confirm a public API change

Build the declarations and inspect the SDK change:

sh
pnpm exec turbo run build:types --filter=@get-bb/plugin-sdk
git diff -- packages/plugin-sdk/package.json packages/plugin-sdk/src

Continue only when the API change affects a Guide card, API symbol list, or fixture. If the Guide remains accurate, do not change it.

New public members also require:

  • an experimental_ name, or an Experimental type name;
  • an entry in docs/api_to_audit.md;
  • compatibility with released SDK users unless the user approves the break.

Find the product source

For a visible method, inspect these sources:

  1. The app component that shows the surface.
  2. The slot, collector, or adapter that inserts the plugin content.
  3. The closest app test that defines the real states.

Record stable source paths and anchors in plugins/plugin-api-docs/src/anatomy-manifest.json. Use labels, roles, data attributes, class constants, and state names as anchors. The @bb/app tests check the anchors against the source.

For a method without a visible surface, use the Plugin backend group. Do not invent interface elements.

Add the Guide entry

For a new Guide entry, run the scaffold command with its sources and symbols:

sh
pnpm exec turbo run scaffold:surface-entry --filter=bb-plugin-plugin-api-docs -- \
  --id <stable-id> \
  --title "<visible-product-object>" \
  --group <group> \
  --source <source-path> \
  --api-symbol <exported-name>

Complete the applicable changes:

  • Update plugins/plugin-api-docs/src/surfaces.ts.
  • Prefer an existing card unless the API creates a new product surface.
  • Keep existing surface IDs stable and list each exact exported symbol.
  • Name example plugins in firstParty by display name. A plugin missing from plugins/plugin-api-docs/src/first-party-plugins.json needs a row there; the @bb/scripts tests check each row against the plugin's manifest.
  • For a visible method, update wireframes.tsx and its marker.
  • Match the real ownership, labels, roles, order, states, actions, and outcome.
  • Keep Guide annotations separate from the product interface.
  • Add focused tests for the entry, source anchors, trigger, and outcome.
Show full SKILL.md (332 more words)Show less

Maintain annotation layout

Annotation numbers follow the rendered fixture: columns from left to right, then annotations within each column from top to bottom. Read annotations that share a row from left to right.

Treat each annotation's badge, visible target, and interactive overlay as separate layout contracts. Whenever an annotation is added, removed, moved, or renumbered, or its target or surrounding layout changes:

  1. Build and reload the real Plugin Guide at each relevant viewport. Redraw the complete affected sequence, then update surfaces.ts and the focused order test. test/wireframes.test.ts ("draws exactly the surfaces of each visual group on its fixture") fails until the fixture's targets match the group's surface ids.
  2. Inspect each rendered badge footprint, including its outline, ring, and hover scaling. It must remain inside its container, not intersect another badge, and leave its annotated content readable.
  3. Inspect target and overlay bounds, including shared edges and nested areas. An overlay must not enter a sibling surface, cover its content, or capture its hover, focus, or click behavior. A nested child must own its full visible target; do not rely on DOM order or z-index to resolve ownership.
  4. Hover, focus, and click every affected badge and visible target. Confirm that only the matching annotation activates, the full target is reachable, and badge numbers, cards, and previous/next navigation agree.
  5. Add or update a focused test for any boundary or ownership rule that could regress. Every annotation must appear exactly once; DOM nesting alone does not prove correct overlay ownership.

If responsive layouts cannot share one spatial order, fix the layout or define one stable readable sequence before shipping.

Verify the result

For a public API change, run:

sh
pnpm exec turbo run test typecheck lint \
  --filter=@get-bb/plugin-sdk \
  --filter=@bb/app \
  --filter=bb-plugin-plugin-api-docs
bb plugin build plugins/plugin-api-docs

When first-party-plugins.json changes, also run pnpm exec turbo run test --filter=@bb/scripts.

For annotation-only maintenance, use the affected package and Plugin Guide checks required by repository validation policy. Start pnpm dev; inspect the affected entry and reachable actions for a public API change, or the affected annotations and adjacent interactive surfaces for annotation-only maintenance.

© get-bb, 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 .bb/skills/plugin-guide-maintenance of get-bb/bb.

Open the folder on GitHubat commit 68a1e8b

Compare with similar skills

Plugin Guide Maintenance 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.

Plugin Guide Maintenance compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Plugin Guide Maintenance this skillget-bb/bb4.2k—~1.3kAutomated safety check: PassMIT
Card Xiaohongshunexu-io/open-design100k—~402Automated safety check: PassApache-2.0
Wireframe Annotatednexu-io/open-design100k—~960Automated safety check: PassApache-2.0
Orbit Cardheygen-com/hyperframes58k1 repos~887Automated safety check: PassApache-2.0
Arize Annotationgithub/awesome-copilot40k1 repos~2.7kAutomated safety check: NotesMIT
Cardly AutomationComposioHQ/awesome-claude-skills77k3 repos~727Automated safety check: PassNone

Similar skills

  • Card Xiaohongshu

    nexu-io/open-design

    Xiaohongshu-style knowledge cards, arranged as a swipeable multi-card carousel.

    100k GitHub stars~402 tokensUpdated today
    Auto-check passed

  • Wireframe Annotated

    nexu-io/open-design

    An annotated / redline lo-fi wireframe — a desktop landing/marketing page drawn as flat greyboxes inside a browser chrome frame, overlaid with numbered annotation pins (①②③④⑤) in a single accent…

    100k GitHub stars~960 tokensUpdated today
    Frontend & DesignAuto-check passed

  • Orbit Card

    heygen-com/hyperframes

    HyperFrames block with one feature card that circles a dot sphere, driven by camera and card motion exported from an approved Blender rig.

    58k GitHub starsUsed in 1 repo~887 tokens
    Media & CreativeAuto-check passed

  • Arize Annotation

    github/awesome-copilot

    Official

    Creates and manages annotation configs (categorical, continuous, freeform label schemas) and annotation queues (human review workflows) on Arize.

    40k GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check: notes

  • Cardly Automation

    ComposioHQ/awesome-claude-skills

    Automate Cardly tasks via Rube MCP (Composio). An agent skill from ComposioHQ/awesome-claude-skills.

    77k GitHub starsUsed in 3 repos~727 tokens
    Productivity & AutomationAuto-check passed

  • Social X Post Card

    nexu-io/open-design

    Realistic X post card with engagement metrics (likes, reposts, views), suited to video overlays or shareable image cards.

    100k GitHub stars~696 tokensUpdated today
    Product & Project ManagementAuto-check passed

More from get-bb/bb

All 33 skills in this repo

  • Bb CLI

    get-bb/bb

    Inspect or manage BB state with the bb CLI; use for BB commands and configuration.

    4.2k GitHub stars~3.4k tokensUpdated today
    Auto-check passed

  • Skill Creator

    get-bb/bb

    Create or improve BB skills, including their triggers, instructions, and supporting resources.

    4.2k GitHub stars~702 tokensUpdated today
    Auto-check passed

  • Submit A Plugin

    get-bb/bb

    Prepare and submit a BB plugin to the Community marketplace when publication or a marketplace PR is requested.

    4.2k GitHub stars~873 tokensUpdated today
    Auto-check passed

  • Workflows

    get-bb/bb

    Author or run durable BB workflows when the user requests workflow execution or multi-agent orchestration.

    4.2k GitHub stars~890 tokensUpdated today
    Auto-check passed

  • Verify Bb

    get-bb/bb

    Verify BB user journeys in an isolated source dev app using dev-browser@next and the matching source CLI.

    4.2k GitHub stars~3.2k tokensUpdated today
    Auto-check passed

  • Bb Theme Authoring

    get-bb/bb

    Create or edit BB color themes and inspect them in the Theme Preview panel.

    4.2k GitHub stars~1.2k tokensUpdated today
    Auto-check passed

Questions about Plugin Guide Maintenance

What does Plugin Guide Maintenance do?

Update Plugin Guide cards, fixtures, and annotations when public SDK contracts or Guide presentation change. Plugin Guide Maintenance is an agent skill from get-bb/bb. Update Plugin Guide cards, fixtures, and annotations when public SDK contracts or Guide presentation change.

How do I install Plugin Guide Maintenance in Claude Code?

Run `npx skills add get-bb/bb --skill plugin-guide-maintenance -a claude-code`. Or copy the skill folder (.bb/skills/plugin-guide-maintenance in get-bb/bb) into .claude/skills/plugin-guide-maintenance in your project. Claude Code loads it when a task matches its description.

How do I install Plugin Guide Maintenance in Codex?

Run `npx skills add get-bb/bb --skill plugin-guide-maintenance -a codex`. Or copy the skill folder (.bb/skills/plugin-guide-maintenance in get-bb/bb) into .agents/skills/plugin-guide-maintenance in your project. Codex loads it when a task matches its description.

Can I use Plugin Guide Maintenance 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 get-bb/bb --skill plugin-guide-maintenance -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/plugin-guide-maintenance, .gemini/skills/plugin-guide-maintenance, .github/skills/plugin-guide-maintenance and .opencode/skills/plugin-guide-maintenance in your project.

What does Plugin Guide Maintenance need to run?

Going by SKILL.md and its folder, Plugin Guide Maintenance needs the command-line tools its instructions call (pnpm and git).

Does Plugin Guide Maintenance 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 Plugin Guide Maintenance 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 Plugin Guide Maintenance use?

Plugin Guide Maintenance 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 Plugin Guide Maintenance use?

About 1.3k tokens (SKILL.md is roughly 5.1k 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 Plugin Guide Maintenance?

Skills that share tags, products or a category with Plugin Guide Maintenance: Card Xiaohongshu (nexu-io/open-design, 100k stars), Wireframe Annotated (nexu-io/open-design, 100k stars), Orbit Card (heygen-com/hyperframes, 58k stars) and Arize Annotation (github/awesome-copilot, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Plugin Guide Maintenance?

get-bb (a GitHub organization) maintains it in get-bb/bb, which has 4,155 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on October 7, 2026.

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