# Onboarding

> First-run user onboarding. Asks 6 quick questions, detects the project, writes USER_PROFILE.json, and recommends the right setup tier. Auto-activates on first use or when the user says 'set me up', 'I'm new', or runs /onboard.

- **Type:** Skill
- **Install:** `agentstack add skill-shivae372-claude-bootstrap-onboarding`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [shivae372](https://agentstack.voostack.com/s/shivae372)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [shivae372](https://github.com/shivae372)
- **Source:** https://github.com/shivae372/claude-bootstrap/tree/master/.claude/skills/onboarding

## Install

```sh
agentstack add skill-shivae372-claude-bootstrap-onboarding
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

## Purpose
Collect just enough about the person and their project to tailor the Claude Code setup, then
write `USER_PROFILE.json` and route to the right tier (developer / hybrid / non-dev).

## When To Use This
- The user runs `/onboard`, says they're new, or asks to be set up
- No `USER_PROFILE.json` exists yet and the user wants `/bootstrap`

## Steps

### 1. Greet briefly
> "I'll ask 6 quick questions so Claude Code fits how YOU work — about 2 minutes, once."

### 2. Ask the 6 questions ONE AT A TIME (wait for each answer)
1. **Role** — developer, founder, designer, PM, data, student, other?
2. **Comfort with code/terminal (1–5)** — 1 = avoid the terminal … 5 = senior engineer.
3. **Team** — solo / small (2–5) / larger?
4. **Domain** — software / design / ops / marketing / research / other?
5. **Top 1–3 goals** — e.g. "ship faster", "automate reports", "learn to code".
6. **Success in 30 days** — one sentence.

### 3. Detect the project (no interaction)
```bash
python3 .claude/skills/onboarding/scripts/detect-project.py --target . --output /tmp/detected.json
```
If it fails, treat detection as `{"has_project": false}`.

### 4. Write the profile
```bash
echo '' | python3 .claude/skills/onboarding/scripts/write-profile.py \
  --detected /tmp/detected.json --output USER_PROFILE.json
```
`` keys: `role_type`, `tech_level` (int 1–5), `team_size` (solo|small|large),
`domain`, `primary_goals` (array), `success_in_30_days`.

### 5. Recommend the tier
Read `generation_tier` from `USER_PROFILE.json` and tell the user which tier fits, then point
them to `/bootstrap` (or to `bash install.sh --tier ` if they prefer the deterministic path).

## Output
Writes `USER_PROFILE.json` and prints a short summary (role, tech level, tier, detected stack).

## Notes
- If a profile already exists, ask whether to update or keep it — never silently overwrite.
- If an answer is ambiguous, ask one quick follow-up rather than guessing.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [shivae372](https://github.com/shivae372)
- **Source:** [shivae372/claude-bootstrap](https://github.com/shivae372/claude-bootstrap)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-shivae372-claude-bootstrap-onboarding
- Seller: https://agentstack.voostack.com/s/shivae372
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.