mcpField
O
onboarding

onboarding

github.com/aibtcdevAgent workflows11114 installsUpdated 3d ago
Repository

About onboarding

A first-hour setup skill for AIBTC agents, intended for users checking agent status and configuring skill packs. It provides repeatable diagnostics, installation, and onboarding steps with explicit wallet safety defaults.

Key features

  1. 01Check wallet and registration status
  2. 02Test heartbeat endpoint reachability
  3. 03Preview or install curated skill packs
  4. 04Run registration and heartbeat onboarding
  5. 05Return step-by-step status as JSON

Use cases

  1. 01Check a new agent's wallet and registration
  2. 02Install core or other skill packs
  3. 03Complete registration and heartbeat check-in

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/aibtcdev/skills --skill onboarding

After installing, type/onboardingin Claude Code to confirm it loaded.

Bundled filesAGENT.mdonboarding.ts

Details

From the project README

Onboarding Skill

Automates first-hour setup for AIBTC agents with practical, idempotent steps and explicit safety defaults.

Usage

bun run onboarding/onboarding.ts <subcommand> [options]

Subcommands

doctor

Run onboarding diagnostics and return actionable next steps.

Checks include:

  • wallet presence + lock status
  • AIBTC registration verification (/api/verify/<stxAddress>)
  • heartbeat endpoint reachability (/api/heartbeat?address=<btcAddress>)
  • optional community step target (https://www.moltbook.com/m/aibtc)
bun run onboarding/onboarding.ts doctor
install-packs

Preview or install curated skill packs.

Packs:

  • core: wallet, settings, signing, query, credentials
  • builder: x402, bns
  • finance: bitflow, defi (mainnet write-capable)
  • all: core + builder + finance

Preview only:

bun run onboarding/onboarding.ts install-packs --pack core

Execute install:

bun run onboarding/onboarding.ts install-packs --pack builder --run
run

Execute the first-hour onboarding flow with optional registration and heartbeat check-in.

bun run onboarding/onboarding.ts run \
  --wallet-password <password> \
  --pack core \
  --install \
  --register \
  --check-in

Options:

  • --wallet-password (optional) — auto-unlock wallet when needed (less secure: process args)
  • --wallet-password-env (optional) — environment variable name that stores wallet password (default: AIBTC_WALLET_PASSWORD)
  • --register (flag) — attempt AIBTC registration if not registered
  • --check-in (flag) — submit heartbeat check-in after diagnostics
  • --pack (optional) — core | builder | finance | all (default: core, invalid values error)
  • --install (flag) — install selected pack(s)
  • --skip-community (flag) — skip optional Moltbook /aibtc recommendation

Safety + Best Practices

  • Wallet unlock is explicit and never inferred.
  • Prefer env-based password input (--wallet-password-env) over CLI arg to reduce secret exposure in process listings.
  • Finance pack is optional and never auto-enabled by default.
  • Community step is non-blocking (safe skip if unavailable).
  • Output is JSON with step-by-step status to support autonomous loops.

Suggested First Run

# 1) Inspect current state
bun run onboarding/onboarding.ts doctor

# 2) Install safe defaults
bun run onboarding/onboarding.ts install-packs --pack core --run

# 3) Complete bootstrap
bun run onboarding/onboarding.ts run --wallet-password <password> --register --check-in

Comments

Markdown supported