agent-onboarding

Installation
SKILL.md

Bright Data - Start Here

Install the CLI and the skills, log in once, then route to the task skill.

Never ask the user to paste an API key into chat. Login is one browser approval. The key never touches the conversation.

Already set up?

Three free checks before doing any work:

  1. bdata --version works: skip to Add the skills.
  2. Pick the skill from the route table below (Route to the task skill), then run node <this skill's folder>/scripts/check-auth.mjs --for <skill> (scripts/check-auth.mjs). The path is relative to this skill's folder, not to the project: a "Cannot find module" error means a wrong path, never a login problem. One free call, and the exit code is the answer: 0 ready, go to that skill. 2 means log in. 3 means the key was never tested (network or server), so fix that instead of logging in. 1 means the key works but the account has no zone of the type that skill needs, which is one free call (in Log in below), never another login. 4 means bad usage: a --for value that is not a skill name from the route table, or a BRIGHTDATA_API_BASE that is not an https brightdata.com host. Fix the command; nothing about the account. Zone names do not matter: they differ by how the account was set up, and the script matches by type.
  3. The skill folders already exist in the project: the skills are installed, so skip Add the skills entirely rather than running the installs again.

Check 1 passes but check 2 answers logged out: go to Log in. On Windows, "bdata is not recognized" can also mean installed but not on PATH - apply the PATH fix in Install before reinstalling. In Windows PowerShell, bdata.ps1 cannot be loaded because running scripts is disabled on this system means the CLI is installed but the default execution policy blocks npm's PowerShell shims. Run bdata.cmd and npm.cmd instead (the same fix as npx.cmd under Add the skills), or ask the user to run Set-ExecutionPolicy -Scope CurrentUser RemoteSigned.

Install

Installs
849
GitHub Stars
272
First Seen
Apr 26, 2026