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

Bb Plugin Authoring

by get-bb in get-bb/bb

Create or change BB plugins and Plugin SDK extensions, including CLI commands, agent tools, providers, and UI surfaces.

MITAuto-check passed

Install Bb Plugin Authoring

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

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

GitHub CLI
$ gh skill install get-bb/bb bb-plugin-authoring --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/bb-guide/skills/bb-plugin-authoring .claude/skills/bb-plugin-authoring && 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
bb-plugin-authoring
GitHub stars
4.2k
Token cost
~1.2k tokens
SKILL.md length
596 words
Files
20 (incl. references)
Skills in repo
34
Repo updated
First seen
Licence
MIT

At a glance

Create or change BB plugins and Plugin SDK extensions, including CLI commands, agent tools, providers, and UI surfaces.

  • SKILL.md covers Implement and verify, Read only the relevant reference, Contract rules and Verification
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Bb Plugin Authoring is an agent skill from get-bb/bb. Create or change BB plugins and Plugin SDK extensions, including CLI commands, agent tools, providers, and UI surfaces.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 20 other files, including reference files (for example `references/backend-api-index.md`, `references/backend-cli-agents.md` and `references/backend-events.md`).

The repository describes itself as: The agent IDE that builds itself. The licence is MIT.

Example prompts

  • “/bb-plugin-authoring”

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.

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

  • Network

    Links to these hosts (documentation or services it may open):

    • getbb.app

    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

Bb Plugin Authoring loads about 1.2k tokens when it runs, and up to ~72k if it reads all its reference files. Until then it costs about 35 tokens; SKILL.md has 596 words of instructions outside code blocks.

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

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). 596 words, ~1,228 tokens.

