Agent skill

Acp Provider

by get-bb in get-bb/bb

Configure or troubleshoot ACP agent discovery, custom models, skills, and compaction in BB.

MITAuto-check passed

Install Acp Provider

skills CLI
$ npx skills add get-bb/bb --skill acp-provider -a claude-code

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

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

At a glance

Configure or troubleshoot ACP agent discovery, custom models, skills, and compaction in BB.

  • Needs OPENCODE_API_KEY

What it does

Acp Provider is an agent skill from get-bb/bb. Configure or troubleshoot ACP agent discovery, custom models, skills, and compaction in BB.

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

  • “/acp-provider”

Requirements

  • A credential in OPENCODE_API_KEY

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

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • OPENCODE_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Acp Provider loads about 857 tokens when it runs. Until then it costs about 26 tokens; SKILL.md has 438 words of instructions outside code blocks.

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

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). 438 words, ~857 tokens.

Download SKILL.mdSave it as .claude/skills/acp-provider/SKILL.md (or your agent's skills folder).
name
acp-provider
description
Configure or troubleshoot ACP agent discovery, custom models, skills, and compaction in BB.

ACP providers

Known agents can be discovered automatically when their CLI is installed on the host: opencode, omp, grok, and hermes appear as acp-opencode, acp-omp, acp-grok, and acp-hermes-agent. Inspect the target host's catalog with bb provider list and bb provider models <provider-id> using its environment or machine selector.

To hide a detected ACP agent, use bb provider disable acp-opencode, or Disable on Settings → Providers. Restore it with bb provider enable acp-opencode. This leaves other ACP agents and the host CLI intact. Disabled agents skip background capability probing. bb provider list --all includes disabled agents.

Cursor project skills come from .cursor/skills, which can link to .agents/skills. BB lists these linked skills as read-only under cursor-project.

ACP agents may reject unlisted model IDs. OpenCode requires models in its own configuration; BB discovers them there. OpenCode agents are session modes, not models selectable through BB's model field. Grok Build advertises models and thought_level options over ACP, so the picker follows the connected agent (including xhigh on grok-4.6).

BB launches OpenCode sessions with OPENCODE_CLIENT=acp and OPENCODE_ENABLE_QUESTION_TOOL=false, overriding inherited and custom launch values. Native questions have no ACP interaction handler in BB; agents use the ask-user-question plugin’s AskUserQuestion tool instead. This also applies to custom agents with dialect: "opencode" and does not change OpenCode config files.

OpenCode and Grok ACP support the core bb thread compact command; Cursor ACP does not expose compatible compaction. Check the actual agent's capabilities before attempting provider-specific recovery.

OpenCode Go subscription usage is available in Provider usage when the selected machine has OpenCode installed and a Go subscription. Sign in to Go in OpenCode on that machine, then refresh its OpenCode tab. Verify with bb settings usage --machine <id-or-name> --json; the SDK equivalent is bb.sdk.system.usageLimits({ hostId, providerId: "acp-opencode" }). BB reports Go's five-hour, weekly, and monthly usage and reset times, not local session token totals or other OpenCode providers' subscriptions.

Show full SKILL.md (129 more words)Show less

The collector checks OPENCODE_API_KEY, then the active official Console account and organization in $XDG_DATA_HOME/opencode/opencode.db, then active v2 credential table API keys or official Console OAuth credentials (opencode-go before opencode), then OPENCODE_AUTH_CONTENT or $XDG_DATA_HOME/opencode/auth.json. The default data directory is ~/.local/share/opencode. Database storage is read only; expired Console sessions must be refreshed by OpenCode. V2 OAuth requires the device login method and account/organization metadata for the official Console server. API-key login prefers the opencode-go credential and accepts the shared opencode credential when Go is subscribed. Custom launch env values take precedence over the host environment. A custom OpenCode wrapper must declare dialect: "opencode" and providerUsage: true to expose its usage. Missing credentials, rejected keys, and collection errors remain unavailable states rather than zero usage. Never print API keys when diagnosing setup.

© 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/provider-acp/skills/acp-provider of get-bb/bb.

Open the folder on GitHubat commit 53c1e87

Compare with similar skills

Acp Provider 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.

Acp Provider compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Acp Provider this skillget-bb/bb4.2k—~857Automated safety check: PassMIT
Configuration Saml Providersgreenpau/caddy-security2.3k—~1.6kAutomated safety check: PassApache-2.0
Configuration OAuth Providersgreenpau/caddy-security2.3k—~3.2kAutomated safety check: PassApache-2.0
Acp Routeropenclaw/openclaw392k—~2.4kAutomated safety check: PassMIT
Strategic Compactaffaan-m/ECC275k1 repos~2.1kAutomated safety check: PassMIT
Configure Channelopenclaw/openclaw392k—~946Automated safety check: PassMIT

Similar skills

  • Configuration Saml Providers

    greenpau/caddy-security

    Configure external SAML login providers, ACS/IdP URLs, metadata, signing certificates, realms, and claims.

    2.3k GitHub stars~1.6k tokensUpdated 3 days ago
    Backend & APIsAuto-check passed
  • Configuration OAuth Providers

    greenpau/caddy-security

    Configure external OAuth/OIDC login providers, credentials, scopes, issuer/audience trust, JWKS, PKCE, and portal enablement.

    2.3k GitHub stars~3.2k tokensUpdated 3 days ago
    Backend & APIsAuto-check passed
  • Acp Router

    openclaw/openclaw

    Route plain-language requests for Claude Code, Cursor, Copilot, OpenClaw ACP, OpenCode, Gemini CLI, Qwen, Kiro, Kimi, iFlow, Factory Droid, Kilocode, or explicit ACP harness work into either…

    392k GitHub stars~2.4k tokensUpdated today
    Writing & ContentAuto-check passed
  • Strategic Compact

    affaan-m/ECC

    Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.

    275k GitHub starsUsed in 1 repo~2.1k tokens
    Agent WorkflowsAuto-check passed
  • Configure Channel

    openclaw/openclaw

    Configure and prove a chat channel with non-interactive one-liners; secrets only as SecretRefs.

    392k GitHub stars~946 tokensUpdated today
    Auto-check passed
  • Add Model Provider

    openclaw/openclaw

    Add and live-prove a model provider with non-interactive config one-liners, without exposing credentials.

    392k GitHub stars~1.1k tokensUpdated today
    Auto-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 Acp Provider

What does Acp Provider do?

Configure or troubleshoot ACP agent discovery, custom models, skills, and compaction in BB. Acp Provider is an agent skill from get-bb/bb. Configure or troubleshoot ACP agent discovery, custom models, skills, and compaction in BB.

How do I install Acp Provider in Claude Code?

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

How do I install Acp Provider in Codex?

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

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

What does Acp Provider need to run?

Going by SKILL.md and its folder, Acp Provider needs credentials named OPENCODE_API_KEY. Our summary lists: A credential in OPENCODE_API_KEY.

Does Acp Provider 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 Acp Provider 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 Acp Provider use?

Acp Provider 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 Acp Provider use?

About 857 tokens (SKILL.md is roughly 3.4k 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 Acp Provider?

Skills that share tags, products or a category with Acp Provider: Configuration Saml Providers (greenpau/caddy-security, 2.3k stars), Configuration OAuth Providers (greenpau/caddy-security, 2.3k stars), Acp Router (openclaw/openclaw, 392k stars) and Strategic Compact (affaan-m/ECC, 275k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Acp Provider?

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.