name: brand-style
description: >
Sets and updates the owner's brand look and output preferences, which every
page and document the plugin produces then follows automatically. Captures
the brand from a pasted website link or a plain-words description — never a
hex code, color picker, or upload — previews it on a sample page, asks how
they want their outputs delivered (visual artifacts, Word docs, markdown, Notion pages,
Canva Docs, or best-for-the-skill), and saves both to the business profile. Runs inside
smb-onboard on first setup and stands alone forever after. Use when the
owner says "update my brand," "we rebranded," "change my colors," "make the
reports match our new look," "change how you give me reports," "I want Word
docs instead," or anything about the look or format of what the plugin
hands them.
allowed-tools: Read, WebFetch
Brand Style
One place the owner controls how everything looks and how everything is
delivered. Set once during onboarding, changed any time after with one
sentence.
Step 1 — Show what is set now
Read the ## Business context block. If Brand colors, Logo, or Output
preference exist, play them back in plain words first: "Right now your pages
use a deep green and cream with your leaf logo, and you get visual pages.
What's changing?" An owner updating one thing should not re-answer the rest.
If nothing is stored yet (first run, usually inside smb-onboard), skip
straight to capture.
Step 2 — Capture the brand, frictionlessly
Two paths, both costing the owner almost nothing:
- A website link. Fetch the site (WebFetch) and pull the logo URL,
primary brand colors (from the CSS, theme, or social-preview image), and
tagline. The owner does nothing but paste the link. Guidance in
[../smb-onboard/reference/website-research.md](../smb-onboard/reference/website-research.md).
- A plain-words description. "Forest green and cream," "navy and warm
gray," "like a modern law firm." Translate the words to real colors
yourself.
Never ask for hex codes, color pickers, or file uploads. Branding costs
one pasted link or one spoken sentence, nothing more. "Skip" is always an
answer and means the clean house default.
Step 3 — Preview before saving
Render a small sample page as an HTML artifact in the house style
(../../shared/artifact-style.md) with the candidate brand applied — a
title, one stat tile, a short table, a status pill — so the owner sees the
look on real components, not a color swatch. Ask one question: "Match?"
If they adjust ("darker green," "less cream"), apply and re-preview. This
loop is cheap; a wrong brand on every future page is not.
Step 4 — Ask how outputs should arrive
The six-way choice, as a multiple choice (skip if the owner only came to
change colors and the preference is already stored):
- Visual artifacts — styled pages viewed right here (the default)
- Word docs — DOCX files to download
- Markdown — plain .md files to download
- Notion — pages created in their Notion workspace (needs the Notion connector; ask where in the workspace they should land)
- Canva — Canva Docs created in their Canva account (needs the Canva connector; if it is connected, run
list-brand-kits and ask once which brand kit to apply, or none; if not, the first skill that delivers to Canva asks) - Best for the skill — each skill picks what fits its job
Store the answer verbatim as one of: visual artifacts, docx, md,
notion, canva, best for skill. If they pick Notion or Canva and that
connector is not connected, store it anyway, say deliverables fall back to
visual artifacts until it is connected, and offer to help connect it.
Step 5 — Save, with approval
Show what will be stored — Website, Brand colors, Logo, Output preference,
and Canva brand kit (name and id) when the preference is Canva — and wait
for the yes. Then update only those fields in the
## Business context block, using the exact field names in
[../smb-onboard/reference/onboard-checklist.md](../smb-onboard/reference/onboard-checklist.md).
Never touch the other fields, and never overwrite silently.
Close with the effect, not the mechanics: "Done — every page and document
from here on uses the new look."
What not to do
- Do not ask for hex codes, pickers, or uploads. One link or one
sentence, always.
- Do not re-run the whole interview. This skill changes look and
delivery, nothing else — an owner who says "update my brand" is not
signing up for onboarding again.
- Do not save without the preview and the yes. A brand applied to every
future page deserves one confirmation.
- Do not restyle old deliverables. The change applies from now on;
never claim past documents were updated.
After the update
One line on what changed. The natural next step is seeing it live: offer
"Monday brief" (/monday-brief) or "how's the business doing?"
(business-pulse) so the first branded page arrives immediately. Never more
than three offers; never repeat one declined this session.