Download SKILL.mdSave it as .claude/skills/bb-plugin-authoring/SKILL.md (or your agent's skills folder). This skill also uses 19 other files; get the full folder from GitHub.
name
bb-plugin-authoring
description
Create or change BB plugins and Plugin SDK extensions, including CLI commands, agent tools, providers, and UI surfaces.

Author BB plugins

A BB plugin is a TypeScript package that can add server behavior, agent capabilities, host-rendered UI, or a frontend bundle.

Use the current SDK types and repository source as the contract. This skill routes to detailed references, but the installed BB version decides the exact API.

Implement and verify

Inspect the affected package and current SDK declarations to select backend, frontend, or both. Build the plugin and verify the affected contracts and user workflow. Install or reload when a live check is needed for the requested work.

To find where a plugin can extend the app, open the Plugin Guide in bb or at https://getbb.app/plugin-guide.

Use bb plugin new <name> for a new plugin. The scaffold includes frontend files. Remove bb.app and those files when the plugin is headless.

Every new public Plugin SDK surface starts with an experimental_ prefix and an entry in docs/api_to_audit.md. Add its Plugin Guide card and API inventory in the same change.

Read only the relevant reference

Start, package, and release
  • Read references/quickstart.md for package structure, manifest fields, scaffold output, build, install, and the first plugin.
  • Read references/distribution.md for exact API lookup, Git or npm release, multi-plugin repositories, and custom marketplaces.
Backend
  • Read references/backend-foundation.md for the factory, logging, settings, storage, server information, and host access.
  • Read references/backend-sdk.md for projects, environments, threads, interactions, provider models, browser sessions, event history, and calls to another plugin's RPC.
  • Read references/backend-api-index.md to check every public backend, host, AI-service, and test export.
  • Read references/backend-events.md for lifecycle events, environment providers, HTTP, RPC, realtime, background services, and schedules.
  • Read references/backend-machines.md for machine providers, core project source setup, enrollment/bootstrap helpers, and server access.
  • Read references/backend-cli-agents.md for CLI commands, input forms, agent tools, agent configuration, and helper AI services.
  • Read references/providers.md only when the plugin registers an agent provider.
  • Read references/provider-bridge-api-index.md to check every public provider bridge, bridge-test, and ACP export.
  • Read references/backend-ui-lifecycle.md for host-rendered UI, status, cleanup, and reload behavior.
Show full SKILL.md (277 more words)Show less
Frontend
  • Read references/frontend-registration.md for definePluginApp, thread header, sidebar replacement, providers, and top-level registration.
  • Read references/frontend-api-index.md to check every public frontend runtime value and type export.
  • Read references/frontend-core-slots.md for trusted content scripts, homepage, settings, navigation, thread panels, interactions, sidebar actions, and file openers.
  • Read references/frontend-renderer-slots.md for source, diff, message, timeline, palette, and provider-icon renderers or actions.
  • Read references/frontend-components.md for ThreadChat, provider controls, source and diff viewers, links, panels, and the new-thread composer.
  • Read references/frontend-hooks-and-ui.md for hooks, composer customization, vendored components, runtime shims, styling, and crash isolation.
Testing
  • Read references/frontend-testing-api-index.md to check every frontend test runtime value and type export.
  • Read references/testing.md before you add tests or run a live plugin loop.

Contract rules

  • Parse freeform input at the boundary and pass typed values internally.
  • Declare only manifest fields and settings that the plugin implements.
  • Keep secret settings on the server.
  • Treat frontend parameters and persisted values as untrusted input.
  • Return bounded CLI and agent-tool output.
  • Document plugin commands, settings, and operating constraints in the plugin's own skills/ directory. The core CLI skill owns generic plugin management, not individual plugin behavior.
  • Dispose every service, schedule, listener, content script, and resource.
  • Use SDK host components and navigation for host-owned behavior.
  • Use vendored UI source for plugin-owned controls.
  • Keep experimental names until the public API audit stabilizes them.
  • Use current names. Compatibility aliases can warn and can expire after one release. Removed APIs can throw.
  • Run bb plugin types when SDK declaration versions can drift.
  • Run bb plugin build before install, release, or marketplace submission.

Verification

Confirm the backend contract, frontend contract, manifest, generated bundle, and live behavior that the change affects. Use focused tests for failure-prone policy and lifecycle behavior.

© 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

SKILL.md and 19 other files (references) in plugins/bb-guide/skills/bb-plugin-authoring of get-bb/bb.

  • SKILL.md
  • references/backend-api-index.md
  • references/backend-cli-agents.md
  • references/backend-events.md
  • references/backend-foundation.md
  • references/backend-machines.md
  • references/backend-sdk.md
  • references/backend-ui-lifecycle.md
  • references/distribution.md
  • references/frontend-api-index.md
  • references/frontend-components.md
  • references/frontend-core-slots.md
  • references/frontend-hooks-and-ui.md
  • references/frontend-registration.md
  • references/frontend-renderer-slots.md
  • references/frontend-testing-api-index.md
  • references/provider-bridge-api-index.md
  • references/providers.md
  • references/quickstart.md
  • references/testing.md

Open the folder on GitHubat commit 53c1e87

Compare with similar skills

Bb Plugin Authoring 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.

Bb Plugin Authoring compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bb Plugin Authoring this skillget-bb/bb4.2k—~1.2kAutomated safety check: PassMIT
Browser Extension Reversesickn33/agentic-awesome-skills47k1 repos~695Automated safety check: PassMIT
Browser Extension Reversezhaoxuya520/reverse-skill40k2 repos~366Automated safety check: PassMIT
Hermes Agent Skill AuthoringNousResearch/hermes-agent252k—~3.6kAutomated safety check: PassMIT
Configuring Oauth2 Authorization Flowmukul975/Anthropic-Cybersecurity-Skills34k—~1.7kAutomated safety check: PassApache-2.0
Hunk Extension Authoring Mapmodem-dev/hunk9.5k—~5.8kAutomated safety check: PassMIT

Similar skills

  • Browser Extension Reverse

    sickn33/agentic-awesome-skills

    Authorized reverse engineering of Chrome/Firefox extensions: manifest analysis, background workers, content scripts, and extension-based credential or data-exposure research.

    47k GitHub starsUsed in 1 repo~695 tokens
    SecurityAuto-check passed

  • Browser Extension Reverse

    zhaoxuya520/reverse-skill

    A skill your agent uses for authorized reverse engineering of browser extensions (Chrome/Firefox) including manifest analysis, background workers, and extension-based credential or traffic logic…

    40k GitHub starsUsed in 2 repos~366 tokens
    SecurityAuto-check passed

  • Hermes Agent Skill Authoring

    NousResearch/hermes-agent

    Author in-repo SKILL.md files: frontmatter and structure. An agent skill from NousResearch/hermes-agent.

    252k GitHub stars~3.6k tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Configuring Oauth2 Authorization Flow

    mukul975/Anthropic-Cybersecurity-Skills

    Configures secure OAuth 2.0 authorization flows, including Authorization Code with PKCE, Client Credentials, and Device Authorization Grant, covering flow selection, PKCE implementation, token…

    34k GitHub stars~1.7k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed

  • Hunk Extension Authoring Map

    modem-dev/hunk

    Maps the hunkdiff/extension API for building Hunk terminal diff viewer extensions: panes, file views, commands, dialogs, themes, VCS backends and lifecycle events.

    9.5k GitHub stars~5.8k tokensUpdated today
    DevelopmentAuto-check passed

  • Browser Extension Builder

    sickn33/agentic-awesome-skills

    Expert in building browser extensions that solve real problems - Chrome, Firefox, and cross-browser extensions.

    47k GitHub starsUsed in 2 repos~2.3k tokens
    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

  • 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 Bb Plugin Authoring

What does Bb Plugin Authoring do?

Create or change BB plugins and Plugin SDK extensions, including CLI commands, agent tools, providers, and UI surfaces. Bb Plugin Authoring is an agent skill from get-bb/bb. Create or change BB plugins and Plugin SDK extensions, including CLI commands, agent tools, providers, and UI surfaces.

How do I install Bb Plugin Authoring in Claude Code?

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

How do I install Bb Plugin Authoring in Codex?

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

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

What does Bb Plugin Authoring need to run?

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

Does Bb Plugin Authoring access the network?

SKILL.md names 1 domain. As links in the text: getbb.app. This is read from the text; nothing was executed.

Is Bb Plugin Authoring 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 Bb Plugin Authoring use?

Bb Plugin Authoring 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 Bb Plugin Authoring use?

About 1.2k tokens (SKILL.md is roughly 4.9k 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 71k tokens, read only when the agent opens those files.

What are the alternatives to Bb Plugin Authoring?

Skills that share tags, products or a category with Bb Plugin Authoring: Browser Extension Reverse (sickn33/agentic-awesome-skills, 47k stars), Browser Extension Reverse (zhaoxuya520/reverse-skill, 40k stars), Hermes Agent Skill Authoring (NousResearch/hermes-agent, 252k stars) and Configuring Oauth2 Authorization Flow (mukul975/Anthropic-Cybersecurity-Skills, 34k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bb Plugin Authoring?

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.