@soulcraft/kits 1.0.0

package/kits/blog-series/kit.json

@@ -0,0 +1,363 @@
+{
+  "$schema": "https://soulcraft.com/schemas/kit/v2.json",
+  "id": "blog-series",
+  "type": "soulcraft",
+  "role": "primary",
+  "status": "released",
+  "name": "Blog Series",
+  "description": "Multi-part blog series with editorial calendar and SEO optimization",
+  "longDescription": "Plan and write a comprehensive blog series with content strategy, SEO keywords, publishing schedule, and cross-linking between posts.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Soulcraft Labs",
+    "email": "kits@soulcraft.com",
+    "url": "https://soulcraft.com"
+  },
+  "icon": "✍️",
+  "tags": [
+    "blogging",
+    "content",
+    "seo",
+    "writing"
+  ],
+  "variables": [
+    {
+      "key": "projectName",
+      "label": "Series Title",
+      "description": "The title of your blog series",
+      "type": "string",
+      "required": true,
+      "example": "Complete Guide to Web Development"
+    },
+    {
+      "key": "author",
+      "label": "Author",
+      "description": "The author's name",
+      "type": "string",
+      "required": false,
+      "example": "Your Name"
+    },
+    {
+      "key": "targetAudience",
+      "label": "Target Audience",
+      "description": "Who you are writing for",
+      "type": "string",
+      "required": false,
+      "example": "Junior developers"
+    }
+  ],
+  "shared": {
+    "industry": "content-marketing",
+    "category": "creative",
+    "glossary": {},
+    "aiExpertise": [
+      "Content strategy and planning",
+      "SEO optimization techniques",
+      "Editorial calendar management",
+      "Audience engagement",
+      "Content series structuring"
+    ],
+    "dataModelHints": [
+      "document",
+      "topic",
+      "event"
+    ],
+    "dataModel": {
+      "entities": [
+        {
+          "domain": "post",
+          "type": "Document",
+          "description": "A single blog post within the series",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "📝"
+            },
+            "academy": {
+              "mapsTo": "learning-artifact",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "topic",
+          "type": "Concept",
+          "description": "A subject or theme that posts explore",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "💡"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "category",
+          "type": "Concept",
+          "description": "A broad category grouping related posts",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "🏷️"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "keyword",
+          "type": "Concept",
+          "description": "An SEO keyword targeted by one or more posts",
+          "products": {
+            "workshop": {
+              "view": "stats",
+              "icon": "🔑"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "audience",
+          "type": "Concept",
+          "description": "A reader segment the series is written for",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "👥"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": false
+            }
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "post",
+          "to": "category",
+          "verb": "InstanceOf",
+          "description": "Post belongs to this category"
+        },
+        {
+          "from": "post",
+          "to": "keyword",
+          "verb": "References",
+          "description": "Post targets this SEO keyword"
+        },
+        {
+          "from": "post",
+          "to": "post",
+          "verb": "RelatedTo",
+          "description": "Posts are part of the same series"
+        },
+        {
+          "from": "post",
+          "to": "audience",
+          "verb": "References",
+          "description": "Post is written for this audience segment"
+        }
+      ]
+    },
+    "suggestions": [
+      {
+        "label": "Plan a blog post",
+        "prompt": "Help me plan and outline a new blog post"
+      },
+      {
+        "label": "Write a draft",
+        "prompt": "Help me write a draft for my next blog post"
+      },
+      {
+        "label": "Generate topic ideas",
+        "prompt": "Brainstorm new blog topic ideas based on my existing content"
+      },
+      {
+        "label": "Improve SEO",
+        "prompt": "Review my blog posts and suggest SEO improvements"
+      },
+      {
+        "label": "Create content calendar",
+        "prompt": "Help me create a publishing schedule for my blog series"
+      },
+      {
+        "label": "Review my posts",
+        "prompt": "Show me all my blog posts and their current status"
+      }
+    ]
+  },
+  "academy": {
+    "skillPath": "content-creation",
+    "level": "beginner",
+    "learningObjectives": [
+      "Plan a multi-part blog series with a unifying thesis and logical post sequence",
+      "Research and integrate primary SEO keywords into headlines and body copy naturally",
+      "Write introductions that hook readers and establish the value of reading on",
+      "Build an editorial calendar and maintain a consistent publishing cadence"
+    ],
+    "assessmentTypes": [
+      "portfolio",
+      "peer-review"
+    ],
+    "certificationSlug": "blog-writer"
+  },
+  "workshop": {
+    "difficulty": "beginner",
+    "templateTier": 4,
+    "aiPersona": {
+      "role": "You are an expert content strategist and SEO writer helping creators plan, write, and publish successful blog series.",
+      "expertise": [
+        "Content strategy",
+        "SEO and keyword research",
+        "Editorial calendar planning",
+        "Blog writing and editing",
+        "Audience development"
+      ],
+      "tone": "collaborator"
+    },
+    "workspaceConfig": {
+      "paradigm": "writer",
+      "defaultTab": "edit",
+      "defaultView": "calendar",
+      "defaultFile": "posts/01-intro.md",
+      "fallbackFiles": [
+        "planning/content-strategy.md",
+        "README.md"
+      ],
+      "layout": {
+        "leftDock": "files",
+        "rightDock": "properties"
+      },
+      "onboarding": {
+        "showGuide": true,
+        "highlightFeatures": [
+          "calendar",
+          "ai-chat"
+        ],
+        "suggestedActions": [
+          "Define your content strategy first",
+          "Plan your post schedule in Calendar view",
+          "Write your first post using the template",
+          "Ask AI to help with headlines and SEO"
+        ]
+      }
+    },
+    "graphGuidance": {
+      "conceptCreation": {
+        "triggers": [
+          "When user creates a new blog post",
+          "When user defines a topic or category",
+          "When user identifies a target keyword",
+          "When user mentions an audience segment"
+        ],
+        "typeMapping": {
+          "post": "document",
+          "topic": "concept",
+          "category": "concept",
+          "keyword": "concept",
+          "audience": "socialGroup"
+        }
+      },
+      "relationshipPatterns": [
+        {
+          "from": "document",
+          "to": "concept",
+          "verb": "instanceOf",
+          "description": "Post belongs to category"
+        },
+        {
+          "from": "document",
+          "to": "concept",
+          "verb": "references",
+          "description": "Post targets keyword"
+        },
+        {
+          "from": "document",
+          "to": "document",
+          "verb": "relatedTo",
+          "description": "Posts in same series"
+        },
+        {
+          "from": "document",
+          "to": "socialGroup",
+          "verb": "references",
+          "description": "Post targets audience"
+        }
+      ],
+      "rules": [
+        "Create document entities for each blog post",
+        "Link posts to their categories and topics",
+        "Track series relationships between posts",
+        "Note target keywords and audience segments"
+      ]
+    },
+    "qualityGates": {
+      "fileChecks": [
+        {
+          "path": "posts/*.md",
+          "required": [
+            "Title",
+            "Meta Description",
+            "Primary Keyword"
+          ],
+          "optional": [
+            "Draft",
+            "Checklist Before Publishing"
+          ]
+        },
+        {
+          "path": "calendar.md",
+          "required": [
+            "Title",
+            "Status"
+          ],
+          "optional": [
+            "Publish Date",
+            "Word Count"
+          ]
+        }
+      ],
+      "projectChecks": [
+        "Series overview is complete",
+        "At least one post is drafted",
+        "Publishing schedule is defined",
+        "SEO keywords are identified"
+      ],
+      "exportReady": [
+        "All posts have meta descriptions",
+        "Internal links are in place",
+        "Images have alt text",
+        "Publishing dates are set"
+      ]
+    },
+    "templateMetadata": {
+      "identifyByStructure": true
+    },
+    "exporters": [
+      {
+        "id": "blog-bundle",
+        "name": "Blog Series Bundle",
+        "description": "All blog posts ready for publishing",
+        "icon": "📦",
+        "format": "zip",
+        "category": "archive",
+        "handler": "markdown-bundle",
+        "options": {
+          "includeFiles": [
+            "**/*.md"
+          ],
+          "preserveStructure": true,
+          "addReadme": true
+        }
+      }
+    ]
+  }
+}

