claw-onboarding

# ClawOnBoarding 🦞

**Welcome new humans to the agent world.**

---

## When to Trigger

Activate onboarding when you detect:
- First interaction with a new user
- User asks "what can you do?"
- User seems confused about agent capabilities
- Explicit request: "onboarding", "tutorial", "help me get started"

---

## Onboarding Flow

### 1. Welcome & Identity (First Message)

```
👋 Welcome! I'm your personal AI assistant.

I can help you with almost anything:
📁 Read and write files
🔍 Search the web
💻 Run commands on your computer
📧 Send emails and messages
🧠 Remember things across conversations

Let me give you a quick tour of what's possible...
```

### 2. Power & Responsibility ⚠️

**ALWAYS cover this early:**

```
⚠️ **Important: Agents are powerful.**

I can:
- Read/modify files on your system
- Execute shell commands
- Send messages on your behalf
- Access the internet

**Good practices:**
- Review before approving risky actions
- Ask me to explain what I'm about to do
- Use `/think` to see my reasoning
- Start with small tasks, build trust gradually

I'll always ask before doing anything destructive.
```

### 3. Skills & ClawdHub

```
🎯 **Skills = New Abilities**

I can learn new skills from ClawdHub:

clawdhub search "what you need"
clawdhub install <skill-name>

Popular skills:
- `proactive-amcp` — Memory backup & resurrection
- `gog` — Google Workspace (Gmail, Calendar, Drive)
- `bird` — Twitter/X integration
- `weather` — Forecasts without API keys

Browse: https://clawhub.com
```

### 4. Solvr — Collective Knowledge

```
🧠 **Solvr = Agent Knowledge Base**

Before I ask you for help, I search Solvr for solutions.
When I solve something new, I document it for other agents.

You can help too:
- If I get stuck, the solution might help others
- I can post problems and approaches to Solvr
- Other agents (and humans) can contribute

This makes ALL agents smarter over time.

https://solvr.dev
```

### 5. Essential Commands

```
📋 **Commands You Should Kno...

# ClawOnBoarding 🦞

Welcome new humans to the agent world.

## What it teaches

1. **Agent capabilities** — What agents can do (files, web, commands, email)
2. **Safety practices** — Power comes with responsibility
3. **ClawdHub & Skills** — How to extend agent abilities
4. **Solvr** — Collective knowledge for agents
5. **Essential commands** — `/think`, `/status`, `/remember`
6. **AgentMail** — Agent-to-agent communication
7. **Memory & Continuity** — How agents remember

## Installation

```bash
clawdhub install claw-onboarding
```

## Usage

The skill auto-triggers on:
- First interaction with new user
- "What can you do?"
- "Help me get started"
- Explicit: "onboarding", "tutorial"

## Adaptive Delivery

- Doesn't dump everything at once
- Tracks progress in `memory/onboarding-state.json`
- Supports inline buttons when available

## Integration

Works with:
- `proactive-amcp` — Mentions checkpoints if installed
- `Solvr` — Encourages knowledge sharing
- `AgentMail` — Shows email if configured

---

*Part of the MeuSecretárioVirtual ecosystem*