Agent skill

Agent Annotations

by get-bb in get-bb/bb

Create or edit element annotations in desktop Browser tabs, or update saved annotation comments through the plugin RPC.

MITAuto-check passed

Install Agent Annotations

skills CLI
$ npx skills add get-bb/bb --skill agent-annotations -a claude-code

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

GitHub CLI
$ gh skill install get-bb/bb agent-annotations --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/plugins/agent-annotations/skills/agent-annotations .claude/skills/agent-annotations && 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
agent-annotations
GitHub stars
4.2k
Token cost
~403 tokens
SKILL.md length
196 words
Files
1
Skills in repo
34
Repo updated
First seen
Licence
MIT

At a glance

Create or edit element annotations in desktop Browser tabs, or update saved annotation comments through the plugin RPC.

  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Agent Annotations is an agent skill from get-bb/bb. Create or edit element annotations in desktop Browser tabs, or update saved annotation comments through the plugin RPC.

Its SKILL.md is about 400 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

  • “/agent-annotations”

What it can do on your machine

Read from SKILL.md and the folder at commit 53c1e87. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json and bash).

    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

Agent Annotations loads about 403 tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 196 words of instructions outside code blocks.

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

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 53c1e87, republished under its MIT licence (© get-bb). 196 words, ~403 tokens.

Download SKILL.mdSave it as .claude/skills/agent-annotations/SKILL.md (or your agent's skills folder).
name
agent-annotations
description
Create or edit element annotations in desktop Browser tabs, or update saved annotation comments through the plugin RPC.

Enable Agent Annotations in Settings → Plugins. In a desktop Browser tab, activate Annotate elements, select an element, and add its comment to the prompt. Click a numbered pin to edit its comment, including when selection mode is off. Save or Ctrl+Enter (Command+Enter on macOS) updates the saved comment; Cancel or Escape discards the edit. Blank comments cannot be saved. Delete in the pin editor removes that pin and its reference from the current unsent prompt. Successful local message submission or queueing clears the page annotations; failed sends keep them. Pins also disappear when the page navigates or reloads. Saved records remain available to previously sent messages.

Prompt mentions use a stable annotation number and element description. Edits update the context resolved when the prompt is sent without inserting another mention. Messages already sent are unchanged.

The plugin exposes update through its typed agentAnnotationsRpcContract and the generic plugin RPC SDK/CLI. Supply the saved annotation ID and a nonblank comment of up to 4000 characters in a JSON file:

json
{ "id": "annotation-id", "comment": "Make this button green" }
sh
bb plugin rpc call agent-annotations update --input-file annotation-update.json --json

An unknown ID or invalid comment fails without creating a record. RPC updates change saved context; an already-open page pin keeps its local comment until it is edited again.

© 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 plugins/agent-annotations/skills/agent-annotations of get-bb/bb.

Open the folder on GitHubat commit 53c1e87

Compare with similar skills

Agent Annotations 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.

Agent Annotations compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agent Annotations this skillget-bb/bb4.2k—~403Automated safety check: PassMIT
Wireframe Annotatednexu-io/open-design100k—~960Automated safety check: PassApache-2.0
Arize Annotationgithub/awesome-copilot40k1 repos~2.7kAutomated safety check: NotesMIT
Tabs Accessibilitythedaviddias/Front-End-Checklist74k—~409Automated safety check: PassMIT
Decorative Elementsthedaviddias/Front-End-Checklist74k—~672Automated safety check: PassMIT
Scaffold Elementremotion-dev/remotion62k—~202Automated safety check: PassCustom licence

Similar skills

  • 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
  • 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
  • Tabs Accessibility

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing templates, rendered HTML, or shared components related to Make tabs keyboard navigable.

    74k GitHub stars~409 tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Decorative Elements

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing rendered HTML, interactive components, or design-system patterns related to Hide decorative elements from assistive technology.

    74k GitHub stars~672 tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Scaffold Element

    remotion-dev/remotion

    Official

    Scaffold a new Remotion Element for development in the docs Remotion Studio.

    62k GitHub stars~202 tokensUpdated today
    Media & CreativeAuto-check passed
  • Image Annotations

    github/awesome-copilot

    Official

    Annotate screenshots, diagrams, and images with callout rectangles, arrows, labels, and color-coded highlights using PIL.

    40k GitHub stars~6k tokensUpdated today
    DevelopmentAuto-check passed

More from get-bb/bb

All 34 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
  • 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
  • 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 Agent Annotations

What does Agent Annotations do?

Create or edit element annotations in desktop Browser tabs, or update saved annotation comments through the plugin RPC. Agent Annotations is an agent skill from get-bb/bb. Create or edit element annotations in desktop Browser tabs, or update saved annotation comments through the plugin RPC.

How do I install Agent Annotations in Claude Code?

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

How do I install Agent Annotations in Codex?

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

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

What does Agent Annotations need to run?

SKILL.md names no scripts, command-line tools or credentials: Agent Annotations is instructions for the agent only.

Does Agent Annotations 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 Agent Annotations 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 Agent Annotations use?

Agent Annotations 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 Agent Annotations use?

About 403 tokens (SKILL.md is roughly 1.6k 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 Agent Annotations?

Skills that share tags, products or a category with Agent Annotations: Wireframe Annotated (nexu-io/open-design, 100k stars), Arize Annotation (github/awesome-copilot, 40k stars), Tabs Accessibility (thedaviddias/Front-End-Checklist, 74k stars) and Decorative Elements (thedaviddias/Front-End-Checklist, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agent Annotations?

get-bb (a GitHub organization) maintains it in get-bb/bb, which has 4,166 GitHub stars. The repository holds 34 skills in this directory. The repository was last updated on October 8, 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.