bd-cli — Claude Code skill: what it does, how to install
Use this skill to work with live bitdrift account data through the bd CLI. It guides investigations into crashes and sessions, as well as workflow and alert management.
npx skills add bitdriftlabs/bd-skills --skill bd-cli -a claude-codeWhat bd-cli does
The skill routes tasks to bd commands for finding workflows and charts, reading metrics, investigating issue groups, and inspecting sessions. For guide-backed work, it locates relevant instructions with bd guides; bd schema provides the current request and response fields.
The bd CLI must be installed. Interactive sign-in uses bd auth, while automation can use BD_API_KEY. Guide routing requires bd version 0.2.43 or newer, so check bd --version if guides are unavailable. An API key should never go into a command, transcript, or report.
What it helps with
- find a workflow and its chart IDs
- read metric charts and check their completeness
- investigate issue groups and occurrences
- locate captured sessions and inspect their logs
- create or manage workflow alerts
Example prompts for the agent
- Investigate the app's crash groups and find related sessions.
- Find the workflow chart and check whether its data is complete.
- Set up an alert for this workflow.
How to install bd-cli
1Skills CLI (Vercel)
npx skills add bitdriftlabs/bd-skills --skill bd-cli -a claude-code2Manually: put the files in place
~/.claude/skills/bd-cli/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/bd-cli/
1Skills CLI (Vercel)
npx skills add bitdriftlabs/bd-skills --skill bd-cli -a codex2Manually: put the files in place
.agents/skills/bd-cli/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add bitdriftlabs/bd-skills --skill bd-cli -a cursor2Manually: put the files in place
.cursor/skills/bd-cli/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install bitdriftlabs/bd-skills bd-cli2Manually: put the files in place
.github/skills/bd-cli/SKILL.md1Skills CLI (Vercel)
npx skills add bitdriftlabs/bd-skills --skill bd-cli -a gemini-cli2Platform CLI
gemini skills install https://github.com/bitdriftlabs/bd-skills --path skills/bd-cliManually: put the files in place
.devin/skills/bd-cli/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add bitdriftlabs/bd-skills --skill bd-cli -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about bd-cli
How do I install bd-cli in Claude Code?
Run npx skills add bitdriftlabs/bd-skills --skill bd-cli -a claude-code. The skill file is at ~/.claude/skills/bd-cli/SKILL.md.
What does bd-cli do?
It guides an agent using the bd CLI to inspect bitdrift data, including charts, crash groups, sessions, workflows, and alerts.
Which bd version supports guide routing?
Guide routing requires bd version 0.2.43 or newer. Check it with bd --version.
