@soulcraft/kits 1.0.0

package/kits/blog-series/skills/seo-review/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: SEO Review
+description: Audit a post for SEO optimization
+type: invocable
+version: "1.0.0"
+parameters: [postPath]
+---
+
+## SEO Review
+
+Audit a post for SEO optimization
+
+### Steps
+
+1. Check headline length and keyword inclusion
+2. Review meta description for length and appeal
+3. Verify keyword appears in first 100 words
+4. Check heading structure (H2s, H3s)
+5. Count internal and external links
+6. Verify all images have alt text
+7. Check URL slug is clean and keyword-rich
+8. Review content length vs competitors
+9. Check for featured snippet opportunities
+10. Generate SEO score and recommendations
+
+### Inputs Required
+
+- **postPath** (required): Path to post to review
+
+### Expected Outputs
+
+- SEO audit report
+- Improvement recommendations
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "SEO review"
+- "check SEO"
+- "optimize for search"
+- "SEO score"

package/kits/blog-series/skills/seo-writing/SKILL.md

@@ -0,0 +1,135 @@
+---
+name: seo-writing
+description: SEO optimization, keywords, meta descriptions, and search-friendly content structure
+type: invocable
+version: "1.0.0"
+---
+
+## SEO Writing Skill
+
+When the user invokes `/seo`, help them optimize their blog content for search engines while maintaining quality and readability.
+
+### Invocation Patterns
+
+- `/seo` - Full SEO analysis and recommendations
+- `/seo keywords` - Keyword research and placement
+- `/seo meta` - Optimize title and meta description
+- `/seo audit` - Technical SEO checklist
+
+### Keyword Strategy
+
+**Primary Keyword**
+- Main topic focus (1 per post)
+- Include in: title, H1, first 100 words, URL
+- Target density: 1-2% (natural occurrence)
+
+**Secondary Keywords**
+- Related terms and synonyms (3-5 per post)
+- Include in: subheadings, body text
+- Support semantic relevance
+
+**Long-Tail Keywords**
+- Specific phrases with less competition
+- Often form great subheadings
+- Answer specific questions
+
+### Content Structure for SEO
+
+**Title Tag (50-60 characters)**
+- Primary keyword near the beginning
+- Compelling and click-worthy
+- Include numbers when relevant ("7 Ways to...")
+
+**Meta Description (150-160 characters)**
+- Summarize the value proposition
+- Include primary keyword naturally
+- End with a call to action or curiosity hook
+
+**URL Structure**
+- Short and descriptive
+- Include primary keyword
+- Use hyphens to separate words
+- Avoid dates (evergreen URLs)
+
+**Heading Hierarchy**
+```
+H1: Main title (one per page)
+  H2: Major sections
+    H3: Subsections
+      H4: Details (if needed)
+```
+
+### Output Format
+
+```markdown
+## SEO Analysis: [Post Title]
+
+### Keyword Analysis
+**Primary Keyword**: [keyword]
+- Search volume: [if known]
+- Competition: [High/Medium/Low]
+- Current usage: [X times / Y% density]
+- Recommendation: [Adjust/Good]
+
+**Secondary Keywords**:
+| Keyword | Usage | Recommendation |
+|---------|-------|----------------|
+| [kw1] | X times | [Add more/Good] |
+| [kw2] | X times | [Add more/Good] |
+
+### Title & Meta Optimization
+**Current Title**: [title]
+- Length: X characters [Good/Too long/Too short]
+- Keyword position: [Good/Move earlier]
+**Suggested Title**: [optimized version]
+
+**Current Meta**: [description]
+- Length: X characters [Good/Too long/Too short]
+**Suggested Meta**: [optimized version]
+
+### Content Structure
+- Word count: X [Good/Expand/Trim]
+- H2 count: X [Good/Add more]
+- Keyword in H1: [Yes/No]
+- Keyword in first 100 words: [Yes/No]
+
+### Technical Checklist
+- [ ] URL includes keyword
+- [ ] Images have alt text
+- [ ] Internal links included
+- [ ] External authoritative links
+- [ ] Mobile-friendly formatting
+
+### Quick Wins
+1. [Specific action to improve SEO]
+2. [Specific action to improve SEO]
+3. [Specific action to improve SEO]
+```
+
+### SEO Best Practices
+
+**Content Quality Signals**
+- Comprehensive coverage (1500+ words for competitive topics)
+- Original research or unique insights
+- Updated content (freshness signals)
+- Low bounce rate indicators (engaging content)
+
+**Internal Linking**
+- Link to relevant pillar content
+- Use descriptive anchor text
+- Create topic clusters
+- 2-3 internal links per 1000 words
+
+**External Linking**
+- Link to authoritative sources
+- Support claims with evidence
+- Use rel="nofollow" for untrusted links
+
+### Common SEO Mistakes
+
+- Keyword stuffing (unnatural repetition)
+- Duplicate content
+- Thin content (under 300 words)
+- Missing alt text on images
+- Broken internal links
+- Slow page load from large images

