SkillAgentSearch skills...

bb-plugins

Build, install, and debug bb plugins

Install / Use

npx skills add davidondrej/skills --skill bb-plugins

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

80/100

Category

Automation

Supported Platforms

Universal

Our assessment of bb-plugins

bb-plugins scores 80/100 on our quality scale, 2487th of 2,790 Automation skills we index.

Its SKILL.md is 3.3 KB long, split into 7 sections with 2 code examples: a solid amount of guidance for an agent.

With 4,079 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
26/30
Structure
16/20
Description
8/15
Adoption
15/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so bb-plugins is actively maintained.
  • Our last check on 2026-11-08 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

bb-plugins compared with similar skills

All 4 of these similar skills score higher than bb-plugins; compare them before choosing.

SkillScoreStarsUpdatedFormat
bb-plugins (this skill)by davidondrej804.1k53d agoSKILL.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md
Claude-Code-Game-Studiosby Donchitos10039.7k7d agoCLAUDE.md

Frequently asked questions

How do I install bb-plugins?
Run npx skills add davidondrej/skills --skill bb-plugins. The install tabs above show the steps for each supported agent.
Which AI agents does bb-plugins work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is bb-plugins safe to use?
It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is bb-plugins still maintained?
The repository was last updated about 2 months ago, so bb-plugins is actively maintained.

name: bb-plugins description: 'Build, install, and debug bb plugins. Use when the user wants a bb plugin, a sidebar panel, a bb CLI subcommand, an agent tool, a theme, a provider, or to extend bb itself. For running threads and the core bb CLI, use bb-cli instead.'

bb plugins

bb plugins are TypeScript packages that run inside bb. They are how bb extends itself.

Many first-party features are plugins: GitHub, Docs, Memory, Tasks, Connect, Automations, Secrets, Keep Awake, and the coding-agent providers.

Trust

Plugins are full-trust. Server code runs in-process. App UI is same-origin page code, not a sandbox. Host workers run as Node on enrolled machines.

Review source before installing third-party plugins. Keep credentials in secret: true settings.

This skill vs others

  • Use this skill to create, install, or change a plugin.
  • Use bb-cli to operate bb (threads, projects, environments).
  • For exact API signatures, read the bb-plugin-authoring skill if it is available, then run bb guide plugins. In the plugin directory, run bb plugin types before trusting local SDK types. Do not guess from minified dist/ files.

Scaffold

bb plugin new hello            # add --app for a React UI
cd bb-plugin-hello
bb plugin install . --yes
bb plugin dev                  # rebuild + reload on save

The manifest is the bb object in package.json. Required: bb.name, bb.description, bb.branding.icon, bb.server. Optional: bb.app, bb.host, bb.skills, bb.themes.

Plugin id is the last package-name segment with a bb-plugin- prefix stripped. bb-plugin-hello and @acme/bb-plugin-hello both become hello.

Put runtime imports in dependencies. Leave types and tooling in devDependencies. Git installs run npm install --omit=dev.

What a plugin can add

A default-export factory in server.ts receives BbPluginApi and registers surfaces:

  • settings, kv + SQLite storage, HTTP, RPC, realtime
  • background services and cron
  • one top-level bb <name> … command
  • agent tools, skills/ folders, extra instructions
  • mention providers
  • optional host workers and experimental agent providers

app.tsx default-exports definePluginApp and can add pages, thread-panel actions, composer controls, file openers, and a replacement sidebar.

Do not copy the full API into this skill. Read bb-plugin-authoring when implementing a surface.

Install and ship

bb plugin install .                                 # local path
bb plugin install github                            # bundled official plugin
bb plugin install npm:bb-plugin-notes@^1.0.0
bb plugin install git:https://github.com/acme/bb-plugin-notes.git@^1.2.0
bb plugin list
bb plugin reload <id>
bb plugin logs <id> -f

Installs prompt because the code is full-trust. Pass --yes to skip.

A failed managed update rolls back. Catalog refresh never installs code.

Community listings live at https://getbb.app/marketplace/v1/marketplace.json. Submit via a PR to https://github.com/get-bb/marketplace. Use the submit-a-plugin skill for that workflow.

Check the work

  1. bb plugin list shows the plugin running.
  2. If it added a CLI, bb <command> --help works.
  3. If it added UI, open the page or panel in bb and confirm it loads.
  4. If the factory throws, the plugin is error. Read bb plugin logs <id> and fix, then bb plugin reload <id>.

Related Skills

View on GitHub
GitHub Stars4.1k
CategoryAutomation
Updated1mo ago
Forks601

Languages

Shell

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions
bb-plugins — Universal Skill: Install & Safety Check | SkillAgent