From hiivmind-openclaw-os
First-run setup wizard for AI Persona OS. Guides users through initial workspace configuration with preset selection (coding assistant, executive assistant, marketing assistant, or custom persona). Detects existing installations, gathers personalization context, builds workspace structure with templates, and configures SOUL.md, USER.md, and MEMORY.md files. Triggered by keywords setup, install, preset, get started, first run, fresh install, initialize, wizard, onboard, configure workspace, initial setup, persona configuration.
How this skill is triggered — by the user, by Claude, or both
Slash command
/hiivmind-openclaw-os:persona-setupThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
This skill guides users through the first-run setup of AI Persona OS, creating a personalized workspace at `~/workspace` with configured persona files.
This skill guides users through the first-run setup of AI Persona OS, creating a personalized workspace at ~/workspace with configured persona files.
The setup wizard:
~/workspace onlyUse Bash tool to check if ~/workspace exists and contains core files:
if [ -d ~/workspace ]; then
existing_files = []
for file in SOUL.md USER.md MEMORY.md; do
if [ -f ~/workspace/$file ]; then
existing_files.append(file)
fi
done
if existing_files.length > 0; then
state.workspace_exists = true
state.existing_files = existing_files
fi
fi
If state.workspace_exists == true, inform the user:
"I detected an existing AI Persona OS workspace at ~/workspace with these files: [list state.existing_files]. This setup wizard is for fresh installations. Would you like to:
Based on response:
mv ~/workspace ~/workspace.backup.$(date +%Y%m%d_%H%M%S), then continue to Phase 2If no existing workspace detected, proceed to Phase 2.
Show the user this EXACT preset selection menu (verbatim):
Welcome to AI Persona OS Setup!
Please choose a preset to get started:
1. Coding Assistant
- Helps with software development, debugging, code review
- Proactive suggestions for testing, documentation, refactoring
- Tracks projects, tasks, technical decisions
2. Executive Assistant
- Manages schedule, meetings, email drafts
- Proactive reminders, deadline tracking, priority management
- Handles correspondence, reports, strategic planning support
3. Marketing Assistant
- Content creation, campaign planning, analytics review
- Proactive content ideas, publishing reminders, trend analysis
- Social media management, SEO optimization, audience insights
4. Custom Persona
- Define your own persona name, role, and behavior
- Choose communication style and proactivity level
- Full control over personality and capabilities
Which preset would you like? (1-4)
Use AskUserQuestion to get the selection:
{
"questions": [
{
"id": "preset_choice",
"question": "Which preset would you like? (1-4)",
"default": "1"
}
]
}
Map the response:
1 → state.preset = "coding-assistant"2 → state.preset = "executive-assistant"3 → state.preset = "marketing-assistant"4 → state.preset = "custom"state.preset = "coding-assistant" (default)Store the preset in state.preset.
For presets 1, 2, or 3, gather basic personalization:
{
"questions": [
{
"id": "user_name",
"question": "What's your name?",
"default": "User"
},
{
"id": "user_nickname",
"question": "What should I call you? (nickname or preferred name)",
"default": "<same as user_name>"
},
{
"id": "user_role",
"question": "What's your professional role or title?",
"default": "Professional"
},
{
"id": "user_goal",
"question": "What's your main goal in using AI Persona OS?",
"default": "Be more productive"
}
]
}
Store responses in:
state.user_name (default: "User")state.user_nickname (default: same as user_name)state.user_role (default: "Professional")state.user_goal (default: "Be more productive")Set preset-specific defaults:
state.persona_name = "Persona"state.persona_role = "personal assistant"state.comm_style = "c" (balanced)state.proactive_level = "b" (moderate)For preset 4 (custom), gather all personalization including persona configuration:
{
"questions": [
{
"id": "user_name",
"question": "What's your name?",
"default": "User"
},
{
"id": "user_nickname",
"question": "What should I call you? (nickname or preferred name)",
"default": "<same as user_name>"
},
{
"id": "user_role",
"question": "What's your professional role or title?",
"default": "Professional"
},
{
"id": "user_goal",
"question": "What's your main goal in using AI Persona OS?",
"default": "Be more productive"
},
{
"id": "persona_name",
"question": "What would you like to name your AI persona?",
"default": "Persona"
},
{
"id": "persona_role",
"question": "What role should your persona play? (e.g., 'coding mentor', 'executive assistant', 'creative partner')",
"default": "personal assistant"
},
{
"id": "comm_style",
"question": "Choose communication style:\n a) Formal and professional\n b) Friendly and casual\n c) Balanced (professional but approachable)\n d) Technical and precise\nYour choice (a-d)?",
"default": "c"
},
{
"id": "proactive_level",
"question": "Choose proactivity level:\n a) Reactive only (wait for requests)\n b) Moderate (occasional suggestions)\n c) Highly proactive (frequent suggestions and reminders)\nYour choice (a-c)?",
"default": "b"
}
]
}
Store all responses with the same defaults as Step 3.1, plus:
state.persona_name (default: "Persona")state.persona_role (default: "personal assistant")state.comm_style (default: "c")state.proactive_level (default: "b")Use Bash tool to create the workspace directory:
mkdir -p ~/workspace/memory
mkdir -p ~/workspace/projects
mkdir -p ~/workspace/context
Based on state.preset, copy the appropriate starter pack from plugin assets:
preset_examples = {
"coding-assistant": "${CLAUDE_PLUGIN_ROOT}/examples/coding-assistant/",
"executive-assistant": "${CLAUDE_PLUGIN_ROOT}/examples/executive-assistant/",
"marketing-assistant": "${CLAUDE_PLUGIN_ROOT}/examples/marketing-assistant/",
"custom": "${CLAUDE_PLUGIN_ROOT}/examples/custom/"
}
source_dir = preset_examples[state.preset]
# Copy all files from preset example directory to ~/workspace
cp -r ${source_dir}/* ~/workspace/
Use Bash tool to execute the copy operation.
Copy shared template files that all presets need:
# Copy SOUL.md template
cp ${CLAUDE_PLUGIN_ROOT}/assets/SOUL.md.template ~/workspace/SOUL.md
# Copy MEMORY.md template
cp ${CLAUDE_PLUGIN_ROOT}/assets/MEMORY.md.template ~/workspace/MEMORY.md
Use Bash tool to execute these copy operations.
Use Bash tool with sed to personalize the copied templates:
# Personalize SOUL.md
sed -i 's/{{PERSONA_NAME}}/'"${state.persona_name}"'/g' ~/workspace/SOUL.md
sed -i 's/{{PERSONA_ROLE}}/'"${state.persona_role}"'/g' ~/workspace/SOUL.md
sed -i 's/{{COMM_STYLE}}/'"${state.comm_style}"'/g' ~/workspace/SOUL.md
sed -i 's/{{PROACTIVE_LEVEL}}/'"${state.proactive_level}"'/g' ~/workspace/SOUL.md
# Personalize MEMORY.md
sed -i 's/{{USER_NAME}}/'"${state.user_name}"'/g' ~/workspace/MEMORY.md
sed -i 's/{{USER_NICKNAME}}/'"${state.user_nickname}"'/g' ~/workspace/MEMORY.md
Execute all sed commands via Bash tool in a single call using && to chain them.
Create USER.md using a heredoc with gathered information. Use Bash tool:
cat > ~/workspace/USER.md <<'EOF'
# User Profile
## Basic Information
**Name:** ${state.user_name}
**Preferred Name:** ${state.user_nickname}
**Role:** ${state.user_role}
**Primary Goal:** ${state.user_goal}
## Workspace Context
**Preset:** ${state.preset}
**Setup Date:** $(date +%Y-%m-%d)
## Preferences
Communication Style: See SOUL.md for persona configuration
Proactivity Level: See SOUL.md for persona configuration
## Active Projects
<!-- This section will be populated as you work -->
## Important Context
<!-- Add any context the AI should always remember -->
---
*This file was generated by the AI Persona OS setup wizard. Feel free to edit and expand it.*
EOF
Substitute the actual variable values before executing.
Use Bash tool to list created files:
ls -la ~/workspace/
ls -la ~/workspace/memory/
Store the output in state.workspace_contents.
Show the user a completion message with file checklist:
✓ AI Persona OS Setup Complete!
Your workspace has been created at ~/workspace with the following structure:
Core Files:
✓ SOUL.md - Persona configuration and behavior
✓ USER.md - Your profile and preferences
✓ MEMORY.md - Persistent memory across sessions
Directories:
✓ memory/ - Session logs and historical context
✓ projects/ - Project-specific files and notes
✓ context/ - Additional context documents
Preset-Specific Files:
[List any additional files from state.workspace_contents]
Your ${state.preset} persona is ready to use!
Next Steps:
1. Review and customize SOUL.md to fine-tune persona behavior
2. Update USER.md with any additional context
3. Start a new session — your persona will load automatically
Mention advanced features as optional enhancements, never push:
"Optional advanced features you can explore later:
These are completely optional. Your setup is fully functional as-is. Would you like to hear more about any of these features, or are you ready to start using your persona?"
Based on response:
Track these variables throughout execution:
state.workspace_exists = false # true if ~/workspace detected
state.existing_files = [] # list of existing core files
state.preset = "" # selected preset slug
state.user_name = "User"
state.user_nickname = "" # defaults to user_name
state.user_role = "Professional"
state.user_goal = "Be more productive"
state.persona_name = "Persona"
state.persona_role = "personal assistant"
state.comm_style = "c" # a/b/c/d
state.proactive_level = "b" # a/b/c
state.workspace_contents = "" # ls output after creation
If template files are not found at ${CLAUDE_PLUGIN_ROOT}/assets/ or ${CLAUDE_PLUGIN_ROOT}/examples/:
If mkdir or cp commands fail with permission errors:
If user provides input that doesn't map to 1-4:
Setup is complete when:
~/workspace directory exists with correct structurenpx claudepluginhub hiivmind/hiivmind-openclaw-osOnboards users into the AI Personal OS course via a conversational interview, creating 5 personal AI environment files (CLAUDE.md, user-profile.md, course-goals.md, SOUL.md, achievements.md).
Asks 10 discovery questions to understand user needs, configures AI agent workspace files for target system, tests integrations, and implements security guardrails. Use for new agent setups.
Interactively creates WoterClip personas by gathering details, generating SOUL.md, TOOLS.md, config.yaml, updating repo config, and creating Linear labels. Triggers on /persona-create or persona requests.