package/kits/blog-series/skills/series-audit/SKILL.md

@@ -0,0 +1,36 @@
+---
+name: Series Audit
+description: Review blog series for completeness and quality
+type: invocable
+version: "1.0.0"
+---
+
+## Series Audit
+
+Review blog series for completeness and quality
+
+### Steps
+
+1. List all posts in the series
+2. Check each post for consistent formatting
+3. Verify internal linking between posts
+4. Check that series navigation is clear
+5. Review SEO across all posts
+6. Identify gaps in topic coverage
+7. Check call-to-action consistency
+8. Verify publishing schedule adherence
+9. Generate series health report
+
+### Expected Outputs
+
+- Series audit report
+- Gap analysis
+- Recommendations
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "audit series"
+- "series review"
+- "check series"
+- "series health"

package/kits/blog-series/skills/write-post-outline/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: Write Post Outline
+description: Create a structured outline for a blog post
+type: invocable
+version: "1.0.0"
+parameters: [topic]
+---
+
+## Write Post Outline
+
+Create a structured outline for a blog post
+
+### Steps
+
+1. Identify the primary keyword and search intent
+2. Research what's currently ranking for this topic
+3. Define the unique angle or value-add of your post
+4. Write a compelling headline (55-60 characters)
+5. Create the introduction hook (address the problem)
+6. Outline 3-5 main sections with H2 headings
+7. Add subsections and key points under each H2
+8. Plan the conclusion with call-to-action
+9. Write the meta description (150-160 characters)
+10. Create the post file from template
+
+### Inputs Required
+
+- **topic** (required): What is the post about?
+- **keyword** (optional): Primary keyword to target
+
+### Expected Outputs
+
+- Post outline file
+- Headline and meta description
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "outline post"
+- "plan post"
+- "new blog post"
+- "write about"

package/kits/business-plan/kit.json

