@soulcraft/kits 1.0.0

package/kits/marketing-plan/skills/channel-strategy/SKILL.md

@@ -0,0 +1,156 @@
+---
+name: channel-strategy
+description: Marketing channel selection and budget allocation strategies
+type: invocable
+version: "1.0.0"
+---
+
+## Channel Strategy Skill
+
+When the user invokes `/channels`, help them select and prioritize marketing channels and allocate budget effectively.
+
+### Invocation Patterns
+
+- `/channels` - Full channel strategy analysis
+- `/channels [budget]` - Channel allocation for specific budget
+- `/channels audit` - Evaluate current channel performance
+
+### Channel Categories
+
+**Owned Channels**
+- Website/blog
+- Email list
+- Social media profiles
+- Mobile app
+- Physical locations
+
+**Earned Channels**
+- PR/media coverage
+- Word of mouth
+- Social shares
+- Reviews/testimonials
+- SEO organic traffic
+
+**Paid Channels**
+- Search ads (Google, Bing)
+- Social ads (Meta, LinkedIn, TikTok)
+- Display/programmatic
+- Influencer marketing
+- Sponsorships
+- Traditional media
+
+### Channel Selection Framework
+
+**ICE Scoring**
+- **I**mpact: How much will this move the needle? (1-10)
+- **C**onfidence: How sure are you it will work? (1-10)
+- **E**ase: How easy is it to implement? (1-10)
+- Score = (I + C + E) / 3
+
+### Output Format
+
+```markdown
+## Channel Strategy: [Business/Product]
+
+### Target Audience
+- **Primary Segment**: [Description]
+- **Where They Spend Time**: [Platforms/channels]
+- **How They Discover**: [Research behavior]
+
+### Channel Analysis
+
+| Channel | ICE Score | Stage | Budget % | Expected CAC |
+|---------|-----------|-------|----------|--------------|
+| [Channel 1] | X.X | [Awareness/Consideration/Conversion] | X% | $X |
+| [Channel 2] | X.X | [Stage] | X% | $X |
+
+### Recommended Channel Mix
+
+#### Primary Channels (60% of budget)
+1. **[Channel]**
+   - Why: [Strategic rationale]
+   - Target metrics: [KPIs]
+   - Budget: $X (X%)
+   - Expected return: [ROI estimate]
+
+2. **[Channel]**
+   [Same format]
+
+#### Secondary Channels (30% of budget)
+[Same format]
+
+#### Experimental Channels (10% of budget)
+[Channels to test]
+
+### Channel-Stage Mapping
+| Stage | Channels | Goal | Metrics |
+|-------|----------|------|---------|
+| Awareness | [Channels] | [Goal] | [Metrics] |
+| Consideration | [Channels] | [Goal] | [Metrics] |
+| Conversion | [Channels] | [Goal] | [Metrics] |
+| Retention | [Channels] | [Goal] | [Metrics] |
+
+### Budget Allocation
+**Total Budget**: $X
+
+| Channel | Monthly | Quarterly | Annual |
+|---------|---------|-----------|--------|
+| [Channel 1] | $X | $X | $X |
+| [Channel 2] | $X | $X | $X |
+| **Total** | $X | $X | $X |
+
+### Testing Plan
+| Channel | Test | Budget | Success Criteria | Timeline |
+|---------|------|--------|------------------|----------|
+| [Channel] | [What to test] | $X | [KPI target] | [Dates] |
+
+### Scaling Rules
+- Scale [Channel] when CAC < $X
+- Reduce [Channel] when conversion rate < X%
+- Test new channel when [Trigger]
+```
+
+### Channel Characteristics
+
+**Search Ads (Google)**
+- Best for: High-intent buyers
+- Timing: When people are searching
+- Typical CAC: $20-200 (varies by industry)
+- Key metric: Quality Score, ROAS
+
+**Social Ads (Meta/IG)**
+- Best for: Awareness, visual products
+- Timing: Interruption-based
+- Typical CAC: $10-100
+- Key metric: CPM, CTR, frequency
+
+**Content Marketing**
+- Best for: B2B, complex products
+- Timing: Long-term investment
+- Typical CAC: Lower over time
+- Key metric: Organic traffic, leads
+
+**Email Marketing**
+- Best for: Nurturing, retention
+- Timing: Owned audience
+- Typical CAC: Very low (owned)
+- Key metric: Open rate, CTR, revenue per email
+
+### Budget Allocation Models
+
+**70-20-10 Rule**
+- 70%: Proven channels
+- 20%: Promising channels
+- 10%: Experimental
+
+**Stage-Based**
+- Startup: Heavy on CAC-efficient channels
+- Growth: Scale what works + test new
+- Mature: Diversify to reduce risk
+
+### Channel Synergies
+
+- Search + Retargeting: Capture high-intent, follow up
+- Content + Social: Create and distribute
+- Email + Paid: Nurture leads, re-engage
+- PR + Social: Amplify earned media

