# bd-docs

Retrieves and interprets bitdrift documentation for SDK setup, API endpoints, and features. Helps query official guides directly from coding assistants.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 575 installs · ★ 13
- Author: bitdriftlabs
- License: LicenseRef-PolyForm-Shield-License-1.0.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/bitdriftlabs/bd-skills/tree/HEAD/skills/bd-docs/SKILL.md
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/skills/bd-docs

## What it 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`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add bitdriftlabs/bd-skills --skill bd-docs -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/bd-docs/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/bd-docs/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add bitdriftlabs/bd-skills --skill bd-docs -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/bd-docs/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add bitdriftlabs/bd-skills --skill bd-docs -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/bd-docs/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install bitdriftlabs/bd-skills bd-docs
```

2. **Manually: put the files in place**
- File: `.github/skills/bd-docs/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add bitdriftlabs/bd-skills --skill bd-docs -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/bitdriftlabs/bd-skills --path skills/bd-docs
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/bd-docs/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add bitdriftlabs/bd-skills --skill bd-docs -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/bitdriftlabs/bd-skills/tree/HEAD/skills/bd-docs/SKILL.md

## When to use it
- 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
- /bd-docs what events does bitdrift capture automatically?
- Explain the API service methods available for symbol upload

## Similar
- [wix-docs](https://affpapa.org/en/nevibecode/skills/wix-docs.md) — skill · 561 installs
- [cloudinary-docs](https://affpapa.org/en/nevibecode/skills/cloudinary-docs.md) — skill · 993 installs
- [openai-docs-skill](https://affpapa.org/en/nevibecode/skills/openai-docs-skill.md) — skill · 1200 installs
- [stream-docs](https://affpapa.org/en/nevibecode/skills/stream-docs.md) — skill · 783 installs
- [context7](https://affpapa.org/en/nevibecode/skills/context7.md) — skill · 11200 installs
- [write-docs](https://affpapa.org/en/nevibecode/skills/tldraw-write-docs.md) — skill · 486 installs

From the same set: [bitdriftlabs/bd-skills](https://affpapa.org/en/nevibecode/by/bitdriftlabs/bd-skills.md) — 3 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
