# Lev Onboarding > First-run setup wizard for Lev — prereqs, XDG scaffolding, config, smoke validation, handoff to /work. - Skill: `lev-os/lev-onboarding` (Agent Skill) - Install (CLI): `npx skillmds@latest add lev-os/lev-onboarding` - Raw SKILL.md: https://api.skillmd.com/api/skills/lev-os/lev-onboarding/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: lev-os (https://skillmd.com/u/lev-os) - Updated: 2026-09-10 - Page: https://skillmd.com/skills/lev-os/lev-onboarding --- # lev-onboarding First-run setup wizard for Lev — prereqs, XDG scaffolding, config, smoke validation, handoff to /work. Takes a human or coding-agent from zero to a working Lev install. Absorbs the hm-01 setup wizard pattern from hermes and the oc-02 onboarding wizard pattern from openclaw into a single Lev-specific surface, replacing the prior deferrals that had no valid home under /agent-field-kit's generic remote-access charter. ## Quick Start ```bash lev exec --flow lev-onboarding ``` ## Source of Truth - dna/skills/lev-onboarding.intent.yaml - dna/core/onboarding.dna.yaml - docs/ARCHITECTURE.md (XDG Directory Map) ## Steps 1. Run prereq-check: verify git, bun, pnpm, and writable XDG paths 2. Install or verify Lev CLI surface via core/poly (idempotent) 3. Scaffold XDG dirs: ~/.config/lev, ~/.local/share/lev, ~/.local/state/lev, ~/.cache/lev 4. Write default settings.yaml and reactive/hooks.yaml under $XDG_CONFIG_HOME/lev 5. Run smoke test: lev doctor plus one canonical flow execution 6. Emit lev.onboarding.* LevEvents for each step (visible on event bus) 7. Hand off to /work with a pre-filled tracked session for the first piece of real work ## Done Condition - Criteria: lev doctor returns exit 0 AND at least one flow executes end-to-end AND first /work session is tracked - Metric: prerequisite_check_passes - Metric: xdg_paths_created - Metric: default_config_written - Metric: first_flow_execution_ok - Metric: first_work_session_tracked