package/kits/blog-series/skills/content-hooks/SKILL.md

@@ -0,0 +1,158 @@
+---
+name: content-hooks
+description: Background expertise in writing engaging headlines, introductions, and calls-to-action
+type: background
+version: "1.0.0"
+---
+
+## Content Hooks Expertise
+
+You have expertise in crafting compelling hooks that capture reader attention and drive engagement. Apply these principles when helping users write blog content.
+
+### Headline Formulas
+
+**Number Headlines**
+- "7 Proven Ways to [Achieve Result]"
+- "21 [Things] You Didn't Know About [Topic]"
+- "The 5-Minute Guide to [Topic]"
+
+**How-To Headlines**
+- "How to [Achieve Goal] (Without [Common Pain])"
+- "How I [Achievement] in [Timeframe]"
+- "How [Expert] Does [Task]"
+
+**Question Headlines**
+- "What If [Provocative Scenario]?"
+- "Why Do [Common Behavior]?"
+- "Are You Making These [X] Mistakes?"
+
+**Curiosity Gap Headlines**
+- "The [Adjective] Secret to [Goal]"
+- "What [Authority] Won't Tell You About [Topic]"
+- "The [Topic] Nobody Is Talking About"
+
+**Results-Based Headlines**
+- "[Result]: A Step-by-Step Guide"
+- "From [Starting Point] to [End Point]"
+- "[X] Tips That Actually [Result]"
+
+### Introduction Hooks
+
+**The Story Hook**
+- Start with a brief, relevant anecdote
+- Make readers see themselves in the story
+- Transition to the promise of the post
+
+**The Problem Hook**
+- Describe the pain point vividly
+- Show you understand their frustration
+- Promise the solution
+
+**The Statistic Hook**
+- Lead with a surprising number
+- Context that makes it meaningful
+- Bridge to your topic
+
+**The Question Hook**
+- Ask something readers want answered
+- Challenge an assumption
+- Create curiosity
+
+**The Contrarian Hook**
+- Challenge conventional wisdom
+- State an unpopular opinion
+- Promise to explain why
+
+### Introduction Structure (AIDA)
+
+**A - Attention**
+- First sentence must hook
+- Use a bold statement, question, or story
+- No throat-clearing ("In this post, I'll...")
+
+**I - Interest**
+- Expand on the hook
+- Show you understand the reader
+- Build relevance
+
+**D - Desire**
+- Preview the value
+- What will they learn/gain?
+- Create anticipation
+
+**A - Action**
+- Clear reason to keep reading
+- Sometimes a mini table of contents
+- "Here's what we'll cover..."
+
+### Transition Phrases
+
+**Between Sections**
+- "Now that we've covered X, let's look at Y"
+- "This brings us to the next point"
+- "Building on this..."
+
+**To Examples**
+- "Here's what this looks like in practice"
+- "For example..."
+- "Consider this scenario"
+
+**To Key Points**
+- "Here's the important part"
+- "The key takeaway is..."
+- "Most importantly..."
+
+### Calls-to-Action (CTAs)
+
+**Primary CTA Types**
+- Subscribe/Sign up
+- Download resource
+- Read related content
+- Share/Comment
+- Buy/Try
+
+**Effective CTA Formulas**
+- "Get your free [resource] now"
+- "Join [X] readers who..."
+- "Start your [journey/trial] today"
+- "Share this with someone who..."
+
+**CTA Placement**
+- End of post (expected)
+- After valuable insight (contextual)
+- Sidebar/sticky (persistent)
+- Content upgrade within post
+
+### Engagement Patterns
+
+**Open Loops**
+- Create curiosity early
+- Promise to answer later
+- "We'll get to why this matters in a moment"
+
+**Pattern Interrupts**
+- Break up long text
+- Use images, quotes, callouts
+- Vary sentence length
+
+**Social Proof**
+- Include reader comments/testimonials
+- Mention subscriber counts
+- Reference expert opinions
+
+### Common Mistakes
+
+**Headlines**
+- Clickbait that doesn't deliver
+- Vague or generic titles
+- Too clever (unclear benefit)
+
+**Introductions**
+- Burying the lead
+- Too much background
+- Talking about yourself first
+
+**CTAs**
+- Missing entirely
+- Too aggressive/salesy
+- Unclear what to do next

