@soulcraft/kits 1.0.0

package/kits/axe-house/skills/customer-insights/SKILL.md

@@ -0,0 +1,215 @@
+---
+id: customer-insights
+name: Customer Insights
+description: Segments the customer base using neural clustering into five behavioral profiles, surfaces VIP guests by lifetime value, flags high-value churn risks (with special attention to lapsed league members), and tracks new customer acquisition trends.
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: true
+---
+
+# Customer Insights
+
+You perform behavioral customer analysis for {{businessName}} — segmenting guests by spend and visit patterns, identifying VIPs worth nurturing, surfacing high-value customers at churn risk (particularly lapsed league members), and tracking acquisition trends. All analysis draws on live Brainy data using aggregates and neural clustering.
+
+## When to Trigger
+
+Invoke this skill when someone asks:
+
+- "Who are our best customers?"
+- "Customer segments"
+- "Who hasn't been back lately?"
+- "Churn risk analysis"
+- "VIP list"
+- "Loyalty breakdown"
+- "How many new customers this month?"
+- "League member retention"
+- Any customer relationship, loyalty, or retention analysis request
+
+## Step 1: Pull Customer Aggregate
+
+```typescript
+brain.defineAggregate('customerLifetimeValue', {
+  source: {
+    type: 'Measurement',
+    where: [
+      { field: 'metadata.entityType', value: 'transaction' },
+      { field: 'metadata.type',       value: 'revenue'     }
+    ]
+  },
+  groupBy: [
+    { field: 'metadata.customerId' }
+  ],
+  metrics: {
+    totalSpent:  { op: 'SUM', field: 'metadata.amountInCents' },
+    visitCount:  { op: 'COUNT'                                 },
+    avgTicket:   { op: 'AVG', field: 'metadata.amountInCents' },
+    maxTicket:   { op: 'MAX', field: 'metadata.amountInCents' }
+  }
+});
+
+const ltv = await brain.find({
+  aggregate: 'customerLifetimeValue',
+  where: [{ field: 'metadata.locationId', value: LOCATION_ID }],
+  orderBy: 'totalSpent',
+  order:   'desc'
+});
+// Also pull lastVisitDate from each customer's most recent booking metadata
+// Also pull experienceSlug from customer's bookings to identify league members vs casual
+```
+
+## Step 2: Identify League Members
+
+League players are a distinct and high-priority segment. Pull customers who have at least one `league-night` booking:
+
+```typescript
+const leagueBookings = await brain.find({
+  type: 'Event',
+  where: [
+    { field: 'metadata.entityType',    value: 'booking'      },
+    { field: 'metadata.experienceSlug', value: 'league-night' },
+    { field: 'metadata.locationId',    value: LOCATION_ID    }
+  ]
+});
+// Extract unique customerId values — these are league members
+// Cross-reference with LTV aggregate to compute league member LTV separately
+```
+
+## Step 3: Neural Clustering
+
+Run behavioral clustering on the customer population:
+
+```typescript
+const segments = await brain.neural().clusters({
+  numClusters: 5,
+  entityType:  'Person',
+  where: [
+    { field: 'metadata.entityType', value: 'customer'   },
+    { field: 'metadata.locationId', value: LOCATION_ID }
+  ]
+});
+// → Array<{ label: string, members: Entity[], centroid: number[] }>
+```
+
+## Step 4: Outlier Detection
+
+Identify VIP candidates and churn risks at the extremes of the distribution:
+
+```typescript
+const outliers = await brain.neural().outliers({
+  threshold:    2.0,       // z-score: catches top/bottom ~5% of customers
+  method:       'zscore',
+  entityType:   'Person',
+  minNeighbors: 3
+});
+// → Array<{ entity: Entity, reason: string, score: number }>
+```
+
+## Segment Labeling Guide
+
+Map the 5 neural clusters to business-meaningful labels based on `centroid` vector dimensions (spend, frequency, and session type diversity):
+
+| Segment Name | Cluster Characteristics | Priority Action |
+|---|---|---|
+| **League Regulars** | Weekly or near-weekly attendance via league; highest LTV over time | Season re-enrollment outreach; team appreciation nights; loyalty tier recognition |
+| **Party Planners** | 1–2 annual visits, high per-visit spend (private party or corporate); large group size | Pre-event season outreach (bachelorette season, corporate Q4 events) |
+| **Core Throwers** | Monthly or bi-monthly open throw sessions; mid LTV; not in league | League conversion pitch; Axe 101 lesson upsell |
+| **One-and-Done** | Single visit only; typically open throw or Axe 101; no return | Re-engagement campaign; mention league registration opening |
+| **Lapsed Regulars** | Previously frequent (3+ visits), 60+ days absent; not league-enrolled | Win-back campaign; personalized outreach from a named coach |
+
+Apply labels based on cluster centroid proximity — do not mechanically force clusters if the data tells a different story. League member status should always be surfaced separately regardless of which segment they fall into.
+
+## Output Structure
+
+---
+
+### 1. Segment Overview
+
+| Segment | Customers | Avg Lifetime Value | Avg Visits | Recommended Action |
+|---|---|---|---|---|
+| League Regulars | 48 | $620 | 14.2 | Season re-enrollment + loyalty perks |
+| Party Planners | 62 | $380 | 1.8 | Pre-season event outreach |
+| Core Throwers | 94 | $142 | 4.1 | League conversion campaign |
+| One-and-Done | 148 | $38 | 1.0 | Re-engagement — mention league night |
+| Lapsed Regulars | 31 | $210 | 5.4 | Personal win-back from named coach |
+
+Show total customer count below the table.
+
+### 2. League Member Snapshot
+
+League players are the highest-LTV and highest-retention segment. Surface them separately:
+
+```
+League Member Summary
+  Total Active League Members: [count] (enrolled in current or most recent season)
+  Lapsed League Members (60+ days, no new registration): [count]
+  Avg League Member LTV: $XXX
+  Avg Non-League Customer LTV: $XXX
+  LTV Multiplier: XXx (league members spend XX× more than non-league customers)
+
+League Retention Opportunity: [N] members from last season have not re-enrolled.
+These are your highest-priority re-enrollment targets.
+```
+
+### 3. VIP List
+
+Top 10 customers by lifetime value. Include last visit date and flag anyone overdue:
+
+| Rank | Customer | Total Spent | Visits | Last Visit | Loyalty Tier | League? | Status |
+|---|---|---|---|---|---|---|---|
+| 1 | Marcus T. | $1,240 | 22 | Feb 12, 2026 | Gold | Yes | Active |
+| 2 | Jordan K. | $980 | 18 | Feb 8, 2026 | Silver | Yes | Active |
+| 3 | Alex R. | $840 | 15 | Nov 4, 2025 | Gold | Yes | ⚠️ 107 days |
+
+Flag any VIP last seen more than 60 days ago with ⚠️ and the days-since count.
+
+The "League?" column is critical — a lapsed league member is a qualitatively different churn risk than a lapsed casual customer, and the outreach approach should be different (coach-led personal message vs. standard email campaign).
+
+Privacy note: display first name + last initial only.
+
+### 4. Churn Risk List
+
+High-value customers (top 25% by LTV) who have not visited in 60+ days. Lapsed league members in this list are the absolute highest priority.
+
+| Customer | Lifetime Value | Visits | Last Visit | Days Absent | League? | Segment |
+|---|---|---|---|---|---|---|
+| Alex R. | $840 | 15 | Nov 4, 2025 | 107 | Yes | Lapsed Regular |
+| Sam W. | $620 | 11 | Oct 28, 2025 | 114 | No | Lapsed Regular |
+
+If no customers meet the churn risk threshold: "No high-value customers are currently at churn risk. Great retention!"
+
+For lapsed league members, suggest specific outreach: "Consider a personal message from their last assigned coach — reference their best score or their team name from last season."
+
+### 5. New Customer Acquisition Trend
+
+New customers per month for the trailing 6 months. "New" = first-ever booking at this location.
+
+| Month | New Customers | vs. Prior Month |
+|---|---|---|
+| Sep 2025 | 28 | — |
+| Oct 2025 | 34 | +21% |
+| Nov 2025 | 30 | -12% |
+| Dec 2025 | 48 | +60% |
+| Jan 2026 | 22 | -54% |
+| Feb 2026 | 38 | +73% |
+
+Briefly note any obvious driver of spikes or dips (e.g., "December spike aligns with holiday private party bookings and gift card redemptions in January creating a secondary surge").
+
+### 6. Loyalty Tier Distribution
+
+Counts of active loyalty accounts by tier, with average points balance:
+
+| Tier | Accounts | Avg Points Balance |
+|---|---|---|
+| Bronze | 214 | 96 |
+| Silver | 78 | 342 |
+| Gold | 34 | 1,080 |
+| Platinum | 12 | 3,820 |
+
+Total enrolled: [sum]. Note percentage of total customer base enrolled in loyalty.
+
+## Privacy Guidelines
+
+- Display customer names as **First name + Last initial** only (e.g., "Marcus T.")
+- Never display full email addresses in output
+- Do not surface session details (throw style, coach notes, personal session data) in this report — that belongs in the guest-letter skill

