bd-instrumentation — Claude Code skill: setup
This skill guides bitdrift Capture SDK setup for mobile apps and adds instrumentation for logs, network activity, screens, fields, and spans.
npx skills add bitdriftlabs/bd-skills --skill bd-instrumentation -a claude-codeWhat bd-instrumentation does
The skill identifies Android, iOS, or React Native from project files, checks whether the bitdrift Capture SDK is already present, and chooses the matching setup path. For a new integration, it adds the dependency and Logger.start(), then applies the instrumentation categories the user requests, such as log forwarding, network monitoring, screen views, TTI, fields, or spans.
It uses bd-docs for current API details and reads the relevant reference file: references/android.md, references/ios.md, or references/react-native.md. It can also review an integration and report PASS/FAIL/WARNING results for SDK setup, lifecycle timing, sessions, network and screen tracking, crash links, identity fields, and symbol mapping uploads.
When a monorepo contains files for several platforms, the target must be selected before the setup starts. That choice changes which reference and SDK checks apply.
What it helps with
- install the Capture SDK in an Android app
- configure bitdrift in an iOS project
- instrument a React Native application
- check network and screen tracking
- audit SDK initialization and symbol uploads
Example prompts for the agent
- Check this project for an existing bitdrift Capture SDK installation and configure the detected mobile platform.
- Set up bitdrift in this React Native app, then add screen tracking, network monitoring, and TTI instrumentation.
- Validate the bitdrift integration and return PASS/FAIL/WARNING results with concrete fixes.
How to install bd-instrumentation
1Skills CLI (Vercel)
npx skills add bitdriftlabs/bd-skills --skill bd-instrumentation -a claude-code2Manually: put the files in place
~/.claude/skills/bd-instrumentation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/bd-instrumentation/
1Skills CLI (Vercel)
npx skills add bitdriftlabs/bd-skills --skill bd-instrumentation -a codex2Manually: put the files in place
.agents/skills/bd-instrumentation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add bitdriftlabs/bd-skills --skill bd-instrumentation -a cursor2Manually: put the files in place
.cursor/skills/bd-instrumentation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install bitdriftlabs/bd-skills bd-instrumentation2Manually: put the files in place
.github/skills/bd-instrumentation/SKILL.md1Skills CLI (Vercel)
npx skills add bitdriftlabs/bd-skills --skill bd-instrumentation -a gemini-cli2Platform CLI
gemini skills install https://github.com/bitdriftlabs/bd-skills --path skills/bd-instrumentationManually: put the files in place
.devin/skills/bd-instrumentation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add bitdriftlabs/bd-skills --skill bd-instrumentation -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-instrumentation
How do I install bd-instrumentation in Claude Code?
Run npx skills add bitdriftlabs/bd-skills --skill bd-instrumentation -a claude-code, then open ~/.claude/skills/bd-instrumentation/SKILL.md.
What does bd-instrumentation do?
It guides Capture SDK installation and instrumentation for Android, iOS, and React Native. It also checks an existing setup against several integration requirements.
Which mobile platforms does bd-instrumentation support?
It supports Android, iOS, and React Native. Android projects may use Kotlin or Java, while iOS projects may use Swift or Objective-C.
