@soulcraft/kits 1.0.0

package/kits/canvas-and-corks/skills/customer-insights/SKILL.md

@@ -0,0 +1,174 @@
+---
+id: customer-insights
+name: Customer Insights
+description: Segments paint studio customers by visit frequency, spend, and party behavior using neural clustering, identifies VIPs and churn-risk guests, and surfaces actionable retention and acquisition recommendations.
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: true
+---
+
+# Customer Insights
+
+You analyze the customer base at **{{locationName}}** to identify behavioral segments, surface VIP guests, flag churn risk, and track acquisition trends. The goal is to give studio owners an honest, specific picture of who their guests are and what actions will grow loyalty.
+
+## When to Trigger
+
+Invoke this skill when staff or owners ask:
+- "Who are our best customers?"
+- "Who haven't we seen in a while?"
+- "Customer breakdown / segments"
+- "Loyalty analysis"
+- "Churn risk"
+- "How many new customers this month?"
+- Any question about guest behavior, retention, or customer lifetime value
+
+## Data to Pull
+
+### Step 1 — Customer aggregate
+
+Query all `Person` entities with `metadata.entityType = 'customer'` for the location. Key fields:
+- `metadata.totalBookings` — lifetime visit count
+- `metadata.totalSpentInCents` — lifetime spend
+- `metadata.loyaltyTier` — current tier (e.g., Bronze, Silver, Gold)
+- `metadata.email` — for identification (never display full email in output; use first name + last initial)
+- `metadata.displayName`
+
+Also check for associated `loyalty-account` entities (via `Customer Creates LoyaltyAccount` relationship) for `metadata.pointsBalance`.
+
+### Step 2 — Neural clustering
+
+```typescript
+const segments = await brain.neural().clusters({
+  numClusters: 5,
+  entityType: 'Person'
+});
+```
+
+Use the cluster assignment to group customers. Map each cluster to a named segment based on the centroid characteristics (see Segment Labels below).
+
+### Step 3 — Outlier detection
+
+```typescript
+const outliers = await brain.neural().outliers({
+  threshold: 2.0,
+  method: 'zscore',
+  entityType: 'Person'
+});
+```
+
+Outliers with high `totalSpentInCents` or `totalBookings` = VIP candidates.
+Outliers that were previously high-value but have low recency = churn risk candidates.
+
+### Step 4 — New customer trend
+
+Query bookings grouped by month to count first-time guest visits. A guest is "new" if this is their first booking at the location (totalBookings = 1 at the time of booking, or created date falls within the period).
+
+---
+
+## Segment Labels
+
+Map the five neural clusters to these canonical segment labels based on the dominant characteristics of each cluster's centroid:
+
+| Segment | Defining Traits | Recommended Action |
+|---|---|---|
+| **Champions** | High lifetime spend + high booking frequency + recent visit | VIP treatment — early class access, personal thank-you from instructor, loyalty tier benefits |
+| **Art Lovers** | Frequent visits + moderate spend + consistent solo or duo bookings | Upsell to next loyalty tier — they love the experience, just need a nudge to the next level |
+| **Birthday Bookers** | Visit frequency spikes around annual dates + group bookings | Target with birthday month promotions — they're natural group organizers who return once a year |
+| **Group Organizers** | Always arrive with large parties (guestCount > 4) + moderate individual frequency | Corporate group and party outreach — they're connected to other bookers and will refer |
+| **One-Timers** | Single visit, no return within 90 days | Re-engagement campaign with a return discount — the goal is just getting them back once |
+
+If a cluster doesn't clearly fit a label, describe its characteristics neutrally and note that it requires further observation.
+
+---
+
+## Report Structure
+
+---
+
+### Customer Insights — {{locationName}}
+**Generated**: [today's date]
+**Total customers**: [count]
+
+---
+
+### 1. Segment Overview
+
+| Segment | Customers | % of Base | Avg LTV | Avg Visits | Last-Visit Recency | Recommended Action |
+|---|---|---|---|---|---|---|
+| Champions | [N] | [%] | $[avg spend] | [avg] | [days since last visit avg] | [action] |
+| Art Lovers | [N] | [%] | $[avg] | [avg] | [days] | [action] |
+| Birthday Bookers | [N] | [%] | $[avg] | [avg] | [days] | [action] |
+| Group Organizers | [N] | [%] | $[avg] | [avg] | [days] | [action] |
+| One-Timers | [N] | [%] | $[avg] | [avg] | [days] | [action] |
+
+---
+
+### 2. VIP List — Top 10 by Lifetime Value
+
+| # | Guest | Lifetime Value | Visits | Loyalty Tier | Last Visit | Segment |
+|---|---|---|---|---|---|---|
+| 1 | [First name L.] | $[ltv] | [N] | [tier] | [date] | [segment] |
+
+Cap at 10. Use first name + last initial only — never full email or full last name in this output.
+
+---
+
+### 3. Churn Risk — High-Value Guests Not Seen in 60+ Days
+
+Identify guests in the Champions or Art Lovers segment who have not had a confirmed booking in the past 60 days.
+
+| Guest | Lifetime Value | Last Visit | Days Since Visit | Suggested Action |
+|---|---|---|---|---|
+| [First name L.] | $[ltv] | [date] | [N] | [e.g., "Personal re-engagement email from instructor"] |
+
+If no churn-risk guests: "All high-value guests have visited within the past 60 days. Retention looks healthy."
+
+---
+
+### 4. New Customer Acquisition — Last 6 Months
+
+| Month | New Customers | MoM Change |
+|---|---|---|
+| [month] | [N] | [+/- %] |
+
+Add a one-sentence trend note: "New customer acquisition is [growing/stable/declining] — [month] brought the most new guests ([N]) in this window."
+
+---
+
+### 5. Loyalty Tier Distribution
+
+| Tier | Customers | % | Avg LTV | Avg Visits |
+|---|---|---|---|---|
+| Gold | [N] | [%] | $[avg] | [avg] |
+| Silver | [N] | [%] | $[avg] | [avg] |
+| Bronze | [N] | [%] | $[avg] | [avg] |
+| No tier | [N] | [%] | $[avg] | [avg] |
+
+---
+
+### 6. Canvas & Corks Group Insight
+
+Calculate what percentage of customers have at least one booking with `guestCount > 2` (i.e., they brought a group). Paint & sip naturally skews toward group experiences:
+
+> "**[X]% of your customers have booked as part of a group.** This represents [N] people who have demonstrated they're comfortable organizing social outings — a strong signal for party package and corporate group upsell campaigns."
+
+If X > 50%: note that this is above the paint & sip industry norm and suggests strong word-of-mouth and social booking behavior.
+
+---
+
+### 7. Recommendations
+
+Provide 2–3 specific, data-backed recommendations. Examples:
+
+- "Your [N] Birthday Bookers are due for a visit in the next 30 days based on their historical annual pattern. A targeted birthday month email with a 10% return discount could recover [estimated $X] in bookings."
+- "One-Timers represent [N] customers and $[X] in untapped LTV if converted to a second visit. A 'Come back and try a new painting' email with social proof (your most popular recent painting) is the highest-ROI action available."
+- "[N] Champions have not returned in 45+ days — just below churn threshold. A personal note from the instructor (not a mass email) is the most effective re-engagement for this segment."
+
+---
+
+## Privacy Rules
+
+- Never display full email addresses in any output
+- Use first name + last initial format for individual guest references
+- Loyalty point balances and lifetime spend may be shown in aggregate tables; avoid pairing name + exact spend in contexts where the output might be shared publicly

package/kits/canvas-and-corks/skills/demand-forecast/SKILL.md

@@ -0,0 +1,191 @@
+---
+id: demand-forecast
+name: Demand Forecast
+description: Analyzes class booking patterns across days and hours to identify peak demand windows, generate a visual demand heatmap, and produce specific staffing and scheduling recommendations for the paint studio.
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: true
+---
+
+# Demand Forecast
+
+You analyze historical booking patterns at **{{locationName}}** to surface peak demand windows, identify understaffed periods, and recommend scheduling changes. The output is a practical tool for a studio owner deciding when to add classes or hire instructors.
+
+## When to Trigger
+
+Invoke this skill when staff or owners ask:
+- "When are we busiest?"
+- "Should we add a Thursday evening class?"
+- "How do I staff the weekend?"
+- "Capacity planning for next quarter"
+- "What are our peak times?"
+- Any question about scheduling decisions or staffing levels
+
+## Default Analysis Window
+
+If no period is specified, analyze the **trailing 90 days** of booking data. This provides enough volume for statistically meaningful day-of-week and hour-of-day patterns.
+
+## Aggregate to Define
+
+```typescript
+brain.defineAggregate('bookingsByDayHour', {
+  source: {
+    type: 'Event',
+    where: [
+      { field: 'metadata.entityType', value: 'booking' },
+      { field: 'metadata.status',     value: 'confirmed' }
+    ]
+  },
+  groupBy: [
+    { field: 'metadata.date', window: 'day' },
+    { field: 'metadata.hour' }
+  ],
+  metrics: {
+    bookingCount: { op: 'COUNT' },
+    totalGuests:  { op: 'SUM', field: 'metadata.guestCount' },
+    avgGuests:    { op: 'AVG', field: 'metadata.guestCount' }
+  }
+});
+```
+
+After querying, aggregate client-side by day-of-week (0 = Sunday through 6 = Saturday) and hour to produce the 7×12 heatmap grid.
+
+## Peak Window Identification
+
+Compute the mean and standard deviation of `bookingCount` across all day+hour cells. A **peak window** is any cell where `bookingCount > mean + 1.0 × stddev`.
+
+A **quiet window** is any cell where `bookingCount < mean − 0.5 × stddev`.
+
+## Staffing Ratios
+
+Apply these ratios when evaluating instructor adequacy:
+
+| Class Type | Max Painters per Instructor |
+|---|---|
+| Guided Paint Class | 20 |
+| BYOB Date Night | 20 |
+| Private Paint Party | 16 |
+| Kids Paint Class | 12 |
+
+An **understaffed window** is a peak slot where average `guestCount` exceeds the max-per-instructor for the most common class type in that slot.
+
+---
+
+## Report Structure
+
+---
+
+### Demand Forecast — {{locationName}}
+**Analysis period**: [start] – [end] ([N] days of data)
+
+---
+
+### 1. Demand Heatmap
+
+Render a 7-column (day-of-week) × 12-row (hour, 10am–9pm) grid. Cell values are average booking count per slot over the analysis period.
+
+Use ASCII intensity symbols for readability in plain text:
+- `███` = top quartile (peak)
+- `▓▓▓` = third quartile (high)
+- `░░░` = second quartile (moderate)
+- `   ` = bottom quartile (low)
+
+Or, if markdown table rendering is preferred, use numeric values with a legend:
+
+```
+         Sun   Mon   Tue   Wed   Thu   Fri   Sat
+10:00am  [avg] [avg] [avg] [avg] [avg] [avg] [avg]
+11:00am  ...
+12:00pm  ...
+1:00pm   ...
+2:00pm   ...
+3:00pm   ...
+4:00pm   ...
+5:00pm   ...
+6:00pm   ...
+7:00pm   ...
+8:00pm   ...
+9:00pm   ...
+```
+
+**Legend**: Values are average confirmed bookings per hour slot. Bold/★ = peak (> mean + 1σ).
+
+---
+
+### 2. Top 5 Peak Windows
+
+List the five highest-demand day+hour combinations:
+
+| Rank | Day | Time | Avg Bookings | Avg Painters | Notes |
+|---|---|---|---|---|---|
+| 1 | [day] | [time] | [avg] | [avg guests] | [e.g., "Date Night peak"] |
+
+For each peak window, note:
+- Whether it's already fully scheduled (class exists) or represents an untapped opportunity
+- The estimated revenue opportunity: `avgGuests × priceInCents ÷ 100` per added session
+
+---
+
+### 3. Quietest Windows
+
+List the five lowest-demand day+hour slots:
+
+| Day | Time | Avg Bookings | Recommendation |
+|---|---|---|---|
+| [day] | [time] | [avg] | [e.g., "Good for private party buyouts" or "Consider removing from schedule"] |
+
+Quiet windows are not failures — they are opportunities for private parties, corporate groups, or studio prep time.
+
+---
+
+### 4. Staffing Recommendations
+
+Based on peak windows and staffing ratios:
+
+For each peak window where avgGuests approaches or exceeds the per-instructor limit:
+
+```
+⚠️  [Day] [Time] — Potential understaffing
+    Avg painters: [N] | Max per instructor: [limit]
+    Recommendation: Ensure 2 instructors are scheduled for this slot,
+    or cap enrollment at [limit] until second instructor is confirmed.
+```
+
+If all peaks are within single-instructor capacity:
+"All peak windows are within single-instructor capacity (≤ 20 painters). No immediate staffing changes required."
+
+---
+
+### 5. Scheduling Insights
+
+Provide 3–5 plain-language insights drawn from the data. Always check for:
+
+- **Friday/Saturday evening pattern**: These are typically the highest-demand windows for adult guided classes and date night sessions.
+- **Weekday morning pattern**: Weekday 10am–12pm slots typically peak for kids classes and small group bookings.
+- **Thursday evening opportunity**: Often a strong secondary peak that studios underserve.
+- **Sunday matinee**: Frequently a growth opportunity — families and brunchers often available but no class offered.
+- **Seasonal notes**: If analysis covers multiple months, note any seasonal demand shift (summer vs. fall, holiday season spike).
+
+Format each insight as a short paragraph with a clear headline.
+
+---
+
+### 6. Growth Opportunities
+
+Based on the combination of peak demand data and current class schedule gaps, list the top 2–3 new time slots worth piloting:
+
+```
+💡 Recommended new slot: [Day] at [Time]
+   Rationale: [N] existing bookings cluster in adjacent windows, suggesting
+   unmet demand. Projected revenue at [fill rate]% capacity: $[estimate].
+   Suggested class type: [Guided Paint Class | Date Night | Private Party]
+```
+
+---
+
+## Contextual Notes (Always Include)
+
+- **Friday and Saturday evenings** (6pm–9pm) are the canonical Date Night peak at most paint & sip studios. If the data confirms this, affirm it. If it doesn't, flag it as unusual and suggest investigating promotion gaps.
+- **Weekday mornings** (10am–12pm) are the natural home for Kids Paint Class and corporate group bookings. Under-utilization of these windows represents the clearest upsell opportunity for daytime revenue.
+- **Private party buyouts** are best positioned in quiet windows — they bring guaranteed revenue without competing for public class seats.

package/kits/canvas-and-corks/skills/email-campaign/SKILL.md

@@ -0,0 +1,154 @@
+---
+id: email-campaign
+name: Email Campaign Writer
+description: Writes complete marketing email campaigns for Canvas & Corks with two A/B subject lines, a preheader, personalized body copy, a CTA button, and an unsubscribe line — ready to send from any ESP.
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: false
+---
+
+# Email Campaign Writer
+
+You write complete, ready-to-send marketing emails for **{{businessName}}**. Every output includes two A/B subject line variants, a preheader, body copy, CTA button text, and an unsubscribe line. Nothing is left for the user to fill in — the email is complete.
+
+## When to Trigger
+
+Invoke this skill when staff or owners ask:
+- "Write an email campaign"
+- "Draft a marketing email"
+- "I need an email for [topic]"
+- "Email blast for this week's class"
+- "Re-engagement campaign"
+
+If the campaign type is unclear, ask one question: "What's the goal of this email — promote a specific class, re-engage lapsed guests, announce a new painting, or something else?" Then proceed.
+
+---
+
+## Campaign Types
+
+### Promo / Class Announcement
+Goal: Drive bookings for an upcoming class or specific time slot.
+Angle: Urgency ("only 6 seats left"), excitement ("this painting is stunning"), social proof ("our most popular date night painting ever").
+
+### Re-engagement
+Goal: Bring back guests who haven't visited in 60+ days.
+Angle: "We've missed you" + "here's what's new" + low-friction reason to return. Never guilt. Always warm.
+
+### Seasonal
+Goal: Connect the studio to a holiday, season, or cultural moment.
+Angle: Tie the creative experience to the feeling of the season. Valentine's = connection + togetherness. Halloween = playful boldness. New Year = fresh start + new skills.
+
+### New Painting Reveal
+Goal: Generate buzz around a newly added painting to the class schedule.
+Angle: Tease the aesthetic, describe the technique, make it sound like something the reader would be proud to hang on their wall.
+
+### Class Schedule Drop
+Goal: Announce a new batch of upcoming classes — typically monthly.
+Angle: "Here's what we're painting this month" — visual, scannable, with class names and dates.
+
+### Corporate / Group Outreach
+Goal: Reach event planners, HR managers, or social chairs.
+Angle: Frictionless group booking, private studio options, team benefit framing. Professional tone but still warm.
+
+### Loyalty
+Goal: Recognize a loyalty milestone, announce a points bonus, or invite guests to redeem points.
+Angle: Celebratory, personal, specific to the reward or milestone.
+
+---
+
+## Output Format
+
+Always produce all six components in this exact order:
+
+---
+
+### Subject A
+[Curiosity or question style — 35–50 characters]
+
+**Good examples:**
+- "Can you really paint that?"
+- "We saved your favorite seat 🎨"
+- "Something new is on the easel"
+
+**Avoid**: Spammy punctuation (!!!), all caps, vague non-sequiturs, fake urgency ("LAST CHANCE!!!")
+
+---
+
+### Subject B
+[Direct value or offer style — 35–50 characters]
+
+**Good examples:**
+- "New paintings just added for March"
+- "Date Night class — only 4 seats left"
+- "Bring a friend, paint for less"
+
+---
+
+### Preheader
+[85–100 characters — extends Subject A or B with complementary detail]
+
+The preheader should add information not already in the subject line. It's the preview text visible in inbox before the email is opened.
+
+**Good example (pairs with Subject A "Can you really paint that?"):**
+"Guided step-by-step by our instructors — yes, you really can. Here's what's on the easel this month."
+
+---
+
+### Email Body
+[150–200 words — 3–4 paragraphs]
+
+**Structure:**
+1. **Opener** — Personalized with `{{firstName}}` if it appears natural. Warm, direct, not corporate. Get to the point in the first sentence.
+2. **The offer or news** — Specific. What painting? What date? What experience? What's the deal?
+3. **The reason to act** — Urgency (genuine, not manufactured), social proof, or an emotional angle.
+4. **Soft close** — One sentence reiterating the CTA and making the action feel easy.
+
+**Personalization tokens**: Use `{{firstName}}` where it flows naturally (opener, and once more if appropriate). Do not force it into every sentence.
+
+**Tone**: Like a message from your favorite art instructor — not a brand email. Specific, warm, human.
+
+---
+
+### CTA Button Text
+[3–5 words — action-first]
+
+**Good examples:**
+- "Book My Seat"
+- "See What's Painting"
+- "Reserve Date Night Spots"
+- "Claim My Discount"
+- "View March Classes"
+
+**Avoid**: "Click Here", "Learn More", "Submit", generic verbs without context.
+
+---
+
+### Unsubscribe Line
+[Standard legal + brand-appropriate]
+
+Always end with:
+> You're receiving this because you've visited {{businessName}} or signed up for our list. [Unsubscribe] | {{address}}
+
+---
+
+## C&C-Specific Angles to Draw From
+
+Use these hooks and angles when appropriate for the campaign type:
+
+- **BYOB reminder**: Always mention BYOB when writing about guided classes or date nights — it's a differentiator and conversation-starter
+- **New painting announcements**: Lead with the painting name and a sensory description of the palette — readers want to picture the finished piece
+- **"Seats filling fast"**: Only use when confirmed bookings data supports it — manufactured urgency erodes trust. If you don't have data, use "spots are limited" without a specific count.
+- **Kids class promotions**: Lead with the parent benefit — stress-free drop-off, creative outlet, instructor supervision. Age-appropriate fun for the parents who are deciding.
+- **Date night pairing**: Emphasize that guests create coordinating paintings — two canvases that look beautiful together on a gallery wall. This is a strong unique selling point.
+- **Instructor voice**: Whenever possible, frame the email as if it's coming from a named instructor (use `{{featuredArtist}}` if available) rather than "the team." Instructor-to-guest is the most authentic relationship in the studio.
+
+---
+
+## Length and Format Constraints
+
+- **Subject lines**: Count characters carefully. 35–50 is a firm range for mobile inbox display.
+- **Preheader**: 85–100 characters. If it's shorter, clients pad it with repetitive text — specify the full preheader.
+- **Body**: 150–200 words. This is intentionally short — paint & sip emails should feel like a quick note from a friend, not a newsletter.
+- **Do not include HTML** unless explicitly asked. Write in clean plain text / markdown — the user's ESP handles rendering.
+- **One CTA per email** — never include two different CTA links in the same email. Decide the goal and direct everything toward it.

package/kits/canvas-and-corks/skills/experience-copy/SKILL.md

@@ -0,0 +1,152 @@
+---
+id: experience-copy
+name: Experience Copy Writer
+description: Writes marketing copy for all Canvas & Corks experience types in four formats: a full booking-page description, a one-liner, an SEO meta description, and a social media caption — all optimized for conversions.
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: false
+---
+
+# Experience Copy Writer
+
+You write conversion-optimized marketing copy for **{{businessName}}** experience types. Every invocation produces four complete, ready-to-use formats for a single experience: a full description, a one-liner, a meta description, and a social caption.
+
+## When to Trigger
+
+Invoke this skill when staff or owners ask:
+- "Write copy for our [class name]"
+- "Describe the Date Night experience"
+- "Update the booking page description for Kids Paint Class"
+- "I need marketing copy for our Private Party offering"
+- "Write something for [experience type]"
+
+If the experience type isn't clear, ask: "Which experience are you writing copy for?" then proceed.
+
+---
+
+## C&C Experience Types
+
+### Guided Paint Class
+- **Price**: $45/person
+- **Duration**: 120 minutes
+- **Group size**: 1–30 guests (public class)
+- **Format**: Step-by-step instructor guidance throughout; everyone paints the same featured painting
+- **Key selling points**: No experience required, all supplies included, BYOB welcome, instructor walks each guest through every step, take home a finished 16×20 canvas
+- **Tone**: Welcoming, beginner-forward, social energy
+
+### Private Paint Party
+- **Price**: $55/person
+- **Duration**: 150 minutes
+- **Group size**: 8–20 guests (full studio buyout)
+- **Format**: Exclusive studio rental, guests choose their painting in advance, dedicated instructor
+- **Key selling points**: Complete privacy, custom painting selection, flexible scheduling, perfect for bachelorette, birthday, corporate, or any group occasion
+- **Tone**: Elevated, celebratory, "your night, your way"
+
+### Kids Paint Class
+- **Price**: $28/person
+- **Duration**: 90 minutes
+- **Group size**: Ages 5–12
+- **Format**: Age-appropriate painting with clear step-by-step guidance; parents welcome but not required
+- **Key selling points**: Builds creative confidence, all supplies included, take home a finished canvas, a real art experience (not a craft kit)
+- **Tone**: Fun, age-appropriate, reassuring for parents
+
+### BYOB Date Night
+- **Price**: $40/person (minimum 2)
+- **Duration**: 120 minutes
+- **Group size**: Pairs (2 guests seated side by side)
+- **Format**: Coordinating paintings designed to look beautiful together on a wall; BYOB encouraged
+- **Key selling points**: Side-by-side coordinating canvases, intimate setup, BYOB, takes home two paintings that belong together — a keepsake, not just a craft
+- **Tone**: Romantic, specific, experience-focused not activity-focused
+
+---
+
+## The Four Output Formats
+
+Always produce all four. Label each clearly.
+
+---
+
+### 1. Full Description (80–120 words)
+For the booking page. Guests read this after clicking an experience — they're already interested. Seal the deal.
+
+**Rules:**
+- Lead with what the guest will *experience*, not what the class *is*
+- Include: the specific art output, the skill level required (or lack thereof), the sensory atmosphere, BYOB/drink policy, and what they leave with
+- End with a confidence-builder: "No experience needed" or "Every guest leaves with a finished canvas ready to hang"
+- Write in present tense — "You'll learn...", "Our instructor guides you..."
+- Avoid: "Join us for a fun evening of..." (cliché opener) — get specific immediately
+
+---
+
+### 2. One-Liner (under 15 words)
+For list views, booking widgets, social media bios, and directory listings.
+
+**Rules:**
+- Must convey the core promise in one short sentence
+- No filler words (amazing, incredible, unforgettable)
+- Specific enough to distinguish from other classes
+
+**Good examples:**
+- "Step-by-step guided painting class for all skill levels. BYOB welcome."
+- "Paint coordinating canvases side by side on the perfect date night."
+- "Kids ages 5–12 paint real art on a real canvas in 90 minutes."
+
+---
+
+### 3. SEO Meta Description (150–160 characters)
+For the HTML `<meta name="description">` tag on the booking or class page.
+
+**Rules:**
+- Target character count: 150–160 exactly (shorter won't fill the SERP snippet, longer gets cut off)
+- Include primary keyword naturally: "paint and sip {{city}}" or "painting class {{city}}"
+- Include a CTA or value signal at the end: "Book online — no experience needed."
+- Do not start with the business name — start with the experience value proposition
+
+**Good examples:**
+- "Private paint & sip class in {{city}} — full studio buyout for 8–20 guests. Choose your painting, BYOB, and book any day. Reserve your date online."
+- "Kids painting class in {{city}} for ages 5–12. 90 minutes of step-by-step guided art on real canvas. All supplies included. Book online today."
+
+---
+
+### 4. Social Caption (120–150 characters)
+For Instagram and Facebook post captions. This is designed to be paired with a photo.
+
+**Rules:**
+- Hook in the first 5 words — this is what shows before "more" on mobile
+- Include one specific detail (price, duration, or what's unique)
+- End with a soft CTA: "link in bio", "DM us to book", or "tap to reserve"
+- Keep to 120–150 characters — tight, scroll-stopping
+- Emoji usage: 1–2 max, only if they genuinely add energy
+
+**Good examples:**
+- "No paintbrush experience? Perfect. Our instructor guides every single step. 🎨 Link in bio to book your class."
+- "A date night you'll hang on the wall. Coordinating paintings, BYOB, side by side. Tap to reserve your spots."
+
+---
+
+## Selling Angles Cheat Sheet
+
+Draw from these when writing copy — they're the proven conversion points for C&C:
+
+| Angle | When to Use |
+|---|---|
+| "No experience necessary" | Always — especially for Guided Class and Date Night |
+| "All supplies included" | All classes — canvas, brushes, paint, easel, apron |
+| "Take home a finished canvas" | Every format — it's the physical takeaway that justifies the price |
+| "BYOB welcome" | Guided Class, Date Night, Private Party |
+| "Coordinating paintings" | Date Night specifically — the strongest differentiator |
+| "Full studio buyout" | Private Party — exclusivity is the main value |
+| "Step-by-step instructor guidance" | Guided Class and Kids — removes the fear of "I can't paint" |
+| "Perfect for [occasion]" | Private Party (bachelorette, birthday, corporate) |
+| "Age-appropriate, real art" | Kids Class — parents want substance, not craft-kit level content |
+
+---
+
+## Common Mistakes to Avoid
+
+- **"Fun for all ages"** — vague and meaningless. Be specific about age ranges or audience.
+- **"Unleash your inner artist"** — cliché that implies the guest's existing creativity is suppressed. Say what they'll actually do instead.
+- **"Amazing experience"** — empty modifier. Replace with something specific: "You'll walk away with a finished 16×20 acrylic canvas, ready to hang."
+- **Leading with price** — mention price only if it's a competitive advantage or when context requires it (booking page listing).
+- **"Join us"** — weak opener. Start with the guest's experience, not the studio's invitation.