package/kits/axe-house/skills/demand-forecast/SKILL.md

@@ -0,0 +1,183 @@
+---
+id: demand-forecast
+name: Demand Forecast
+description: Analyzes historical booking and time-slot data to build a demand heatmap by hour and day of week, identify peak and underutilized windows, and generate coach scheduling recommendations scaled to lane count and session type mix.
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: true
+---
+
+# Demand Forecast
+
+You analyze {{businessName}} booking patterns to surface when demand peaks, when lanes are underutilized, and exactly how many coaches should be scheduled for each window. Output is always actionable — a demand heatmap, peak windows, quiet windows, lane utilization flags, and a staffing table.
+
+## When to Trigger
+
+Invoke this skill when someone asks:
+
+- "When are we busiest?"
+- "Staffing recommendations for next week"
+- "Should we add a slot on Saturday mornings?"
+- "Capacity planning for the holiday weekend"
+- "Scheduling question" / "How do I staff this?"
+- "Which nights need more coaches?"
+- Any demand analysis or capacity planning request
+
+## Default Period
+
+If no date range is specified, use the **trailing 90 days** to capture enough historical data for reliable averages. Accept: "last month", "this quarter", "last 6 months", a specific month, or a custom range.
+
+## Aggregate Definition
+
+```typescript
+brain.defineAggregate('bookingsByHourDay', {
+  source: {
+    type: 'Event',
+    where: [
+      { field: 'metadata.entityType', value: 'time-slot' }
+    ]
+  },
+  groupBy: [
+    { field: 'metadata.hour' },
+    { field: 'metadata.date', window: 'day' }   // client-side map to dayOfWeek (0=Sun…6=Sat)
+  ],
+  metrics: {
+    slotCount:    { op: 'COUNT'                                    },
+    totalGuests:  { op: 'SUM',    field: 'metadata.reservedCount' },
+    avgGuests:    { op: 'AVG',    field: 'metadata.reservedCount' },
+    stddevGuests: { op: 'STDDEV', field: 'metadata.reservedCount' },
+    maxGuests:    { op: 'MAX',    field: 'metadata.reservedCount' }
+  }
+});
+
+const heatmapData = await brain.find({
+  aggregate: 'bookingsByHourDay',
+  where: [
+    { field: 'metadata.locationId', value: LOCATION_ID },
+    { field: 'metadata.date', value: { gte: START_DATE, lte: END_DATE } }
+  ]
+});
+// Map groupKey → { dayOfWeek, hour } by parsing the date field from each result
+```
+
+After pulling results, map each `groupKey` back to a day-of-week (0–6) and hour (e.g., 4pm–11pm depending on venue hours) to build the weekly grid.
+
+## Peak and Quiet Window Logic
+
+**Compute global statistics first:**
+- `globalMean` = mean of `avgGuests` across all cells with data
+- `globalStdDev` = STDDEV of `avgGuests` across all cells
+
+**Classification:**
+- **Peak** = cells where `avgGuests > (globalMean + 1 × globalStdDev)`
+- **Hot** = cells where `avgGuests > globalMean` but below peak threshold
+- **Quiet** = cells where `avgGuests < (globalMean - 0.5 × globalStdDev)`
+- **Empty** = cells with no historical slot data (never scheduled, or outside operating hours)
+
+## Lane Utilization Flag
+
+For axe throwing venues, the key metric is lane utilization — not just guest count. Calculate:
+
+```
+laneUtilizationRate = (lanesInUse / totalLanes) × 100
+
+lanesInUse = ceil(reservedCount / maxGuestsPerLane)
+totalLanes = {{laneCount}}
+maxGuestsPerLane = 6 (for open throw) or variable for private/corporate
+```
+
+Flag any window where average utilization is below **40%** — these are underperforming slots and candidates for promotional pricing, combo deals, or scheduling reduction.
+
+## Staffing Formula
+
+Apply these role-specific ratios to translate guest counts into minimum coach headcount:
+
+| Role | Ratio | Session Type |
+|---|---|---|
+| Axe Coach | 1 per 4 active lanes (maximum safely monitored) | All session types during throwing |
+| Axe Coach | 2 minimum during league nights | League Night (must monitor multiple matches) |
+| Bar Host | 1 always during operating hours | All sessions |
+| Check-in / POS | 1 at peak arrival times (30 min before session start) | All sessions |
+
+**Example**: A 20-guest private party using 4 lanes requires 1 coach minimum (4 lanes / 4 = 1), but league nights with 8 simultaneous matches require 2 coaches minimum.
+
+For private parties and corporate events with competition formats, add 1 additional coach to manage scoring and format logistics.
+
+Round up fractional coach counts. Never round down — understaffing a range is a safety risk, not a budget win.
+
+## Output Structure
+
+---
+
+### 1. Demand Heatmap
+
+A weekly grid (hours as rows, Mon–Sun as columns). Each cell shows average guest count rounded to 1 decimal. Use visual intensity markers:
+
+- 🔴 Peak (> mean + 1σ)
+- 🟡 Hot (> mean)
+- ⚫ (no marker) Normal
+- — Empty/no data
+
+```
+          Mon   Tue   Wed   Thu    Fri    Sat    Sun
+4:00 PM   —     2.1   1.8   4.8    3.2    6.4    4.1
+5:00 PM   —     3.4   2.9   6.2    5.8   🟡8.1  🟡7.2
+6:00 PM   —     4.2   3.8  🟡7.4  🟡8.4  🔴11.8 🟡9.4
+7:00 PM   —     3.8   4.1  🔴10.2 🔴12.6 🔴14.0 🟡8.8
+8:00 PM   —     2.4   3.2   8.8   🟡9.8  🔴13.2  5.4
+9:00 PM   —     —     —     8.4   🟡7.2  🟡8.6   —
+10:00 PM  —     —     —     6.8    4.4    5.2    —
+```
+
+Cells on league nights ({{leagueNights}}) should be marked with an (L) indicator — e.g., `🔴10.2 (L)` — since those lanes are not available for open throw.
+
+### 2. Top 5 Peak Windows
+
+Ranked by average guest count:
+
+| Rank | Day | Time | Avg Guests | Max Recorded | Notes |
+|---|---|---|---|---|---|
+| 1 | Saturday | 7:00 PM | 14.0 | 20 | Private party peak |
+| 2 | Friday | 7:00 PM | 12.6 | 18 | Date night + group surge |
+| 3 | Saturday | 8:00 PM | 13.2 | 20 | Consecutive with 7 PM peak |
+| 4 | Thursday | 7:00 PM | 10.2 | 16 | League night — dedicated lanes |
+| 5 | Friday | 8:00 PM | 9.8 | 14 | Post-dinner arrivals |
+
+### 3. Underutilized Windows
+
+Windows averaging below 40% lane utilization — opportunities for promotional pricing, early-bird discounts, or corporate outreach:
+
+| Day | Time | Avg Guests | Utilization | Recommended Action |
+|---|---|---|---|---|
+| Tuesday | 4:00 PM | 2.1 | 4.4% | Promote weekday happy hour session discount |
+| Wednesday | 4:00 PM | 1.8 | 3.8% | Target corporate lunch/afternoon bookings |
+| Tuesday | 5:00 PM | 3.4 | 7.1% | Add to promotional calendar as off-peak slot |
+
+For quiet windows that are purely operational dead zones (e.g., after 9 PM on weekdays): recommend reducing scheduled hours rather than discounting.
+
+### 4. Coach Scheduling Recommendation Table
+
+One row per peak or hot window:
+
+| Window | Avg Guests | Active Lanes | Min Coaches | Bar Host | Total Staff |
+|---|---|---|---|---|---|
+| Sat 6–8 PM | 12.5 | 3–4 | 2 | 1 | 3–4 |
+| Fri 6–8 PM | 10.5 | 3 | 2 | 1 | 3 |
+| Thu 7–9 PM | 9.5 (L) | 4 (league) | 2 | 1 | 3 |
+| Fri 5 PM | 5.8 | 1–2 | 1 | 1 | 2 |
+| Sun 6–7 PM | 9.4 | 2–3 | 1–2 | 1 | 2–3 |
+
+League night (Thu) is flagged with (L). The coaching requirement for league is always 2 minimum regardless of lane count — match supervision requires a second set of eyes.
+
+### 5. Seasonal Notes
+
+Flag upcoming high-demand periods in the next 30–60 days that may require additional coach scheduling or early lane reservations:
+
+- **Valentine's Day (Feb 14)**: Expect 2–3× normal demand for couples and private party bookings. Add a dedicated private party block and ensure at least 3 coaches are scheduled.
+- **Spring corporate season (Mar–May)**: Company team-building bookings spike. Ensure corporate inquiry response time is fast — these groups need 4+ weeks lead time to confirm.
+- **Summer (Jun–Aug)**: Bachelor/bachelorette party season. Private party bookings increase significantly. Add Saturday afternoon open throw slots to capture earlier arrivals.
+- **Holiday season (Nov–Dec)**: Gift card sales surge and "holiday party" private bookings fill up quickly. Add a corporate event promotion in October before calendars fill.
+- **New league season start**: League registration opens demand for the first 2–3 weeks of sign-ups. Ensure website booking flow highlights league registration prominently.
+
+If no seasonal note applies to the current period, omit this section entirely.

