setup

What it does and when to use it

Run first-time Dex onboarding: build the vault structure, capture the user profile and configure MCPs. Use when `System/.onboarding-complete` is absent or the user says 'set up Dex', 'start onboarding'. Not for the post-onboarding tour; use `getting-started`. Not for a mid-life role change; use `reset`.

Triggers from the description

How it works

SKILL.md has no level-two headings · 26 lines, 158 words

---
name: setup
description: "Run first-time Dex onboarding: build the vault structure, capture the user profile and configure MCPs. Use when `System/.onboarding-complete` is absent or the user says 'set up Dex', 'start onboarding'. Not for the post-onboarding tour; use `getting-started`. Not for a mid-life role change; use `reset`."
---

# Set Up Dex

If `System/.onboarding-complete` already exists, setup is complete. Use `getting-started` for the
post-onboarding tour or `reset` for a role or preference change.

One narrow existing-vault repair is allowed: if setup is complete but
`System/.dex/harness-profile.json` is missing or Doctor says agent harness capabilities are
OFF, do not restart onboarding. Call `inspect_harnesses`, show the automatic / on-demand /
guided / unavailable preview and each host's named limits, ask the person to confirm one or more harnesses, then call
`save_harness_selection(..., confirmed=true)`. That tool writes only the harness receipt
through the sanctioned provision transaction and leaves the profile, content and onboarding
marker unchanged.

Otherwise:

1. Call `start_onboarding_session()` from `onboarding-mcp` to initialize or resume
   the session.
2. Read `core/onboarding/FLOW.md` and follow it as the single source of the
   onboarding conversation.

This file deliberately contains no question script, so onboarding cannot fork.
Change onboarding in `core/onboarding/FLOW.md` and `onboarding-mcp`, then regenerate
the byte-identical `.claude/flows/onboarding.md` compatibility copy; never fork the
question script here.

Versions

Database snapshot: 13.11.2026 · package version dab045dba9a6 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

• 90reset
  Re-run the setup questions over an existing Dex vault when preferences or setup answers changed, without losing data. Use when the user says 'restructure my Dex', 'redo my setup', 'my pillars are wrong now'. Not for a job or role change; use `change-job` — it runs this same…
• 100dex-add-mcp
  Add a known MCP server to config using Dex-safe user scope. Use when the user has server details in hand and says 'add this MCP', 'register this server'. Not for discovering/installing from a marketplace; use `integrate-mcp`. Not for building one; use `create-mcp`.
• 100onboarding
  Sets up this agentic OS for one user and one company in about 15 minutes, then offers to build a first job. Use when the user says "get me started", "set me up", "I'm new here", or when 0_User/01_Overview.md doesn't exist yet.
• 86team-shinchan:setup
  Use when you need first-time installation onboarding or a plugin health check.
• 100agent-dex
  Collect specialized agent types from past agent runs and save them for reuse - mine the Grimling run log (~/.claude/grimling/runs/*.jsonl and the older ~/.claude/grimling/runs.jsonl) and this conversation's agent briefs for specialized roles, propose new agent definitions with a…
• 100pa-onboarding
  Step-by-step onboarding guide for setting up a new AI Personal Assistant on OpenClaw. Use when: a new PA is being created, someone asks how to set up an agent, or guiding a user through the full setup process from account creation to first response.