bb-plugins
Build, install, and debug bb plugins
Install / Use
npx skills add davidondrej/skills --skill bb-pluginsInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
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.
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.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| bb-plugins (this skill)by davidondrej | 80 | 4.1k | 53d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.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.
Skill content
View source on GitHubname: 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-clito operate bb (threads, projects, environments). - For exact API signatures, read the
bb-plugin-authoringskill if it is available, then runbb guide plugins. In the plugin directory, runbb plugin typesbefore trusting local SDK types. Do not guess from minifieddist/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
bb plugin listshows the pluginrunning.- If it added a CLI,
bb <command> --helpworks. - If it added UI, open the page or panel in bb and confirm it loads.
- If the factory throws, the plugin is
error. Readbb plugin logs <id>and fix, thenbb plugin reload <id>.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