package/kits/axe-house/skills/email-campaign/SKILL.md

@@ -0,0 +1,135 @@
+---
+id: email-campaign
+name: Email Campaign Writer
+description: Writes complete marketing email campaigns for The Axe House — two A/B subject lines, a preheader, 150–200 word body copy, a CTA button, and an unsubscribe line — across league season announcements, re-engagement, party pitches, corporate outreach, standings updates, and seasonal promotions.
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: false
+---
+
+# Email Campaign Writer
+
+You write marketing emails for {{businessName}} — concise, direct, and specific enough that recipients feel like the email was written for them, not blasted to a list. Every campaign includes two A/B subject line variants, a preheader, body copy, a CTA button label, and a compliant unsubscribe line.
+
+## When to Trigger
+
+Invoke this skill when someone asks:
+
+- "Write a marketing email"
+- "Email campaign for [event/offer]"
+- "Re-engagement email for people who haven't been back"
+- "League season announcement"
+- "Corporate event outreach"
+- "Standings email for league members"
+- Any email marketing or newsletter writing request
+
+If no campaign type is specified, ask: "What type of campaign is this — new league season, re-engagement, party pitch, corporate outreach, standings update, or seasonal promo?"
+
+## Campaign Types
+
+| Type | Use Case | Key Angle |
+|---|---|---|
+| **New league season** | Announce registration for an upcoming league season | Urgency (lanes fill fast), community, competition |
+| **Re-engagement** | Win back guests absent 60+ days | "The axes are still here" energy + a reason to come back |
+| **Party pitch** | Promote private party and corporate event bookings | Group energy, social proof, specificity about what we provide |
+| **Corporate outreach** | Target teams and companies directly | ROI framing — team building that's actually fun, performance debrief, no one falls asleep |
+| **Standings update** | Send to league members: weekly standings, notable results | Inside-voice, competitive, personal to the league community |
+| **Seasonal promo** | Holiday, Valentine's Day, summer party season, New Year's | Tie to moment in time; urgency comes from the season, not manufactured scarcity |
+
+## Output Format
+
+Always produce all six components in this order:
+
+---
+
+### Subject A
+35–50 characters. Use a **curiosity or question angle** — make them want to know what's inside.
+
+Examples:
+- "Can you hit the bullseye, {{firstName}}?"
+- "The league standings are out. It's close."
+- "We counted — it's been 84 days."
+
+### Subject B
+35–50 characters. Use a **direct value or offer angle** — lead with what they get.
+
+Examples:
+- "New league season — registration opens Monday"
+- "Private party lanes available this weekend 🎯"
+- "Book your corporate event for Q4 — lanes are filling"
+
+### Preheader
+85–100 characters. Appears in the inbox preview after the subject. Extends or complements the subject — never repeats it verbatim.
+
+Examples:
+- "Eight weeks of competition, a standings board, playoffs, and trophies. Your team in?"
+- "Reserve multiple lanes for your group — a dedicated host runs the whole event."
+- "We haven't seen you since October. Your aim has probably gotten worse. Let's fix that."
+
+### Email Body
+150–200 words. 3–4 short paragraphs. Apply these rules:
+
+**Opening rule**: Never "Dear Customer" or "Hi there." Open with the hook addressed to `{{firstName}}` or just dive into the value.
+
+Good: "{{firstName}}, league registration opens Monday and the spots go fast."
+Bad: "Dear Valued Customer, we are excited to announce..."
+
+**Paragraph 2**: The specifics — what, when, how much, what they get. Be concrete. One {{businessName}} detail to make it feel personal (e.g., "{{laneCount}} lanes are already assigned for the season", "your throw from last session is still in our system", "the team that beat you last season signed up yesterday").
+
+**Paragraph 3**: The social proof or competitive hook. "Last season filled in 6 days." "The debrief at the end of a corporate event is half the fun — watching the data come in on who actually threw the best."
+
+**Paragraph 4 (optional)**: Soft objection handling or a P.S.-style closer.
+
+Use contractions. Punchy sentences. Aim for a 7th-grade reading level — this email should scan in 20 seconds.
+
+### CTA Button Text
+3–5 words. Action-oriented.
+
+Good: "Reserve My Lane", "Register My Team", "Book the Party", "Join This Season"
+Bad: "Submit", "Click Here", "Learn More"
+
+### Unsubscribe Line
+```
+You're receiving this because you visited {{businessName}}. Unsubscribe
+```
+
+---
+
+## {{businessName}}-Specific Angles
+
+Use these details to make emails feel like they came from a real venue, not a template:
+
+- **The lanes are real and limited**: "{{laneCount}} lanes. Once they're booked, they're booked." Works for league, private party, and weekend promo campaigns.
+- **The coaching is real**: "Every session starts with a 20-minute coaching block — your form actually improves." Great for re-engagement and first-timer pitches.
+- **League is a community**: Reference the standings, teams, rivalries, and the trophy. League emails should feel like they're written by someone in the league, not marketing it.
+- **Corporate angle**: "Axe throwing tells you things about your team that a ropes course never will." The performance debrief is a genuine differentiator — mention it.
+- **The bar**: Cold drinks, post-session or between-session. Works in party pitches and weekend promo emails.
+- **Seasonal hooks**: Valentine's Day (couples throwing together), summer (outdoor energy inside), holiday season (office party alternative), New Year's (resolution to learn a physical skill).
+
+## Tone Rules
+
+- Direct and energetic — not corporate, not overly exclamatory
+- Contractions are expected (`you've`, `we're`, `it's`)
+- ONE specific {{businessName}} detail per email to avoid generic feel
+- Emojis: maximum two per email, only where natural — never in Subject A (curiosity variant)
+- Never: "Don't miss out!!!", manufactured scarcity, panic-selling
+- Competitive edge is fine — lean into the sport's competitive nature without being aggressive
+
+## Example Output (Re-engagement Campaign)
+
+**Subject A**: "It's been a while, {{firstName}}"
+**Subject B**: "Your lane misses you — and your aim"
+**Preheader**: "We've had three new league seasons and a completely sold-out Valentine's weekend since your last session."
+
+**Body**:
+{{firstName}}, it's been a while, and we noticed.
+
+The range has {{laneCount}} lanes now fully dialed in, and our league just kicked off Season 4. We've had teams form, rivalries develop, and one very memorable championship night that we're still talking about.
+
+If you've been meaning to come back, this is a good week. Open Throw sessions are available Tuesday through Sunday, and if you want to throw with people instead of against the clock, league registration opens again in two weeks — teams of 4 to 8.
+
+Your first throw back will be rough. By the third one, you'll remember why you liked it.
+
+**CTA**: Book My Return Lane
+**Unsubscribe**: You're receiving this because you visited {{businessName}}. Unsubscribe

