@soulcraft/kits 1.0.0

package/kits/canvas-and-corks/skills/social-calendar/SKILL.md

@@ -0,0 +1,146 @@
+---
+id: social-calendar
+name: Social Media Calendar
+description: Creates a month of social media content for Canvas & Corks with 20–30 posts across Instagram, TikTok, and Facebook — including content descriptions, captions, and platform-specific hashtag sets.
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: false
+---
+
+# Social Media Calendar
+
+You create a complete, ready-to-execute monthly social media content calendar for **{{businessName}}**. Each post includes the scheduled day, platform, content description, full caption, and hashtags. The calendar balances content pillars and never lets promotional posts dominate the feed.
+
+## When to Trigger
+
+Invoke this skill when staff or owners ask:
+- "Create a social media calendar"
+- "Plan our social content for [month]"
+- "What should we post this month?"
+- "Social media plan"
+- "Write a month of posts"
+
+If a month isn't specified, default to the next full calendar month. If specific class schedules or painting names are available, incorporate them.
+
+---
+
+## Content Pillars
+
+Every calendar must follow this approximate distribution across 20–30 posts:
+
+| Pillar | % of Posts | Purpose |
+|---|---|---|
+| Class Previews & Highlights | 35% | Show what's painting, create FOMO for upcoming sessions |
+| Guest Creations | 25% | Social proof, community celebration, word-of-mouth amplification |
+| Educational / Inspirational | 20% | Build authority, teach something, earn follows |
+| Community & Studio Life | 10% | Humanize the brand, staff spotlights, behind-the-scenes |
+| Promotional | 10% (max 1 in 5) | Direct booking CTA — no more than 20% of posts ever |
+
+Never exceed 1 promotional post in any 5-post sequence. Audiences disengage from feeds that feel like ads.
+
+---
+
+## Platform Notes
+
+### Instagram
+- **Best for**: Finished paintings, in-progress shots, aesthetic studio moments, Reels for painting time-lapses
+- **Caption style**: Lead with a visual hook sentence, then expand. Use line breaks generously. End with a question or soft CTA.
+- **Hashtags**: 7 hashtags, mix of broad and niche — place at the end of caption or in first comment
+- **Frequency**: 5–7 posts per week (feed + Stories, but this calendar covers feed only)
+
+### TikTok
+- **Best for**: Time-lapse paint-along videos from start to finish, instructor technique demos, "satisfying" content (palette knife pulls, paint pours), class energy and laughter
+- **Caption style**: Conversational, hook in the first sentence. TikTok captions are short — 100–150 chars max visible without tap.
+- **Hashtags**: 5–6 hashtags, lean into discovery (#paintsip, #paintanddrink, #arttok)
+- **Frequency**: 3–5 times per week
+
+### Facebook
+- **Best for**: Event announcements, class schedule posts, longer community updates, sharing blog posts, photo albums from past classes
+- **Caption style**: More prose than Instagram. Can run 2–3 sentences without truncation. Good for longer event details.
+- **Hashtags**: 2–3 max — Facebook hashtags are less impactful than Instagram/TikTok
+- **Frequency**: 3–5 times per week
+
+---
+
+## C&C Hashtag Bank
+
+Use these in rotation — don't repeat the same hashtag set more than twice in a row:
+
+**Primary (use in almost every post):**
+`#canvasandcorks` `#paintsip` `#paintnight` `#artclass`
+
+**Audience/activity tags (rotate):**
+`#datenight` `#{{city}}date` `#bacheloretteparty` `#teambuilding` `#girlsnight` `#groupactivity`
+
+**Painting/art tags (rotate):**
+`#artlovers` `#wineandpaint` `#beginnerart` `#artnight` `#acrylicpainting` `#paintingclass`
+
+**Local tags (always include at least one):**
+`#{{city}}` `#{{city}}events` `#{{city}}fun` `#thingstodoin{{city}}`
+
+**TikTok-specific:**
+`#arttok` `#paintingtiktok` `#satisfying` `#createwithme` `#paintanddrink`
+
+---
+
+## Calendar Format
+
+For each post, produce a block in this format:
+
+```
+---
+Day [N] — [Day of Week, Date]
+Platform: [Instagram | TikTok | Facebook]
+Pillar: [Class Preview | Guest Creation | Educational | Community | Promotional]
+
+Content: [2–3 sentence description of the visual content — what should the video or photo show? Be specific enough that a staff member knows exactly what to film or photograph.]
+
+Caption:
+[Full caption text — 150–220 characters for Instagram/TikTok. May be longer for Facebook.]
+
+Hashtags: #canvasandcorks #paintsip [4–5 more from the bank]
+---
+```
+
+---
+
+## Sample Posts by Pillar
+
+### Class Preview (Instagram)
+**Content**: Flat-lay of a finished "Sunflower Field" canvas next to a glass of rosé, clean studio background, warm natural light.
+**Caption**: "This month's Wednesday night class. 🌻 Step-by-step guided — no experience needed. BYOB and let the instructor do the hard part. Link in bio to grab a seat."
+**Hashtags**: #canvasandcorks #paintsip #paintnight #{{city}}date #artclass #sunflowers #datenight
+
+### Guest Creation (Instagram)
+**Content**: Side-by-side photo of two guests holding up their finished "Mountain Sunset" paintings, both slightly different — both beautiful.
+**Caption**: "No two paintings are ever exactly alike. That's the point. 🏔️ Shoutout to this duo who absolutely nailed last Friday's Mountain Sunset class. What do you think — whose version would you hang on your wall?"
+**Hashtags**: #canvasandcorks #paintnight #artlovers #acrylicpainting #{{city}}events #girlsnight #beginnerart
+
+### Educational (TikTok)
+**Content**: 30-second time-lapse: instructor shows the wet-on-wet blending technique for a sky. Start with two separate colors, blend together in 5 slow brush strokes, reveal the soft gradient.
+**Caption**: "This is how we get those dreamy skies. Wet-on-wet blending 🖌️ easy once you know the trick."
+**Hashtags**: #arttok #paintingclass #paintsip #acrylicpainting #satisfying #createwithme
+
+### Community (Instagram)
+**Content**: Candid photo of the instructor arranging the easels before a class — paint bottles lined up, canvases stacked, morning light through the studio windows.
+**Caption**: "Every class starts here. The quiet before the brushstrokes. 🎨 What's your favorite part of a paint night — the setup excitement or the reveal at the end?"
+**Hashtags**: #canvasandcorks #behindthescenes #paintnight #artclass #{{city}}
+
+### Promotional (Facebook)
+**Content**: Clean graphic with class name, date, time, and "Only 6 Seats Left" badge. Studio logo and color palette of the painting shown.
+**Caption**: "Date Night is almost full! 🎨 Join us Saturday Feb 22nd at 7pm for 'Moonlit Harbor' — a gorgeous nautical painting perfect for coordinating canvases. BYOB, all supplies included, just bring your favorite person. Book now → [LINK: /book]"
+**Hashtags**: #canvasandcorks #datenight #{{city}}
+
+---
+
+## Full Calendar Structure
+
+Produce a full calendar with 20–30 posts distributed across the month. Aim for:
+- Opening week: 1 month-preview post + 1 painting tease + 1 educational
+- Middle weeks: 2–3 posts per platform per week, rotating pillars
+- End of month: 1 recap post, 1 "coming next month" tease
+- At least 1 TikTok post per week focused on painting process content
+- At least 1 guest-tagging or community post per week
+
+Number the posts Day 1 through Day [last day of month] and distribute evenly. Not every day needs a post — aim for 5–6 per week across all platforms.

package/kits/canvas-and-corks/skills/staff-briefing/SKILL.md

@@ -0,0 +1,134 @@
+---
+id: staff-briefing
+name: Staff Morning Briefing
+description: Generates a structured morning operations briefing for the current paint studio shift, including class schedule, capacity, revenue forecast, easel prep counts, inventory alerts, and a pre-shift action checklist.
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: true
+---
+
+# Staff Morning Briefing
+
+You generate a clear, organized morning operations briefing for the opening staff team at **{{locationName}}**. Think studio-manager energy: thorough, cheerful, and ready to run a great day.
+
+## When to Trigger
+
+Invoke this skill when staff ask:
+- "What's the briefing for today?"
+- "What classes are running today?"
+- "Good morning — what do I need to know?"
+- "Daily briefing" / "morning check-in"
+- Any question about today's schedule at the start of a shift
+
+## Data to Pull
+
+Before generating the briefing, gather:
+
+1. **Today's bookings** — Query `Event` entities with `metadata.entityType = 'booking'` and `metadata.date = [today's date]` and `metadata.locationId = [location]`. Group by time slot / experienceSlug.
+2. **Time slots** — Query `Event` entities with `metadata.entityType = 'time-slot'` for today to get capacity and `reservedCount` per session.
+3. **Session attributes** — For each booking, check `data.sessionAttributes` for `paintingName`, `medium`, `colorPalette`, `canvasSize` if staff have pre-assigned them.
+4. **Revenue comparison** — Query the `Measurement` aggregate for the same weekday last week (same day-of-week, one week prior) to produce a comparison figure.
+5. **Inventory alerts** — Query `Thing` entities with `metadata.entityType = 'inventory-item'` and `metadata.locationId = [location]`. Flag any where `metadata.quantity <= metadata.reorderThreshold`.
+
+## Briefing Structure
+
+Generate the briefing in exactly this structure:
+
+---
+
+### Good morning, {{locationName}}! ☀️
+
+> **[Full date — e.g., Wednesday, February 19, 2026]**
+
+---
+
+### 1. Today's Classes
+
+For each time slot scheduled today, produce a block:
+
+```
+🎨 [Time] — [Experience Name]
+   Painting: [paintingName from session attributes, or "TBD"]
+   Guests: [reservedCount] / [capacity] ([% fill])
+   Type: [Public | Private Party]
+   Canvas size: [11×14 | 16×20 | 18×24]
+   Status: [Confirmed bookings count] confirmed booking(s)
+```
+
+If no classes are scheduled: "No classes scheduled today. Great day for studio prep or a staff training session!"
+
+---
+
+### 2. Revenue Forecast
+
+```
+Confirmed revenue today:  $[sum of totalInCents for confirmed bookings ÷ 100]
+Last [weekday] revenue:   $[comparison figure ÷ 100]
+Variance:                 [+/- $X and percentage]
+```
+
+Note if today is tracking above, on par, or below last week's same day.
+
+---
+
+### 3. Easel Prep
+
+```
+Total easels needed:  [sum of all guestCounts across today's sessions]
+By session:
+  [Time] — [Experience]: [guestCount] easels, [canvasSize] canvases
+```
+
+Include a reminder to pre-load paint palettes matched to each session's `colorPalette` attribute if available.
+
+---
+
+### 4. Inventory Alerts
+
+If any items are at or below reorder threshold:
+
+```
+⚠️  [Item name] — [quantity] remaining (threshold: [reorderThreshold])
+    Category: [category]
+```
+
+If all inventory is healthy: "All supplies are well-stocked. No reorder alerts."
+
+---
+
+### 5. Pre-Shift Action Checklist
+
+Generate a session-specific checklist. Always include the universal items; add session-specific items based on today's bookings.
+
+**Universal items:**
+- [ ] Canvases cut to size and labeled (one per confirmed seat)
+- [ ] Easels set up and tested for wobble
+- [ ] Paint stations stocked — squeeze bottles filled by color
+- [ ] Rinse cups filled with clean water
+- [ ] Aprons counted and accessible at each easel
+- [ ] Music playlist loaded and volume tested
+- [ ] POS float confirmed — till opened and counted
+- [ ] Studio floor swept and entrance presentable
+- [ ] Instructor demo easel set up at front with demo canvas
+
+**Session-specific additions (add based on data):**
+- If a Kids Paint Class is on the schedule: `[ ] Kids supply station set up separately — lower easels, student-grade paint, smocks accessible, non-alcoholic beverages only`
+- If a Private Party is on the schedule: `[ ] Custom party setup per client request — check booking notes for decor, arrangement, or catering`
+- If BYOB Date Night is on the schedule: `[ ] Wine glasses polished and set — two per easel station`
+- If any session has `colorPalette` set: `[ ] Paint palette pre-loaded for [paintingName] — colors: [colorPalette]`
+- If inventory alerts exist: `[ ] Place reorder for flagged items before end of shift`
+
+---
+
+## Tone Guidelines
+
+- **Warm and organized** — Like a studio manager who's genuinely excited about the day
+- **Specific, not generic** — Use actual class names, times, and guest counts from the data
+- **Actionable** — Every section ends with something staff can do right now
+- **Concise** — Briefing should be scannable in under 2 minutes on a tablet
+- **No filler** — If a section has no relevant data, say so briefly and move on
+
+## Output Format
+
+Produce the briefing as clean, readable markdown. Use headers, emoji sparingly for visual anchoring, and tables only where they genuinely aid clarity (e.g., multiple sessions side by side). The output should render well in both a web staff dashboard and a printed daily sheet.

package/kits/canvas-and-corks/skills/studio-expertise/SKILL.md

@@ -0,0 +1,181 @@
+---
+id: studio-expertise
+name: Studio Expertise
+description: Teaches the AI assistant deep knowledge about paint and sip studio operations, painting techniques, art mediums, skill levels, color palette language, and supply categories used at Canvas & Corks.
+type: background
+version: 1.0.0
+requiresVision: false
+requiresData: false
+---
+
+# Studio Expertise
+
+You are deeply familiar with the operations, instruction style, and vocabulary of **{{businessName}}**, a paint & sip studio. This document gives you the technical and operational knowledge needed to write accurate, authentic content, answer guest questions, and assist staff effectively.
+
+---
+
+## Painting Mediums
+
+### Acrylic (primary medium at Canvas & Corks)
+- **What it is**: Water-based polymer paint. Fast-drying (15–30 minutes for thin layers), opaque, lightfast.
+- **Why guests love it**: Forgiving — mistakes can be painted over once dry. No solvents. Easy cleanup with water.
+- **What instructors love**: Versatile. Works wet-on-wet for soft blends, dry-brushed for texture, layered for depth.
+- **Limitations**: Dries slightly darker than the wet color. Fast dry time requires working quickly or using a stay-wet palette.
+
+### Watercolor
+- **What it is**: Pigment suspended in a water-soluble binder. Transparent layers (glazes) build up color.
+- **Character**: Luminous, soft, ethereal. Water is the medium — more water = lighter value.
+- **Techniques**: Wet-on-wet (wet paper + wet paint = soft diffused edges), wet-on-dry (defined edges), glazing (layered transparent washes).
+- **Guest considerations**: Less forgiving than acrylic — lifting dried paint is possible but tricky. Best for guests comfortable with uncertainty.
+
+### Oil Paint
+- **What it is**: Pigment in linseed or walnut oil. Slow-drying (hours to weeks), highly blendable.
+- **Character**: Rich, buttery, luminous. Traditional fine art medium.
+- **Constraints**: Requires mineral spirits or odorless solvent for brush cleaning. Not suitable for ventilated indoor studio settings without specialized setup. Not standard at C&C.
+- **When referenced**: Occasionally used in advanced workshops or instructor demonstrations only.
+
+### Mixed Media
+- **Definition**: Combining two or more mediums or materials on a single canvas. Examples: acrylic base + watercolor glazes, collage elements + paint, ink drawing + acrylic washes.
+- **C&C use case**: Special theme classes, holiday workshops, kids' art camps.
+
+---
+
+## Core Acrylic Techniques Taught at C&C
+
+### Wet-on-Wet Blending
+Applying wet paint directly onto a still-wet layer to create soft, seamless transitions. Used for skies, water reflections, and gradient backgrounds. Requires working quickly before the first layer dries. Key to the dramatic sunset and ocean class styles.
+
+### Dry Brushing
+Using a brush loaded with a small amount of paint (excess removed on palette or paper towel) and dragging it lightly across the canvas. Produces a broken, textured stroke — ideal for grass, tree foliage, wood grain, and sea foam.
+
+### Blocking In
+Filling large areas of the canvas with approximate base colors before adding detail. The most important first step. Teaches guests to see the composition as shapes before committing to edges.
+
+### Color Mixing
+Combining paints on the palette to achieve desired hues, values, and temperatures. Key concepts:
+- **Primary → Secondary**: Red + Yellow = Orange, Blue + Yellow = Green, Red + Blue = Violet
+- **Tints**: Adding white to a hue raises its value (makes it lighter)
+- **Shades**: Adding black or a complementary color darkens a hue
+- **Warm/Cool**: Warm colors (red, orange, yellow) advance visually; cool colors (blue, green, purple) recede — used to create depth
+- **Neutralizing**: Mixing complementary colors (red + green, blue + orange) produces neutral browns/greys
+
+### Edge Work
+- **Hard edges**: Defined, crisp transitions. Used for foreground objects, architectural elements, text.
+- **Soft edges**: Gradual transitions. Used for distant backgrounds, skies, soft light. Achieved by blending wet-on-wet or feathering with a dry fan brush.
+- **Lost edges**: Where two areas of similar value meet and the edge "disappears." Used to create atmospheric depth.
+
+### Layering / Glazing (Acrylic)
+Applying transparent or semi-transparent layers over dry paint to build luminosity. Diluting acrylic paint heavily with water or glazing medium creates transparent layers that allow previous colors to show through.
+
+---
+
+## Skill Level Guidance
+
+Use these definitions consistently in class planning, session attributes, and copy.
+
+| Level | Description | Painting Complexity | Color Range | Brush Guidance |
+|---|---|---|---|---|
+| First timer | Never held a paintbrush or hasn't in 10+ years | Simple compositions, 2–3 dominant shapes, generous negative space | 2–3 colors max, pre-mixed | Large flat brush (3/4" or 1"), no detail brushes |
+| Beginner | Some casual painting experience | Can handle simple foreground/background split, basic horizon lines | 4–5 colors, some mixing | Flat and round brushes, minimal detail |
+| Intermediate | Comfortable with mixing, has completed 3–5 classes | Multi-layer compositions, basic perspective, simple portraits | Full palette, confident mixing | Full brush range, some detail brushes |
+| Advanced | Paints regularly outside of class | Complex compositions, fine detail, independent palette choices | Self-directed | All brush sizes, fan brush, palette knife |
+
+**Instructor principle**: Always plan to the First Timer. If a returning guest wants more challenge, give them a palette knife or an additional detail layer — never make first-timers feel behind.
+
+---
+
+## Color Palette Language
+
+Use these terms consistently in class descriptions, session attributes, and marketing copy.
+
+### Warm Tones
+Reds, oranges, yellows, golden browns. Evoke warmth, energy, sunset, autumn. Examples: cadmium orange, alizarin crimson, yellow ochre, burnt sienna.
+
+### Cool Tones
+Blues, greens, purples, silver-grey. Evoke calm, depth, water, winter, twilight. Examples: cerulean blue, phthalo green, dioxazine purple, Payne's grey.
+
+### Earth Tones
+Ochres, burnt siennas, raw umbers, mossy greens, terracotta. Grounded, natural, organic feeling. Often used in landscape and botanical classes.
+
+### Bright & Bold
+High chroma, high contrast palette. Often complementary color pairings (red/green, orange/blue). Pop-art inspired. High visual impact. Great for abstract and graphic classes.
+
+### Monochrome
+Single hue explored across its full value range (light tint to deep shade). Teaches value relationships. Elegant, sophisticated, accessible for first-timers.
+
+### Pastel
+Tints — hues mixed heavily with white. Soft, romantic, delicate. Popular for spring florals, Valentine's themes, baby shower paint parties. Reduced contrast.
+
+### Neutral
+Blacks, whites, greys, and earth tones as the dominant palette. Often used in charcoal-style or urban landscape classes.
+
+---
+
+## Beverage Program
+
+- **BYOB policy**: Guests are encouraged to bring their own wine, beer, or non-alcoholic beverages. Glasses and a corkscrew are always provided.
+- **Non-alcoholic options**: Always available and actively offered. Never assume a guest is drinking alcohol.
+- **Safety rule**: No glass containers directly on the easel or painting surface — wine glasses stay on the side table. Spills on canvases are part of the experience; spills on the floor are a slip risk.
+- **Timing**: Beverages are set up before guests arrive. The "cheers" moment at the start of class is a tradition.
+- **C&C upsell note**: Some locations offer curated wine packages or non-alcoholic beverages for purchase. Check local settings.
+
+---
+
+## Apron Protocol
+
+- Acrylic paint is **permanent on clothing** once dried — aprons are non-negotiable to offer.
+- Aprons are available for every guest at no charge. Always offer proactively.
+- Remind guests at check-in: "Acrylic doesn't wash out — here's your apron!"
+- Laundering: Aprons are washed after every use. Heavily stained aprons are replaced after 20 uses or when discolored beyond presentable.
+
+---
+
+## Standard Canvas Sizes
+
+| Size | Use Case | Typical Class |
+|---|---|---|
+| 11×14 | Beginner / short-format classes | Quick kids class, 60-min express session |
+| 16×20 | Standard guided class | Most adult guided paint classes |
+| 18×24 | Advanced / party classes | Private parties, artist workshops, showcase classes |
+
+Canvas type: Pre-stretched cotton canvas (gallery wrap, 0.75" profile) for most classes. Canvas boards used for kids classes and budget party packages.
+
+---
+
+## Inventory Categories
+
+These are the standard supply categories used in Canvas & Corks inventory tracking:
+
+| Category | Examples |
+|---|---|
+| `canvas` | 11×14, 16×20, 18×24 pre-stretched; canvas boards |
+| `paint` | Acrylic tubes and bottles by color family: primaries (red, yellow, blue), blacks & whites, earth tones, mediums |
+| `brush` | Fan (blending), flat (blocking), round (detail), detail (fine line) — organized by size |
+| `easel` | Tabletop A-frame easels; floor easels for advanced classes |
+| `apron` | Adult aprons; kids aprons |
+| `palette` | Disposable palette paper pads; reusable plastic palettes |
+| `beverage` | Wine glasses, bottled water, non-alcoholic beverages for purchase; corkscrews |
+| `supplies` | Brush rinse cups, paper towels, varnish spray (finishing), canvas labels, painter's tape |
+| `retail` | Take-home art kits, branded tote bags, gift cards, varnish spray retail units |
+
+---
+
+## Classroom Setup Standards
+
+- **Easel spacing**: Minimum 24" side-to-side between guests. Private parties may be arranged in U-shape for social energy.
+- **Lighting**: Bright, even, warm-white lighting. Avoid shadows across the canvas.
+- **Music**: Background instrumental music at conversational volume during instruction; can increase during open painting.
+- **Instructor position**: Front and center with a demonstration easel that all guests can see. Demo canvas is always the same painting.
+- **Color station**: Each guest has a palette, a rinse cup of water, and a paper towel square. Communal paint bottles are pre-loaded in squeeze bottles by color.
+- **Kids class setup**: Separate lower easel height. Tempera or student-grade acrylic. Smocks over aprons. Parent easels optional — not required.
+
+---
+
+## C&C Experience Types Quick Reference
+
+| Experience | Price | Duration | Guests | Key Features |
+|---|---|---|---|---|
+| Guided Paint Class | $45/person | 120 min | 1–30 | Step-by-step instructor, featured painting, BYOB |
+| Private Paint Party | $55/person | 150 min | 8–20 | Full studio buyout, custom painting choice, dedicated instructor |
+| Kids Paint Class | $28/person | 90 min | 5–12 yrs | Age-appropriate painting, parents welcome, non-alcoholic only |
+| BYOB Date Night | $40/person | 120 min | Pairs (2) | Side-by-side coordinating paintings, romantic setup |