package/kits/blog-series/skills/headline-brainstorm/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: Brainstorm Headlines
+description: Generate multiple headline options for a post
+type: invocable
+version: "1.0.0"
+parameters: [topic]
+---
+
+## Brainstorm Headlines
+
+Generate multiple headline options for a post
+
+### Steps
+
+1. Understand the post topic and key takeaway
+2. Identify the primary keyword
+3. Generate 5 "How to" headlines
+4. Generate 5 "List" headlines (X Ways, X Tips)
+5. Generate 5 "Question" headlines
+6. Generate 5 "Promise" headlines (Why X Will...)
+7. Rate each by clarity, curiosity, and SEO
+8. Select top 3 recommendations
+
+### Inputs Required
+
+- **topic** (required): Post topic
+- **keyword** (optional): Target keyword
+
+### Expected Outputs
+
+- 20 headline options
+- Top 3 recommendations
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "headline ideas"
+- "title options"
+- "brainstorm headlines"
+- "title for"

package/kits/blog-series/skills/kit-expertise/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: kit-expertise
+description: Domain expertise for Blog Series - applied automatically when working in this kit
+type: background
+version: "1.0.0"
+---
+
+## Your Role
+
+Content Strategist and Blog Writing Coach helping you create engaging, SEO-friendly blog content that resonates with your audience
+
+## Your Expertise
+
+- Content planning and editorial calendars
+- SEO writing and keyword optimization
+- Blog post structure and formatting
+- Headline writing and hooks
+- Audience engagement strategies
+- Content repurposing
+- Call-to-action optimization
+- Series planning and continuity
+
+## Your Approach
+
+Work alongside the user as a creative partner
+
+## Things to Avoid
+
+- Writing generic content without audience focus
+- Over-optimizing for SEO at the expense of readability
+- Suggesting clickbait tactics
+- Ignoring the user's brand voice
+
+## Domain Knowledge
+
+### Key Terms
+
+**pillar content**
+Comprehensive long-form posts that cover a topic thoroughly
+
+**cluster content**
+Supporting posts that link back to pillar content
+
+**evergreen content**
+Posts that remain relevant over time
+
+**CTA**
+Call-to-action prompting reader engagement
+
+**meta description**
+SEO summary shown in search results
+
+**internal linking**
+Links between posts on your site
+
+**content calendar**
+Schedule of planned posts and topics
+
+**hook**
+Opening that captures reader attention
+
+### Best Practices
+
+- Start with a compelling hook in the first paragraph
+- Use subheadings every 300-400 words
+- Include relevant images and media
+- End with a clear call-to-action
+- Optimize for featured snippets with lists and definitions
+- Maintain consistent posting schedule
+
+### Common Mistakes to Avoid
+
+- Keyword stuffing
+- Walls of text without formatting
+- Burying the lede
+- Inconsistent posting schedules
+- Ignoring reader comments and engagement
+- Writing without a target audience in mind

package/kits/blog-series/skills/repurpose-content/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: Plan Content Repurposing
+description: Create a plan to repurpose blog content for other channels
+type: invocable
+version: "1.0.0"
+parameters: [postPath]
+---
+
+## Plan Content Repurposing
+
+Create a plan to repurpose blog content for other channels
+
+### Steps
+
+1. Identify the source post to repurpose
+2. Extract key points and quotable sections
+3. Create Twitter/X thread outline
+4. Create LinkedIn post version
+5. Create email newsletter version
+6. Identify slide deck potential
+7. Consider video script adaptation
+8. Plan cross-posting schedule
+9. Document repurposing in calendar
+
+### Inputs Required
+
+- **postPath** (required): Post to repurpose
+
+### Expected Outputs
+
+- Repurposing plan
+- Social media versions
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "repurpose"
+- "turn into"
+- "make into tweets"
+- "social media version"