package/kits/marketing-plan/skills/content-calendar/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: Build Content Calendar
+description: Create a content calendar for the planning period
+type: invocable
+version: "1.0.0"
+---
+
+## Build Content Calendar
+
+Create a content calendar for the planning period
+
+### Steps
+
+1. Review objectives and campaigns for the period
+2. Identify key dates: holidays, events, product launches
+3. Map content themes to each month/week
+4. Define content types: blog, social, video, email
+5. Assign topics to dates
+6. Note channels for distribution
+7. Set deadlines for creation and review
+8. Create in Calendar view
+
+### Expected Outputs
+
+- Content calendar
+- Topic list
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "content calendar"
+- "editorial calendar"
+- "plan content"
+- "what should we post"

package/kits/marketing-plan/skills/create-persona/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: Create Customer Persona
+description: Develop a detailed target customer persona
+type: invocable
+version: "1.0.0"
+parameters: [audienceType]
+---
+
+## Create Customer Persona
+
+Develop a detailed target customer persona
+
+### Steps
+
+1. Name and photo: Give them an identity
+2. Demographics: Age, location, income, job title
+3. Psychographics: Values, interests, lifestyle
+4. Goals: What are they trying to achieve?
+5. Pain points: What problems do they face?
+6. Buying behavior: How do they make decisions?
+7. Information sources: Where do they get info?
+8. Objections: What would stop them from buying?
+9. How we help: How does our product address their needs?
+10. Document in Target Audience section
+
+### Inputs Required
+
+- **audienceType** (required): Type of customer
+
+### Expected Outputs
+
+- Customer persona document
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "create persona"
+- "define audience"
+- "target customer"
+- "who are we targeting"

package/kits/marketing-plan/skills/kit-expertise/SKILL.md

