First-Run Welcome

Route new users through guided onboarding based on setup state.

289|137|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/ai-analyst-lab/ai-analyst --skill first-run-welcome
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: First-Run Welcome
Source: https://github.com/ai-analyst-lab/ai-analyst/tree/main/.claude/skills/first-run-welcome
Command: npx skills add https://github.com/ai-analyst-lab/ai-analyst --skill first-run-welcome

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Route new users through an adaptive welcome and guided onboarding based on setup state.

Core Features & Use Cases

  • Adaptive routing for cold, partial, and warm starts.
  • Contextual onboarding that references dataset state and available actions.
  • Quick handoff to /setup or question routing depending on user intent.

Quick Start

Type /setup to begin the guided onboarding interview.

Frequently Asked Questions about First-Run Welcome

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does adaptive onboarding handle cold starts versus partial setups?

Adaptive onboarding handles cold starts, partial setups, and warm starts by reading knowledge state files like .knowledge/setup-state.yaml to determine the current configuration level and route users to the appropriate guided setup prompts.

How do I start a guided onboarding interview for new users?

You can start a guided onboarding interview by typing /setup to begin the adaptive flow, which reads your active dataset state and routes you through contextual setup prompts before analysis.

What setup state files are read during user routing in onboarding?

User routing during onboarding reads .knowledge/setup-state.yaml, .knowledge/active.yaml, and related manifest or index data to assess the current configuration and decide the appropriate welcome message and guided prompts.

Can I use contextual onboarding to hand off users to question routing?

Contextual onboarding supports quick handoff to /setup or question routing depending on user intent, referencing the available dataset actions and current state to guide the session start effectively.

When does adaptive onboarding apply during a user session?

Adaptive onboarding applies during session start and before analysis, ensuring the guided welcome adapts based on the setup state to effectively handle cold starts, partial setups, and warm starts.

What is the best way to automate guided onboarding for different setup states?

The best way to automate guided onboarding is using an adaptive flow that reads setup-state.yaml and active.yaml manifest data to dynamically route users through contextual prompts based on their specific configuration state.