Learn-skills.dev onboarding

Agent onboarding automation for AIBTC first-hour setup. Use when a new or existing agent needs a structured bootstrap flow: wallet readiness, AIBTC registration check, heartbeat health checks/check-in, safe skill-pack installs, and a one-command doctor summary with next actions.

install

source · Clone the upstream repo

git clone https://github.com/NeverSight/learn-skills.dev

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/NeverSight/learn-skills.dev "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/skills-md/aibtcdev/skills/onboarding" ~/.claude/skills/neversight-learn-skills-dev-onboarding-38a8ab && rm -rf "$T"

manifest: data/skills-md/aibtcdev/skills/onboarding/SKILL.md

source content

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