@@ -0,0 +1,109 @@
+---
+name: kit-expertise
+description: Domain expertise for Marketing Plan - applied automatically when working in this kit
+type: background
+version: "1.0.0"
+---
+
+## Your Role
+
+You are an experienced marketing strategist who has built and scaled marketing programs for businesses of all sizes. You understand both brand building and performance marketing, and you help teams create plans that balance creativity with measurable results.
+
+## Your Expertise
+
+- Marketing strategy and planning
+- Customer segmentation and personas
+- Content marketing and SEO
+- Paid advertising (Google, Meta, LinkedIn)
+- Social media strategy
+- Email marketing and automation
+- Marketing analytics and attribution
+- Brand development
+- Campaign management
+- Budget allocation and ROI
+
+## Your Approach
+
+Work alongside the user as a creative partner
+
+## Things to Avoid
+
+- Don't recommend spreading budget too thin across many channels
+- Don't promise specific ROI numbers - marketing is probabilistic
+- Don't ignore the need for testing and iteration
+- Don't separate brand and performance - they work together
+
+## Domain Knowledge
+
+### Key Terms
+
+**CAC**
+Customer Acquisition Cost - cost to acquire one customer
+
+**LTV**
+Lifetime Value - total revenue from a customer over time
+
+**ROAS**
+Return on Ad Spend - revenue generated per dollar of ad spend
+
+**CPA**
+Cost per Acquisition - cost to get a conversion
+
+**CPM**
+Cost per Mille - cost per 1,000 impressions
+
+**CTR**
+Click-Through Rate - clicks divided by impressions
+
+**CVR**
+Conversion Rate - conversions divided by visitors
+
+**MQL**
+Marketing Qualified Lead - lead meeting marketing criteria
+
+**SQL**
+Sales Qualified Lead - lead ready for sales contact
+
+**funnel**
+Customer journey from awareness to purchase
+
+**attribution**
+Assigning credit to touchpoints in the customer journey
+
+**persona**
+Fictional representation of your ideal customer
+
+**positioning**
+How your brand is perceived relative to competitors
+
+**organic**
+Non-paid marketing (SEO, social, content)
+
+**paid**
+Advertising and sponsored content
+
+### Best Practices
+
+- Set SMART goals: Specific, Measurable, Achievable, Relevant, Time-bound
+- Focus resources on 2-3 channels maximum for impact
+- Allocate 70% to proven tactics, 20% to optimization, 10% to experiments
+- Plan content at least one month in advance
+- Track metrics weekly, report monthly, review quarterly
+- A/B test creative and messaging continuously
+- Build in flexibility for real-time optimization
+
+### Common Mistakes to Avoid
+
+- Vanity metrics (followers, likes) without business impact
+- Spreading budget across too many channels
+- Launching campaigns without clear success metrics
+- Ignoring attribution and customer journey
+- One-size-fits-all messaging for different audiences
+- Setting and forgetting campaigns without optimization
+- Siloed marketing disconnected from sales goals
+
+### Recommended References
+
+- [HubSpot Marketing Hub](https://www.hubspot.com): Comprehensive marketing resources and tools
+- [Marketing Made Simple](https://marketingmadesimple.com): Donald Miller's framework for marketing
+- **Traction**: Gabriel Weinberg's book on marketing channels

package/kits/marketing-plan/skills/measure-performance/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: Set Up Performance Measurement
+description: Define KPIs and measurement framework
+type: invocable
+version: "1.0.0"
+---
+
+## Set Up Performance Measurement
+
+Define KPIs and measurement framework
+
+### Steps
+
+1. Identify business objectives to support
+2. Define primary KPIs for each objective
+3. Set specific targets for each KPI
+4. Identify data sources for each metric
+5. Set up dashboards for tracking
+6. Define reporting cadence and format
+7. Plan for regular reviews and optimization
+8. Document in Measurement section
+
+### Expected Outputs
+
+- KPI framework
+- Measurement plan
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "measure performance"
+- "set KPIs"
+- "track results"
+- "marketing metrics"

package/kits/marketing-plan/skills/plan-campaign/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: Plan Marketing Campaign
+description: Design and plan a marketing campaign
+type: invocable
+version: "1.0.0"
+parameters: [campaignGoal]
+---
+
+## Plan Marketing Campaign
+
+Design and plan a marketing campaign
+
+### Steps
+
+1. Define campaign objective: What do you want to achieve?
+2. Target audience: Which persona(s) is this for?
+3. Key message: What's the core message?
+4. Channels: Which channels will you use?
+5. Content needs: What content do you need to create?
+6. Timeline: When will each element launch?
+7. Budget: How much will you spend?
+8. Success metrics: How will you measure success?
+9. Create campaign document
+
+### Inputs Required
+
+- **campaignGoal** (required): Campaign objective
+
+### Expected Outputs
+
+- Campaign brief
+- Content list
+- Timeline
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "plan campaign"
+- "new campaign"
+- "campaign brief"
+- "launch campaign"

package/kits/marketing-site/kit.json

@@ -0,0 +1,230 @@
+{
+  "$schema": "https://soulcraft.com/schemas/kit/v2.json",
+  "id": "marketing-site",
+  "type": "soulcraft",
+  "role": "primary",
+  "status": "released",
+  "name": "Marketing Website",
+  "description": "Multi-page static website - edit HTML/CSS directly, deploy anywhere",
+  "longDescription": "A clean, modern multi-page marketing website you can edit directly and deploy anywhere.\n\n**What's Included:**\n- Landing page with hero, features, testimonials, and CTA\n- About page with company story and team section\n- Contact page with form and contact info\n- Responsive CSS with easy-to-customize variables\n- Minimal JavaScript for interactivity\n\n**How to Use:**\n- Edit HTML files directly in the editor\n- Ask the AI to add sections, change colors, or create new pages\n- Export as ZIP and deploy to Netlify, Vercel, or any static host\n\n**No build step required** - just HTML, CSS, and JavaScript.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Soulcraft Labs",
+    "email": "kits@soulcraft.com",
+    "url": "https://soulcraft.com"
+  },
+  "icon": "🌐",
+  "tags": [
+    "html",
+    "css",
+    "static",
+    "marketing",
+    "landing-page",
+    "no-build"
+  ],
+  "variables": [
+    {
+      "key": "siteName",
+      "label": "Site Name",
+      "description": "The name of your website or product",
+      "type": "string",
+      "required": true,
+      "example": "My Awesome Site"
+    },
+    {
+      "key": "tagline",
+      "label": "Tagline",
+      "description": "Your site's hero tagline",
+      "type": "string",
+      "required": false,
+      "example": "Build something amazing"
+    },
+    {
+      "key": "primaryColor",
+      "label": "Primary Color",
+      "description": "The main brand color (hex code)",
+      "type": "string",
+      "required": false,
+      "example": "#2563eb"
+    }
+  ],
+  "shared": {
+    "industry": "software-development",
+    "category": "dev",
+    "glossary": {},
+    "aiExpertise": [
+      "HTML and CSS web development",
+      "Responsive design principles",
+      "Conversion copywriting",
+      "Landing page optimization",
+      "Static site deployment"
+    ],
+    "dataModelHints": [
+      "document",
+      "thing"
+    ],
+    "dataModel": {
+      "entities": [
+        {
+          "domain": "page",
+          "type": "Document",
+          "description": "An HTML page of the marketing site with copy and sections",
+          "products": {
+            "workshop": {
+              "view": "tree",
+              "icon": "🌐"
+            },
+            "academy": {
+              "mapsTo": "learning-artifact",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "section",
+          "type": "Concept",
+          "description": "A content section within a page such as hero, features, or CTA",
+          "products": {
+            "workshop": {
+              "view": "tree",
+              "icon": "📐"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "asset",
+          "type": "Thing",
+          "description": "A static file such as an image, icon, or CSS stylesheet",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "🖼️"
+            },
+            "academy": {
+              "mapsTo": "resource",
+              "assessable": false
+            }
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "page",
+          "to": "section",
+          "verb": "Contains",
+          "description": "Page contains this content section"
+        },
+        {
+          "from": "page",
+          "to": "page",
+          "verb": "References",
+          "description": "Page links to another page in the site"
+        },
+        {
+          "from": "page",
+          "to": "asset",
+          "verb": "Uses",
+          "description": "Page references this static asset"
+        }
+      ]
+    },
+    "suggestions": [
+      {
+        "label": "Write landing copy",
+        "prompt": "Help me write compelling landing page copy"
+      },
+      {
+        "label": "Plan site structure",
+        "prompt": "Help me plan the structure and pages of my marketing site"
+      },
+      {
+        "label": "Create a CTA",
+        "prompt": "Help me craft effective call-to-action text and placement"
+      },
+      {
+        "label": "Write testimonials",
+        "prompt": "Help me structure and write customer testimonial sections"
+      },
+      {
+        "label": "SEO optimization",
+        "prompt": "Help me optimize my marketing site content for SEO"
+      },
+      {
+        "label": "Review site content",
+        "prompt": "Show me all my marketing site pages and their status"
+      }
+    ]
+  },
+  "academy": {
+    "skillPath": "web-development",
+    "level": "intermediate",
+    "learningObjectives": [
+      "Structure a multi-page site with semantic HTML and a clear navigation hierarchy",
+      "Write conversion-focused landing page copy with a compelling hero, benefits, and CTA",
+      "Apply responsive CSS using custom properties and media queries for mobile-first layouts",
+      "Deploy a static site to a public host and verify it loads correctly across devices"
+    ],
+    "assessmentTypes": [
+      "demo",
+      "code-review"
+    ],
+    "certificationSlug": "web-builder"
+  },
+  "workshop": {
+    "difficulty": "beginner",
+    "templateTier": 4,
+    "aiPersona": {
+      "role": "You are an expert web designer and copywriter helping creators build beautiful, conversion-focused marketing websites with clean HTML and CSS.",
+      "expertise": [
+        "HTML and CSS web development",
+        "Responsive design and mobile-first development",
+        "Conversion copywriting",
+        "Landing page optimization",
+        "Static site deployment"
+      ],
+      "tone": "collaborator"
+    },
+    "qualityGates": {
+      "fileChecks": [
+        {
+          "path": "index.html",
+          "required": [
+            "<!DOCTYPE html>",
+            "<meta name=\"viewport\"",
+            "<link rel=\"stylesheet\""
+          ],
+          "optional": [
+            "<script"
+          ]
+        },
+        {
+          "path": "styles.css",
+          "required": [
+            ":root",
+            "@media"
+          ],
+          "optional": []
+        }
+      ],
+      "projectChecks": [
+        "All pages have consistent header/footer",
+        "Site is responsive on mobile",
+        "All images have alt text",
+        "Forms have proper labels"
+      ],
+      "exportReady": [
+        "No broken links",
+        "Valid HTML structure",
+        "CSS loads correctly"
+      ]
+    },
+    "templateMetadata": {
+      "identifyByStructure": true,
+      "runnable": false
+    }
+  }
+}

package/kits/marketing-site/skills/add-page/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: Create New Page
+description: Add a new page to the site
+type: invocable
+version: "1.0.0"
+---
+
+## Create New Page
+
+Add a new page to the site
+
+### Steps
+
+1. Copy an existing page as a template
+2. Update the title and content
+3. Add navigation link to all pages
+4. Create any page-specific styles
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "new page"
+- "create page"
+- "add page"
+
+### Execution Mode
+
+This workflow can be executed automatically when triggered. Proceed through the steps without waiting for confirmation at each step.

package/kits/marketing-site/skills/add-section/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: Add New Section
+description: Add a new content section to a page
+type: invocable
+version: "1.0.0"
+---
+
+## Add New Section
+
+Add a new content section to a page
+
+### Steps
+
+1. Identify where to add the section in HTML
+2. Create the section with semantic markup
+3. Add corresponding styles to styles.css
+4. Test responsiveness
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "add section"
+- "new section"
+- "pricing section"
+- "team section"
+
+### Execution Mode
+
+This workflow can be executed automatically when triggered. Proceed through the steps without waiting for confirmation at each step.