onboarding

Guide first-time users through a structured onboarding conversation with crisis detection and profile creation.

1|1|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/yuyuxinli/moodcoco --skill onboarding-yuyuxinli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: onboarding
Source: https://github.com/yuyuxinli/moodcoco/tree/main/ai-companion/skills/onboarding
Command: npx skills add https://github.com/yuyuxinli/moodcoco --skill onboarding-yuyuxinli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Help conversational agents create a calm, trust-building first encounter with new users by providing a structured, human-paced onboarding flow that detects crisis states, reduces expression barriers, and captures minimal profile data without feeling like a form or a product tour.

Core Features & Use Cases

  • Structured 7-node onboarding flow with streaming-friendly pacing to emulate natural human response timing and sentence-level pauses.
  • Safety-first routing that detects crisis language and immediately triggers breathing-ground guidance or emergency resources, while otherwise guiding users through gentle emotion naming and multi-hypothesis interpretations of third-party behavior.
  • Practical integration points for lowering expression barriers (poll fallback), silence handling, task-oriented requests (e.g., analyze a chat snippet), and final automatic user profile creation (write USER.md and people/*.md) at session end.
  • Use case: A first-time user says "I don't know what to say"; the skill uses a poll or gentle prompts, validates trust signals, refines an emotion label, and writes a private USER.md summary when the user leaves.

Quick Start

Say "Hi, this is my first time here" to receive a warm, listening welcome and a gentle check-in that guides the conversation and records a basic profile if you say goodbye.

Frequently Asked Questions about onboarding

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

FAQPage Schema
How do I build an empathetic onboarding flow for a conversational AI agent?

To handle crisis detection during onboarding, the conversational agent performs multi-branch safety checks to identify crisis language and immediately routes the user to breathing-ground guidance or emergency resources instead of standard profile collection.

How do I lower expression barriers when first-time users don't know what to say?

For silence handling, the conversational agent uses streaming-friendly pacing with sentence-level pauses to emulate natural human response timing. This approach prevents rushed replies and reduces expression barriers during the initial onboarding conversation.

Can I automatically generate a user profile after the first onboarding session?

Automatic user profile creation is supported at session end via write-tool functionality. The agent generates a private USER.md summary and writes people/*.md files to capture minimal profile context without making the interaction feel like a data collection form.

What is the best way to route simple task-oriented requests during a mental health companion onboarding?

Routing task-oriented requests during mental health companion onboarding involves identifying user intent, such as analyzing a chat snippet, while maintaining gentle emotion checks. The agent prioritizes safety routing first before transitioning to task completion.