---
name: onboarding-user
description: Onboards a new user — sets up their brand for the first time from their website. Analyzes the brand, finds its competitors, and saves both to the company profile that every later session reads from. Use when the user wants to onboard, get started, or set up their brand or company profile. Not for just analyzing a brand from its website — that is analyzing-brand.
license: Apache-2.0
metadata:
  version: "0.2.0"
  category: creative
  summary: "Sets your brand up from one link. Give it your website and it works out who you are — your voice, your audience, what you sell — finds who you compete with, and writes both where every future session will find them."
---

# Onboarding

Turn one website into a working brand profile, then hand the user their first next steps.

## Workflow

### Step 1: Get the website

First read `brand.md` in `./supercmo-company`: where it already holds a brand, follow "The brand is
already onboarded" below. Otherwise ask for the user's website, unless the conversation already
carries it.

A user with no website still onboards. Ask what the brand is called, what it sells, and who buys it — plus anything they want to add about how it sounds or what sets it apart. A short answer is fine; they can give as much or as little as they like. Write what they give into the matching sections of `brand.md` in `./supercmo-company`, leave the sections they didn't cover marked `unconfirmed — needs user input`, then skip the rest of the steps.

### Step 2: Analyze the brand

First load everything the next two steps use **in one step**: `analyzing-brand`, its
`references/reading-the-brand.md`, and `identifying-competitors` — not one after another.

Then trigger the `analyzing-brand` skill in quick mode with the website, and say onboarding is running
it, so it asks the user nothing and skips its own hand-over. It writes `./supercmo-company/brand.md` itself. Don't copy or re-save it; read it back where you need its contents for the summary.

### Step 3: Identify the competitors

Trigger the `identifying-competitors` skill with the brand's name, website and what it sells. **Say the run skips confirmation and that onboarding is running it**, so it saves the shortlist without
pausing and skips its own hand-over. It writes `./supercmo-company/competitors.md` itself. Don't copy or re-save it.

### Step 4: Show what was written

**One summary for the whole run.** Compact — not the files read back:

- The brand: its name and what it sells, in a line.
- The voice, in a sentence.
- The audience, as the site evidenced it.
- The competitors, as a plain list.
- Where a section stayed unconfirmed, what the site didn't show — in one line.

**Ask the user nothing.** The profile is complete as written and the competitors are your pick; don't
call them a draft or unconfirmed, and don't ask for corrections. Say they can change anything on the
Brand page, or by telling you. Where they do, apply each change directly to the file in `./supercmo-company`. **Corrections are edits** — patch the section that changed. Don't re-analyze the site, and don't re-run the sub-skill, to apply a correction.

### Step 5: Suggest what to do next

Close with this list:

- **Create a UGC video** — a creator-style video for your product.
- **Create a product ad video** — a produced ad or commercial for your product.
- **Generate product photos** — packshots and lifestyle shots from one product photo.
- **Research competitor ads** — what's working in your category, and what nobody runs.

## Edge cases

- **`error: "no_provider_configured"`** on any tool → relay the tool's `hint` (the user must set their key).
- **The brand is already onboarded** — `brand.md` exists in `./supercmo-company` → don't re-run the analysis and don't ask anything. Summarize what is stored, say it can be changed on the Brand page, and close with Step 5's list. Still run Step 3 where `competitors.md` is missing: a half-finished onboarding gets completed, not restarted. Run it again only for a different website, or where the user asks to redo it. Then tell
`analyzing-brand` to re-analyze, and where it is a different brand, replace `brand.md` and
`competitors.md` rather than patching or merging them — the old brand's proof, voice and competitors
must not carry over.
- **The site can't be read** — `analyzing-brand` reports a failed read, a site that won't load, or a site that gave nothing usable → stop there; don't run Step 3, and don't guess the brand from its name. Ask once for a working URL, and say they can instead describe the brand (Step 1's no-website case).
- **A sub-skill runs but finds nothing** — the competitor search names nobody → carry on with the steps that can run, say plainly what is missing, and still give the summary and the next steps.
- **The user asks to skip** → stop, and say the brand can be set up any time by asking. Don't leave a partial profile behind.