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'shint(the user must set their key).- The brand is already onboarded —
brand.mdexists 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 wherecompetitors.mdis 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 tellanalyzing-brandto re-analyze, and where it is a different brand, replacebrand.mdandcompetitors.mdrather than patching or merging them — the old brand's proof, voice and competitors must not carry over. - The site can't be read —
analyzing-brandreports 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.