@@ -0,0 +1,437 @@
+{
+  "$schema": "https://soulcraft.com/schemas/kit/v2.json",
+  "id": "business-plan",
+  "type": "soulcraft",
+  "role": "primary",
+  "status": "released",
+  "name": "Business Plan",
+  "description": "Comprehensive business plan for startups, funding applications, or strategic planning",
+  "longDescription": "Create a professional business plan with all the sections banks, investors, and accelerators expect. Includes financial projections templates, market analysis frameworks, and AI assistance for strategic thinking. Perfect for SBA loans, startup accelerators, or internal planning.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Soulcraft Labs",
+    "email": "kits@soulcraft.com",
+    "url": "https://soulcraft.com"
+  },
+  "icon": "📋",
+  "tags": [
+    "business",
+    "strategy",
+    "planning",
+    "startup",
+    "funding",
+    "sba",
+    "loan"
+  ],
+  "variables": [
+    {
+      "key": "projectName",
+      "label": "Business Name",
+      "description": "The name of your business",
+      "type": "string",
+      "required": true,
+      "example": "Acme Inc"
+    },
+    {
+      "key": "industry",
+      "label": "Industry",
+      "description": "Your primary industry",
+      "type": "string",
+      "required": false,
+      "example": "SaaS / E-commerce / Healthcare"
+    },
+    {
+      "key": "stage",
+      "label": "Business Stage",
+      "description": "Current stage of the business",
+      "type": "string",
+      "required": false,
+      "example": "Startup"
+    },
+    {
+      "key": "planPurpose",
+      "label": "Plan Purpose",
+      "description": "What is this plan for? (funding, bank loan, internal planning)",
+      "type": "string",
+      "required": false,
+      "example": "Seed funding"
+    }
+  ],
+  "shared": {
+    "industry": "business-strategy",
+    "category": "business",
+    "glossary": {},
+    "aiExpertise": [
+      "Business strategy and planning",
+      "Financial modeling and projections",
+      "Market analysis and research",
+      "Competitive analysis",
+      "Investor and lender requirements"
+    ],
+    "dataModelHints": [
+      "document",
+      "thing",
+      "event",
+      "topic"
+    ],
+    "dataModel": {
+      "entities": [
+        {
+          "domain": "section",
+          "type": "Document",
+          "description": "A named section of the business plan document",
+          "products": {
+            "workshop": {
+              "view": "tree",
+              "icon": "📄"
+            },
+            "academy": {
+              "mapsTo": "learning-artifact",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "competitor",
+          "type": "Concept",
+          "description": "A competing business in the same market",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "🏢"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "market-segment",
+          "type": "Concept",
+          "description": "A defined group of target customers",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "🎯"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "risk",
+          "type": "Concept",
+          "description": "A potential threat to business success with mitigation",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "⚠️"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "milestone",
+          "type": "Event",
+          "description": "A key business goal or launch event on the timeline",
+          "products": {
+            "workshop": {
+              "view": "timeline",
+              "icon": "🏁"
+            },
+            "academy": {
+              "mapsTo": "practice-session",
+              "assessable": true
+            }
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "section",
+          "to": "section",
+          "verb": "Precedes",
+          "description": "Document section ordering"
+        },
+        {
+          "from": "section",
+          "to": "risk",
+          "verb": "Analyzes",
+          "description": "Section covers this risk or topic"
+        },
+        {
+          "from": "competitor",
+          "to": "market-segment",
+          "verb": "Targets",
+          "description": "Competitor serves this market segment"
+        }
+      ]
+    },
+    "suggestions": [
+      {
+        "label": "Write executive summary",
+        "prompt": "Help me write the executive summary section"
+      },
+      {
+        "label": "Analyze the market",
+        "prompt": "Help me research and write the market analysis section"
+      },
+      {
+        "label": "Build financial projections",
+        "prompt": "Help me create financial projections for my business plan"
+      },
+      {
+        "label": "Define value proposition",
+        "prompt": "Help me articulate my unique value proposition"
+      },
+      {
+        "label": "Check completeness",
+        "prompt": "Check my business plan for completeness and identify missing sections"
+      },
+      {
+        "label": "Review plan structure",
+        "prompt": "Show me my business plan structure and what sections need work"
+      }
+    ]
+  },
+  "academy": {
+    "skillPath": "entrepreneurship",
+    "level": "intermediate",
+    "learningObjectives": [
+      "Conduct a market sizing analysis using TAM/SAM/SOM methodology with cited sources",
+      "Build a three-year financial model with revenue projections, cost structure, and break-even analysis",
+      "Write an executive summary that captures the opportunity, solution, and ask in under two pages",
+      "Perform a competitive landscape assessment and articulate a defensible value proposition",
+      "Structure a funding request with a specific use-of-funds breakdown"
+    ],
+    "assessmentTypes": [
+      "portfolio",
+      "peer-review"
+    ],
+    "certificationSlug": "business-planner"
+  },
+  "workshop": {
+    "difficulty": "advanced",
+    "templateTier": 4,
+    "aiPersona": {
+      "role": "You are an expert business strategist and financial advisor helping entrepreneurs create professional business plans for investors, banks, and accelerators.",
+      "expertise": [
+        "Business plan writing and structure",
+        "Financial projections and modeling",
+        "Market analysis and sizing",
+        "Competitive landscape assessment",
+        "SBA and investor requirements"
+      ],
+      "tone": "mentor"
+    },
+    "workspaceConfig": {
+      "paradigm": "writer",
+      "defaultTab": "edit",
+      "defaultView": "tree",
+      "defaultFile": "sections/01-executive-summary.md",
+      "fallbackFiles": [
+        "README.md"
+      ],
+      "layout": {
+        "leftDock": "files",
+        "rightDock": "properties"
+      },
+      "onboarding": {
+        "showGuide": true,
+        "highlightFeatures": [
+          "tree",
+          "export",
+          "ai-chat"
+        ],
+        "suggestedActions": [
+          "Start with Company Description section",
+          "Complete Market Analysis with real research data",
+          "Build financial projections for 3-5 years",
+          "Write Executive Summary last (it summarizes everything)",
+          "Use AI Chat to help refine each section"
+        ]
+      }
+    },
+    "graphGuidance": {
+      "conceptCreation": {
+        "triggers": [
+          "User defines a new market segment",
+          "User identifies a competitor",
+          "User creates a financial projection",
+          "User defines a risk"
+        ],
+        "typeMapping": {
+          "section": "document",
+          "competitor": "organization",
+          "market-segment": "category",
+          "risk": "concept",
+          "milestone": "event"
+        }
+      },
+      "relationshipPatterns": [
+        {
+          "from": "document",
+          "to": "document",
+          "verb": "precedes",
+          "description": "Section order"
+        },
+        {
+          "from": "document",
+          "to": "concept",
+          "verb": "analyzes",
+          "description": "Section covers topic"
+        },
+        {
+          "from": "organization",
+          "to": "category",
+          "verb": "targets",
+          "description": "Competitor serves market"
+        }
+      ]
+    },
+    "qualityGates": {
+      "fileChecks": [
+        {
+          "path": "sections/01-executive-summary.md",
+          "required": [
+            "Business Overview",
+            "Market Opportunity",
+            "Financial Summary",
+            "Funding Request"
+          ],
+          "optional": [
+            "Mission Statement"
+          ]
+        },
+        {
+          "path": "sections/03-market-analysis.md",
+          "required": [
+            "Market Size",
+            "Target Market",
+            "Competition"
+          ],
+          "optional": [
+            "SWOT",
+            "Industry Trends"
+          ]
+        },
+        {
+          "path": "financials/projections.md",
+          "required": [
+            "Revenue Projections",
+            "Cost Structure",
+            "P&L"
+          ],
+          "optional": [
+            "Cash Flow",
+            "Break-even"
+          ]
+        }
+      ],
+      "projectChecks": [
+        "All 9 main sections have content",
+        "Market size is calculated with sources",
+        "Financial projections cover 3 years",
+        "Funding request is specific with use of funds",
+        "Executive summary is complete (written last)"
+      ],
+      "exportReady": [
+        "All sections complete",
+        "Financial tables formatted",
+        "Sources cited",
+        "Executive summary finalized"
+      ]
+    },
+    "exporters": [
+      {
+        "id": "business-plan-pdf",
+        "name": "Business Plan (PDF)",
+        "description": "Professional PDF for investors and banks",
+        "icon": "📄",
+        "format": "pdf",
+        "category": "document",
+        "handler": "wdoc-pdf",
+        "options": {
+          "includeFiles": [
+            "sections/*.md",
+            "financials/*.md"
+          ],
+          "combineFiles": true,
+          "formatting": {
+            "font": "Georgia",
+            "fontSize": 11,
+            "lineSpacing": 1.5
+          }
+        }
+      },
+      {
+        "id": "business-plan-docx",
+        "name": "Business Plan (Word)",
+        "description": "Editable Word document",
+        "icon": "📝",
+        "format": "docx",
+        "category": "document",
+        "handler": "wdoc-docx",
+        "options": {
+          "includeFiles": [
+            "sections/*.md",
+            "financials/*.md"
+          ],
+          "combineFiles": true
+        }
+      },
+      {
+        "id": "executive-summary-pdf",
+        "name": "Executive Summary Only",
+        "description": "Standalone executive summary",
+        "icon": "📋",
+        "format": "pdf",
+        "category": "document",
+        "handler": "wdoc-pdf",
+        "options": {
+          "includeFiles": [
+            "sections/01-executive-summary.md"
+          ]
+        }
+      },
+      {
+        "id": "business-plan-bundle",
+        "name": "Complete Bundle",
+        "description": "All documents including appendix",
+        "icon": "📦",
+        "format": "zip",
+        "category": "archive",
+        "handler": "markdown-bundle",
+        "options": {
+          "includeFiles": [
+            "**/*.md"
+          ],
+          "preserveStructure": true
+        }
+      }
+    ],
+    "exportStructure": {
+      "combineStrategy": "graph-order",
+      "orderRelationship": "precedes",
+      "includePatterns": [
+        "sections/*.md",
+        "financials/*.md"
+      ],
+      "excludePatterns": [
+        "appendix/*",
+        "research/*"
+      ]
+    },
+    "exportPreferences": {
+      "defaultExporter": "business-plan-pdf",
+      "fileNameTemplate": "{{projectName}}-business-plan-{{date}}",
+      "instructions": "Write the Executive Summary last after all other sections are complete."
+    }
+  }
+}