@soulcraft/kits 1.0.0

package/kits/content-calendar/kit.json

@@ -0,0 +1,420 @@
+{
+  "$schema": "https://soulcraft.com/schemas/kit/v2.json",
+  "id": "content-calendar",
+  "type": "soulcraft",
+  "role": "primary",
+  "status": "released",
+  "name": "Content Calendar",
+  "description": "Editorial calendar for planning and managing content across channels",
+  "longDescription": "Plan, organize, and track your content creation across all platforms. Manage blog posts, social media, videos, podcasts, and email campaigns with a visual calendar. Perfect for content creators, marketing teams, and agencies who need to coordinate content publishing.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Soulcraft Labs",
+    "email": "kits@soulcraft.com",
+    "url": "https://soulcraft.com"
+  },
+  "icon": "📅",
+  "tags": [
+    "content",
+    "calendar",
+    "editorial",
+    "social-media",
+    "marketing",
+    "planning"
+  ],
+  "variables": [
+    {
+      "key": "projectName",
+      "label": "Brand/Publication Name",
+      "description": "The name of your brand or publication",
+      "type": "string",
+      "required": true,
+      "example": "My Brand"
+    },
+    {
+      "key": "planPeriod",
+      "label": "Planning Period",
+      "description": "What time period are you planning for?",
+      "type": "string",
+      "required": false,
+      "example": "Q1 2024"
+    },
+    {
+      "key": "primaryPlatform",
+      "label": "Primary Platform",
+      "description": "Your main content platform",
+      "type": "string",
+      "required": false,
+      "example": "Blog"
+    },
+    {
+      "key": "publishingFrequency",
+      "label": "Publishing Frequency",
+      "description": "How often do you publish?",
+      "type": "string",
+      "required": false,
+      "example": "3x per week"
+    }
+  ],
+  "shared": {
+    "industry": "content-marketing",
+    "category": "creative",
+    "glossary": {},
+    "aiExpertise": [
+      "Content strategy and planning",
+      "Editorial calendar management",
+      "Multi-channel content distribution",
+      "Content repurposing",
+      "Publishing workflows"
+    ],
+    "dataModelHints": [
+      "document",
+      "event",
+      "topic",
+      "person"
+    ],
+    "dataModel": {
+      "entities": [
+        {
+          "domain": "article",
+          "type": "Document",
+          "description": "A piece of content such as a blog post, social post, or video",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "📝"
+            },
+            "academy": {
+              "mapsTo": "learning-artifact",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "campaign",
+          "type": "Event",
+          "description": "A coordinated content campaign with a start and end date",
+          "products": {
+            "workshop": {
+              "view": "timeline",
+              "icon": "📣"
+            },
+            "academy": {
+              "mapsTo": "practice-session",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "topic",
+          "type": "Concept",
+          "description": "A content topic or pillar that posts address",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "💡"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "author",
+          "type": "Person",
+          "description": "A person who creates or is responsible for content",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "✍️"
+            },
+            "academy": {
+              "mapsTo": "learning-subject",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "channel",
+          "type": "Concept",
+          "description": "A publishing channel such as blog, Instagram, or email",
+          "products": {
+            "workshop": {
+              "view": "stats",
+              "icon": "📡"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": false
+            }
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "article",
+          "to": "campaign",
+          "verb": "PartOf",
+          "description": "Content piece belongs to this campaign"
+        },
+        {
+          "from": "article",
+          "to": "topic",
+          "verb": "AboutTopic",
+          "description": "Content covers this topic"
+        },
+        {
+          "from": "article",
+          "to": "channel",
+          "verb": "PublishedOn",
+          "description": "Content is published on this channel"
+        },
+        {
+          "from": "author",
+          "to": "article",
+          "verb": "Creates",
+          "description": "Author is responsible for this content"
+        },
+        {
+          "from": "article",
+          "to": "article",
+          "verb": "RelatedTo",
+          "description": "Content pieces that link or relate to each other"
+        }
+      ]
+    },
+    "suggestions": [
+      {
+        "label": "Plan content",
+        "prompt": "Help me plan content for the upcoming week"
+      },
+      {
+        "label": "Add a content piece",
+        "prompt": "Help me create a new content piece with platform and schedule"
+      },
+      {
+        "label": "Generate ideas",
+        "prompt": "Brainstorm content ideas based on my existing topics and themes"
+      },
+      {
+        "label": "Review schedule",
+        "prompt": "Review my content calendar and identify gaps in the schedule"
+      },
+      {
+        "label": "Repurpose content",
+        "prompt": "Suggest ways to repurpose my existing content for different platforms"
+      },
+      {
+        "label": "View calendar",
+        "prompt": "Show me my content schedule in the calendar view"
+      }
+    ]
+  },
+  "academy": {
+    "skillPath": "content-strategy",
+    "level": "intermediate",
+    "learningObjectives": [
+      "Define content pillars that align publishing output to business or audience goals",
+      "Manage an editorial calendar across multiple channels with realistic publishing cadences",
+      "Write content briefs that give creators a clear angle, audience, and call to action",
+      "Audit existing content and build a repurposing strategy across formats and platforms",
+      "Measure content performance and adjust the calendar based on engagement data"
+    ],
+    "assessmentTypes": [
+      "portfolio",
+      "peer-review"
+    ],
+    "certificationSlug": "content-strategist"
+  },
+  "workshop": {
+    "difficulty": "beginner",
+    "templateTier": 3,
+    "aiPersona": {
+      "role": "You are an expert content strategist helping teams plan, schedule, and execute content across multiple platforms and channels.",
+      "expertise": [
+        "Content strategy and planning",
+        "Editorial calendar management",
+        "Multi-channel publishing",
+        "Content repurposing strategies",
+        "Audience engagement and growth"
+      ],
+      "tone": "collaborator"
+    },
+    "workspaceConfig": {
+      "paradigm": "planner",
+      "defaultTab": "explore",
+      "defaultView": "calendar",
+      "defaultFile": "strategy/content-strategy.md",
+      "layout": {
+        "leftDock": "files",
+        "rightDock": "views"
+      },
+      "onboarding": {
+        "showGuide": true,
+        "highlightFeatures": [
+          "calendar",
+          "board",
+          "ai-chat"
+        ],
+        "suggestedActions": [
+          "Define content pillars in the Strategy document",
+          "Set up your publishing schedule in Calendar view",
+          "Create content briefs using the template",
+          "Track content status using Board view",
+          "Ask AI to help generate content ideas"
+        ]
+      }
+    },
+    "graphGuidance": {
+      "conceptCreation": {
+        "triggers": [
+          "User creates a new content piece",
+          "User defines a content series",
+          "User adds a new channel",
+          "User creates a campaign"
+        ],
+        "typeMapping": {
+          "article": "document",
+          "post": "document",
+          "campaign": "event",
+          "series": "category",
+          "topic": "concept",
+          "author": "person",
+          "channel": "category"
+        }
+      },
+      "relationshipPatterns": [
+        {
+          "from": "document",
+          "to": "event",
+          "verb": "part-of",
+          "description": "Content belongs to campaign"
+        },
+        {
+          "from": "document",
+          "to": "concept",
+          "verb": "aboutTopic",
+          "description": "Content covers topic"
+        },
+        {
+          "from": "document",
+          "to": "category",
+          "verb": "publishedOn",
+          "description": "Content goes on channel"
+        },
+        {
+          "from": "person",
+          "to": "document",
+          "verb": "creates",
+          "description": "Author writes content"
+        },
+        {
+          "from": "document",
+          "to": "document",
+          "verb": "relatedTo",
+          "description": "Content links together"
+        }
+      ]
+    },
+    "qualityGates": {
+      "fileChecks": [
+        {
+          "path": "strategy/content-strategy.md",
+          "required": [
+            "Content Pillars",
+            "Audience"
+          ],
+          "optional": [
+            "Competitors"
+          ]
+        },
+        {
+          "path": "calendar/schedule.md",
+          "required": [
+            "Publishing Schedule",
+            "Channels"
+          ],
+          "optional": [
+            "Automation"
+          ]
+        }
+      ],
+      "projectChecks": [
+        "Content pillars defined",
+        "Target audience documented",
+        "Publishing schedule established",
+        "At least 2 weeks of content planned",
+        "Content briefs created for scheduled pieces"
+      ],
+      "exportReady": [
+        "Calendar populated with scheduled content",
+        "All content pieces have assignments",
+        "Strategy document complete"
+      ]
+    },
+    "exporters": [
+      {
+        "id": "calendar-pdf",
+        "name": "Calendar View (PDF)",
+        "description": "Visual calendar of scheduled content",
+        "icon": "📅",
+        "format": "pdf",
+        "category": "document",
+        "handler": "calendar-pdf",
+        "options": {
+          "view": "month",
+          "includeDetails": true
+        }
+      },
+      {
+        "id": "editorial-calendar-csv",
+        "name": "Editorial Calendar (CSV)",
+        "description": "Spreadsheet of all content",
+        "icon": "📊",
+        "format": "csv",
+        "category": "data",
+        "handler": "entity-csv",
+        "options": {
+          "entityType": "Content",
+          "fields": [
+            "title",
+            "date",
+            "channel",
+            "status",
+            "author"
+          ]
+        }
+      },
+      {
+        "id": "content-strategy-doc",
+        "name": "Content Strategy (PDF)",
+        "description": "Strategy and planning document",
+        "icon": "📄",
+        "format": "pdf",
+        "category": "document",
+        "handler": "wdoc-pdf",
+        "options": {
+          "includeFiles": [
+            "strategy/*.md"
+          ],
+          "combineFiles": true
+        }
+      }
+    ],
+    "exportStructure": {
+      "combineStrategy": "path-order",
+      "includePatterns": [
+        "strategy/*.md",
+        "calendar/*.md"
+      ],
+      "excludePatterns": [
+        "_drafts/*"
+      ]
+    },
+    "exportPreferences": {
+      "defaultExporter": "calendar-pdf",
+      "fileNameTemplate": "{{projectName}}-content-calendar-{{planPeriod}}"
+    }
+  }
+}

package/kits/content-calendar/skills/content-strategy/SKILL.md

@@ -0,0 +1,174 @@
+---
+name: content-strategy
+description: Background expertise in content pillars, themes, and audience targeting
+type: background
+version: "1.0.0"
+---
+
+## Content Strategy Expertise
+
+You have expertise in content strategy and editorial planning. Apply these principles when helping users plan their content calendars.
+
+### Content Pillar Framework
+
+**What Are Content Pillars?**
+Core themes that define your content strategy. All content should ladder up to 3-5 pillars.
+
+**Pillar Criteria**
+- Aligned with business goals
+- Resonates with target audience
+- You have expertise/credibility
+- Sustainable long-term
+- Differentiates from competitors
+
+**Example Pillars (SaaS Company)**
+1. Product tutorials
+2. Industry trends
+3. Customer success stories
+4. Team culture
+5. Behind-the-scenes
+
+### Content Mix
+
+**The 4-1-1 Rule**
+- 4 educational/entertaining posts
+- 1 soft promotion
+- 1 direct promotion
+
+**Alternative: 80-20 Rule**
+- 80% value-driven content
+- 20% promotional content
+
+### Content Types by Goal
+
+**Awareness (Top of Funnel)**
+- Blog posts
+- Social content
+- Videos
+- Podcasts
+- Infographics
+
+**Consideration (Middle of Funnel)**
+- Case studies
+- Webinars
+- Comparison guides
+- Detailed tutorials
+
+**Conversion (Bottom of Funnel)**
+- Product demos
+- Free trials
+- Testimonials
+- ROI calculators
+
+**Retention**
+- Customer newsletters
+- Product updates
+- Community content
+- Loyalty programs
+
+### Audience Targeting
+
+**Define Your Audience**
+- Demographics: Age, location, job title
+- Psychographics: Values, interests, behaviors
+- Pain points: What problems do they have?
+- Goals: What do they want to achieve?
+- Media habits: Where do they consume content?
+
+**Content-Audience Fit**
+| Audience Segment | Content Type | Platform | Frequency |
+|-----------------|--------------|----------|-----------|
+| [Segment 1] | [Type] | [Platform] | [Cadence] |
+| [Segment 2] | [Type] | [Platform] | [Cadence] |
+
+### Platform-Specific Strategy
+
+**LinkedIn**
+- B2B focus
+- Professional insights
+- Career/industry content
+- Best: Tues-Thurs mornings
+
+**Instagram**
+- Visual storytelling
+- Behind-the-scenes
+- Lifestyle content
+- Best: Evenings and weekends
+
+**Twitter/X**
+- Real-time engagement
+- Thought leadership
+- Industry commentary
+- Best: Business hours
+
+**TikTok**
+- Entertainment-first
+- Trends and challenges
+- Authentic, raw content
+- Best: Evenings
+
+### Content Themes
+
+**Time-Based Themes**
+- Monthly focus areas
+- Seasonal content
+- Industry events
+- Holidays
+
+**Recurring Series**
+- "Tip Tuesday"
+- "Feature Friday"
+- "Customer Spotlight"
+- Monthly roundups
+
+### Editorial Calendar Elements
+
+**Per Content Piece**
+- Title/topic
+- Content pillar
+- Target audience
+- Platform(s)
+- Content type
+- Owner
+- Due date
+- Publish date
+- Status
+- Notes/assets
+
+### Content Performance Metrics
+
+**Awareness Metrics**
+- Reach, impressions
+- New followers
+- Brand mentions
+- Share of voice
+
+**Engagement Metrics**
+- Likes, comments, shares
+- Click-through rate
+- Time on page
+- Scroll depth
+
+**Conversion Metrics**
+- Leads generated
+- Email signups
+- Downloads
+- Sales attributed
+
+### Content Repurposing Strategy
+
+**One Piece → Many Formats**
+- Blog post → Social posts
+- Webinar → YouTube video → Blog → Social clips
+- Podcast → Audiogram → Quote graphics → Blog
+- Research → Infographic → Social → Email
+
+### Common Strategy Mistakes
+
+- No clear pillars
+- Inconsistent posting
+- Wrong platform focus
+- Not knowing audience
+- All promotion, no value
+- No measurement
+- Not repurposing

package/kits/content-calendar/skills/create-brief/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: Create Content Brief
+description: Write a brief for a content piece
+type: invocable
+version: "1.0.0"
+parameters: [topic]
+---
+
+## Create Content Brief
+
+Write a brief for a content piece
+
+### Steps
+
+1. Define the topic and angle
+2. Identify target audience/persona
+3. Set the goal (traffic, leads, engagement, etc.)
+4. Outline key points to cover
+5. List required research or interviews
+6. Define format and length
+7. Identify keywords for SEO
+8. Note related internal links
+9. Set deadline and assign owner
+10. Create brief document
+
+### Inputs Required
+
+- **topic** (required): Content topic
+
+### Expected Outputs
+
+- Content brief document
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "create brief"
+- "content brief"
+- "article outline"
+- "plan this piece"

package/kits/content-calendar/skills/generate-ideas/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: Generate Content Ideas
+description: Brainstorm content ideas for upcoming period
+type: invocable
+version: "1.0.0"
+parameters: [timeframe]
+---
+
+## Generate Content Ideas
+
+Brainstorm content ideas for upcoming period
+
+### Steps
+
+1. Review content pillars and themes
+2. Check upcoming events, holidays, and trends
+3. Review audience questions and feedback
+4. Look at competitor content gaps
+5. Consider seasonal relevance
+6. Generate 10-20 raw ideas
+7. Filter for strategic fit
+8. Prioritize by effort vs. impact
+9. Add top ideas to calendar
+
+### Inputs Required
+
+- **timeframe** (required): Planning period
+
+### Expected Outputs
+
+- Content idea list
+- Calendar entries
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "generate ideas"
+- "brainstorm content"
+- "what should we write"
+- "content ideas"