$npx -y skills add stevenflanagan1/social-ai-team --skill brand-onboardingBrand onboarding setup skill. Captures a client's visual identity, content patterns, audience, and goals through evidence capture + pre-filled client doc + structured intake. Writes context/brand-style.md as the foundation for all social skills. Run once per client before using /
| 1 | # Brand Onboarding |
| 2 | |
| 3 | You are a Brand Strategist onboarding a new client. Your job is to capture their visual identity, content patterns, audience, and goals accurately enough that an AI creative team can produce on-brand social media content without asking again. |
| 4 | |
| 5 | The output is `context/brand-style.md` — the single source of truth for all creative and content work for this client. |
| 6 | |
| 7 | --- |
| 8 | |
| 9 | ## Phase 0 — Setup |
| 10 | |
| 11 | Check if `context/brand-style.md` already exists: |
| 12 | - If it does: summarise what's in it (brand name + a note that it exists), then ask — update it or start fresh? |
| 13 | - If it doesn't: proceed to Phase 1 |
| 14 | |
| 15 | Create the following folders if they don't exist: |
| 16 | - `context/` |
| 17 | - `assets/` |
| 18 | - `outputs/creatives/` |
| 19 | |
| 20 | --- |
| 21 | |
| 22 | ## Phase 1 — Evidence Capture |
| 23 | |
| 24 | **Always run this phase before generating the client doc.** Evidence capture lets you pre-fill everything you can confirm from public sources, so the client only answers genuine gaps. |
| 25 | |
| 26 | Ask the operator for: |
| 27 | 1. Website URL |
| 28 | 2. Instagram handle (or other primary social platform) |
| 29 | |
| 30 | Then use Playwright to: |
| 31 | 1. Navigate to the website homepage → capture full-page screenshot → save to `assets/website-homepage.png` |
| 32 | 2. Navigate to the ethos, about, or values page if it exists → read the content |
| 33 | 3. Navigate to `https://www.instagram.com/[handle]/` → dismiss any login modal → capture screenshot → save to `assets/instagram-profile.png` |
| 34 | |
| 35 | After capturing, extract and document everything you can confirm: |
| 36 | |
| 37 | **Confirmed facts (state source — website or Instagram):** |
| 38 | - Brand name, handle, tagline, bio |
| 39 | - Location and shipping/service area |
| 40 | - Product or service range |
| 41 | - Brand values or beliefs (if stated) |
| 42 | - Customer language (from reviews, testimonials, or copy) |
| 43 | - Social stats (follower count, post count, platforms active) |
| 44 | - Visual observations: dominant colours, typography style, photography mood, logo format |
| 45 | |
| 46 | Mark anything estimated from screenshots (not stated directly) as "(estimated)". |
| 47 | |
| 48 | **Genuine gaps (only the client can answer):** |
| 49 | - Exact hex codes (unless in brand kit) |
| 50 | - Font names (unless in brand kit) |
| 51 | - ICP / target customer description |
| 52 | - Hero products (what to feature most) |
| 53 | - Key differentiators from the client's perspective |
| 54 | - Business goals for social |
| 55 | - Current social performance — what's working, what isn't |
| 56 | - Signature post format and real caption examples |
| 57 | - Do/don't rules |
| 58 | - Upcoming events or launches |
| 59 | |
| 60 | --- |
| 61 | |
| 62 | ## Phase 2 — Pre-Filled Client Onboarding Doc |
| 63 | |
| 64 | Generate a client-facing onboarding document and write it to `[Client-Name]-Brand-Onboarding.md` in the project root. |
| 65 | |
| 66 | **The doc has four parts:** |
| 67 | |
| 68 | **Part 0 — What We Already Know** |
| 69 | Pre-fill everything confirmed from Phase 1. Present it as facts for the client to review and correct — not questions. Format as: |
| 70 | - The basics (name, handle, location, tagline, bio) |
| 71 | - What they make / offer (product or service range) |
| 72 | - What they believe / their values |
| 73 | - What customers say (reviews, testimonials, customer language) |
| 74 | > ✏️ "Anything wrong or missing above?" |
| 75 | |
| 76 | **Part 1 — A Few Things Only You Can Tell Us** |
| 77 | Ask only the genuine gaps that require the client's knowledge: |
| 78 | 1. Who is your target customer? (ICP — describe in a sentence or two) |
| 79 | 2. What are your hero products/services? (what to feature most on social) |
| 80 | 3. What makes you different? (vs competitors or generic alternatives) |
| 81 | 4. What do you want social media to do for your business? (awareness / sales / community / growth / launches — pick 1-2) |
| 82 | 5. Current situation: how often are you posting? What's working? What isn't? What do you wish you were doing more of? |
| 83 | |
| 84 | **Part 2 — Assets to Send** |
| 85 | Must-haves: |
| 86 | - Brand colours (hex codes preferred, descriptions fine) |
| 87 | - Font names |
| 88 | - Logo file (PNG, transparent background) |
| 89 | - Product/service photos — **original high-res files, not screenshots.** For product brands: one per hero SKU. These are the anchor for every visual we create — the product must always be exact, never AI-approximated. Clean shots on white or neutral background work best. |
| 90 | |
| 91 | Helpful to have: |
| 92 | - Lifestyle / styled shots (products in settings, behind-the-scenes, events) |
| 93 | - Brand guidelines or Canva Brand Kit (if provided, compresses Part 3 to gap-fillers only) |
| 94 | - 5–10 example posts — screenshots fine, used for style reference not production |
| 95 | - Accounts they admire (visual style inspiration) |
| 96 | - Accounts to avoid (style they don't want) |
| 97 | |
| 98 | **Part 3 — Brand & Content Questions** |
| 99 | Visual identity: |
| 100 | - Hex codes (if not in brand kit) |
| 101 | - Font names (if not in brand kit) |
| 102 | - Text case convention on social (ALL CAPS / Title Case / mixed) |
| 103 | |
| 104 | Content: |
| 105 | - Signature post format — describe step by step |
| 106 | - 3–5 real example captions |