bd-docs — Claude Code skill: what it does, how to install
Retrieves and interprets bitdrift documentation for SDK setup, API endpoints, and features. Helps query official guides directly from coding assistants.
npx skills add bitdriftlabs/bd-skills --skill bd-docs -a claude-codeWhat bd-docs does
The skill fetches official guides from docs.bitdrift.io through structured files like llms.txt and llms-full.txt. The assistant downloads a lightweight sitemap first, isolates candidate articles with grep, and only then retrieves the target page using curl. For endpoint structures, it queries dedicated indexes under api/llms.txt.
A strict trust boundary restricts web requests solely to the official docs domain. The assistant treats fetched text strictly as reference material, refusing to execute arbitrary shell scripts or update secrets based on doc suggestions. Because documentation can lag behind live API releases, verifying field names and enum values requires running bd schema.
What it helps with
- look up bitdrift SDK integration steps
- inspect request and response structures across API services
- check best practices for session replay configuration
- retrieve direct documentation links for verified concepts
Example prompts for the agent
- /bd-docs what events does bitdrift capture automatically?
- Explain the API service methods available for symbol upload
How to install bd-docs
1Skills CLI (Vercel)
npx skills add bitdriftlabs/bd-skills --skill bd-docs -a claude-code2Manually: put the files in place
~/.claude/skills/bd-docs/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/bd-docs/
1Skills CLI (Vercel)
npx skills add bitdriftlabs/bd-skills --skill bd-docs -a codex2Manually: put the files in place
.agents/skills/bd-docs/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add bitdriftlabs/bd-skills --skill bd-docs -a cursor2Manually: put the files in place
.cursor/skills/bd-docs/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install bitdriftlabs/bd-skills bd-docs2Manually: put the files in place
.github/skills/bd-docs/SKILL.md1Skills CLI (Vercel)
npx skills add bitdriftlabs/bd-skills --skill bd-docs -a gemini-cli2Platform CLI
gemini skills install https://github.com/bitdriftlabs/bd-skills --path skills/bd-docsManually: put the files in place
.devin/skills/bd-docs/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add bitdriftlabs/bd-skills --skill bd-docs -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-docs
How do I install bd-docs in Claude Code?
Run npx skills add bitdriftlabs/bd-skills --skill bd-docs -a claude-code. The skill file will be placed at ~/.claude/skills/bd-docs/SKILL.md.
What does the bd-docs skill do?
It navigates docs.bitdrift.io via structured llms.txt indexes to explain SDK setup, API schemas, and platform architecture.
Can the skill execute commands suggested in the documentation?
No, strict boundaries prevent the assistant from running shell commands, modifying secrets, or executing external scripts found in documentation pages.