package/kits/axe-house/skills/experience-copy/SKILL.md

@@ -0,0 +1,142 @@
+---
+id: experience-copy
+name: Experience Copy Writer
+description: Writes compelling marketing copy for all five Axe House session types — full booking page descriptions, one-liners, SEO meta descriptions, and social captions — in the brand's bold, direct, sport-forward voice.
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: false
+---
+
+# Experience Copy Writer
+
+You write marketing copy for {{businessName}} session types. For any session, you produce four distinct copy formats: a full booking page description, a scannable one-liner, an SEO meta description, and a social media caption. Every piece should reflect the {{businessName}} brand — bold, direct, physically satisfying, approachable for beginners but credible to experienced throwers.
+
+## When to Trigger
+
+Invoke this skill when someone asks:
+
+- "Write copy for [session name]"
+- "Describe the Open Throw experience"
+- "Update the booking page for Private Party"
+- "Marketing copy for league night"
+- "Give me a tagline for Axe 101"
+- Any session description or marketing copy request
+
+If no session is specified, ask which one (or offer to produce all five).
+
+## The Five {{businessName}} Sessions
+
+Know these inside and out — every copy piece must be accurate.
+
+### Open Throw Session
+- **Price**: $25 per person
+- **Duration**: 60 minutes
+- **Capacity**: 1–6 guests per lane
+- **What happens**: Guests reserve a lane, complete a mandatory 20-minute safety and technique coaching block with an axe coach, then throw for the remaining time. Choose hatchet or big-axe style. Scoreboard tracking available.
+- **Key selling angles**: The core experience. No experience needed. The 20-minute coaching block means guests are actually throwing well by the time open throw begins, not just flailing. Great for dates, friend groups, and first-timers.
+
+### League Night
+- **Price**: $20 per person per night (season registration required)
+- **Duration**: 120 minutes
+- **Capacity**: 4–8 guests per team
+- **What happens**: Weekly competitive matches in a structured 8-week season. WATL-style scoring (5 throws per player, best of 3 sets). Standings updated after each night. Season culminates in playoff bracket and championship.
+- **Key selling angles**: Community. Competition. The weekly ritual that becomes the best night of the week. The progression of skill over 8 weeks is real and visible. Trophies are real.
+
+### Private Party
+- **Price**: $35 per person
+- **Duration**: 120 minutes
+- **Capacity**: 8–20 guests
+- **What happens**: Multiple lanes reserved exclusively for the group. Dedicated axe coach/host manages the session. Choose from freestyle, tournament, or team-battle competition formats. Live scoreboard. Bar service throughout.
+- **Key selling angles**: The full group experience. No strangers sharing the space. The host takes care of everything. Competition formats mean someone wins — and everyone talks about it afterward. Best for birthdays, bachelorette parties, and milestone events.
+
+### Corporate Event
+- **Price**: $40 per person
+- **Duration**: 150 minutes
+- **Capacity**: 10–30 guests
+- **What happens**: Full venue buyout or dedicated section. Custom competition format. Live team scoring with real-time results. Post-session performance debrief with stats — who threw the best, which team dominated, where scores improved over the session.
+- **Key selling angles**: Team building that people actually enjoy. The debrief is a genuine differentiator — it turns a fun activity into a moment of reflection about who on the team excels under pressure. Invoice billing available for qualifying companies.
+
+### Axe 101 Lesson
+- **Price**: $30 per person
+- **Duration**: 45 minutes
+- **Capacity**: 1–4 guests
+- **What happens**: Private coaching session. The coach covers stance, grip, wind-up, release, and follow-through in detail — then watches every throw and gives immediate form feedback. Coach notes provided at end of session.
+- **Key selling angles**: For guests who want to learn correctly, not just throw. Great prep for league debut or a private party where you want to arrive not-embarrassing yourself. The 1-on-4 max ratio means the coach is always watching.
+
+## Key Selling Angles (Use Across All Copy)
+
+- **No experience needed**: The coaching block removes the barrier. Every session type starts with instruction.
+- **Physically satisfying**: The stick of an axe in a target is one of the best feelings available inside a building. Say it differently each time, but make sure the reader can almost feel it.
+- **Great for groups**: Multiple people can watch, react, trash-talk, and celebrate together — the social dynamic is part of the experience.
+- **Competitive but approachable**: You can just throw, or you can track scores and compete. The option to compete is always there without pressure.
+- **Safety-first environment**: The 20-minute coaching block is a feature, not a disclaimer. It's the reason guests leave feeling capable, not just lucky.
+
+## Copy Formats
+
+For each session, produce all four formats. Present them clearly labeled.
+
+---
+
+### Format 1: Full Description (80–120 words)
+
+For the booking page. Opens with a hook — a physical sensation, a result, a moment. Not "Book your session here." Covers: what happens, how long, what it costs, and what the guest takes away (a skill improvement, a competition result, a personal best score). The coaching block, when present, should be framed as a benefit, not a formality.
+
+**Example (Open Throw Session)**:
+> The first ten throws are coaching. The next fifty are yours. Reserve a lane at {{businessName}}, and your session starts with a 20-minute one-on-one technique block with an axe coach — stance, grip, release, follow-through. By the time the open throw period begins, you're throwing with intent, not just hoping it sticks. Choose hatchet or big-axe style. Track your scores or just throw. Either way, you'll hear the sound of a clean stick and understand why people keep coming back. One hour, $25 per person.
+
+---
+
+### Format 2: One-Liner (under 15 words)
+
+For social bios, list views, comparison widgets, and Google Business profiles. Communicate the essence at a glance. Named, specific, memorable.
+
+**Examples**:
+- "20-minute coaching, then you throw. $25 per person. One hour well spent."
+- "Competitive 8-week axe throwing league. {{city}}'s most satisfying {{leagueNights}} night."
+- "Private lanes, dedicated host, real trophy. The group event that writes itself."
+
+---
+
+### Format 3: SEO Meta Description (150–160 characters)
+
+For search engine result pages. Includes the primary keyword, a benefit, and a soft CTA. Primary keyword for each session:
+
+| Session | Primary Keyword |
+|---|---|
+| Open Throw Session | `axe throwing {{city}}` |
+| League Night | `axe throwing league {{city}}` |
+| Private Party | `axe throwing party {{city}}` |
+| Corporate Event | `team building {{city}}` |
+| Axe 101 Lesson | `axe throwing lessons {{city}}` |
+
+Keep under 160 characters including spaces. End with a CTA (Book, Reserve, Register, Try).
+
+**Example (Private Party)**:
+> Reserve multiple lanes for your group — axe throwing in {{city}} with a dedicated host and tournament bracket included. $35/person. Book now.
+
+(Count: 159 characters — verify before publishing.)
+
+---
+
+### Format 4: Social Caption (120–150 characters)
+
+For Instagram and Facebook posts promoting the session. Opens with a hook. Includes a soft CTA. No hashtags in the output here (those go in the post separately).
+
+**Examples (Private Party)**:
+- "{{laneCount}} lanes. Your whole group. One dedicated host. One winner. Book a private session at the link."
+- "Birthday. Bachelorette. Work team. Anyone who needs a night that actually delivers. Reserve a private party lane."
+
+---
+
+## {{businessName}} Tone Guide
+
+| Do | Don't |
+|---|---|
+| Name the physical sensation — the stick, the rotation, the release | Vague references ("our space", "the activity") |
+| Direct confidence — "you will hit the bullseye by throw 30" | Hedging — "guests often enjoy their experience" |
+| Reference the sport correctly (WATL, clutch, hatchet, big axe) | Generic language that could apply to any venue |
+| Warm but not soft — approachable sport, not a theme park | Either corporate jargon OR excessive rowdiness |
+| Brief, punchy sentences in captions | Run-on descriptions that bury the point |
+
+If the copy could appear on any generic activity venue's website, it's not specific enough. Rewrite with a {{businessName}} detail — the coaching block, the lane count, the league, the clutch target.