@soulcraft/kits 1.0.0

package/kits/ai-content-studio/kit.json

@@ -0,0 +1,358 @@
+{
+  "$schema": "https://soulcraft.com/schemas/kit/v2.json",
+  "id": "ai-content-studio",
+  "type": "soulcraft",
+  "role": "extension",
+  "status": "released",
+  "name": "AI Content Studio",
+  "description": "AI-powered content generation — blog posts, social media, and email campaigns",
+  "longDescription": "A composable content generation extension for Workshop and Venue. Adds AI-assisted blog drafting, social media post scheduling, email campaign management, and content performance tracking. Venue gets dedicated blog and content management stations. Workshop gets an enhanced writing persona with deep content marketing expertise and a full set of content-focused skills. All content entities — posts, campaigns, social copy — are first-class Brainy nodes linked to a content calendar so nothing falls through the cracks.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Soulcraft Labs",
+    "email": "kits@soulcraft.com",
+    "url": "https://soulcraft.com"
+  },
+  "icon": "✍️",
+  "tags": [
+    "content",
+    "blog",
+    "ai",
+    "marketing",
+    "writing",
+    "extension",
+    "email campaigns",
+    "social media"
+  ],
+  "requires": [],
+  "shared": {
+    "industry": "content-marketing",
+    "category": "creative",
+    "glossary": {
+      "content calendar": "A scheduled plan mapping which content pieces will be published on which dates, across which channels, ensuring consistent output and balanced themes.",
+      "content cluster": "A group of related pieces — a pillar page and its supporting articles — that collectively rank for a topic and link to each other for SEO authority.",
+      "pillar page": "A long-form, comprehensive page covering a broad topic in depth, designed to rank for a high-volume keyword and link out to cluster content.",
+      "drip campaign": "An automated email sequence triggered by a subscriber action — signing up, downloading, purchasing — that delivers value over time.",
+      "open rate": "The percentage of email recipients who opened a campaign message — a primary measure of subject line effectiveness.",
+      "CTR": "Click-through rate — the percentage of email recipients or social viewers who clicked a link in the content.",
+      "organic traffic": "Website visitors who arrived via an unpaid search engine result — the primary long-term return on blog and SEO investment."
+    },
+    "aiExpertise": [
+      "blog post ideation and SEO-optimised drafting",
+      "social media content strategy and platform-native copywriting",
+      "email campaign writing and subject line optimisation",
+      "content calendar planning and editorial scheduling",
+      "content performance analysis and strategy iteration",
+      "audience research and content-market fit",
+      "repurposing long-form content into micro-content"
+    ],
+    "dataModelHints": [
+      "blog_post",
+      "social_post",
+      "email_campaign",
+      "content_calendar"
+    ],
+    "dataModel": {
+      "entities": [
+        {
+          "domain": "blog_post",
+          "type": "Document",
+          "description": "A long-form blog article with title, slug, body, meta description, target keywords, author, publish date, and status.",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "✍️"
+            },
+            "venue": {
+              "mapsTo": "BlogPostMeta",
+              "pos": false
+            },
+            "academy": {
+              "mapsTo": "learning-artifact",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "social_post",
+          "type": "Document",
+          "description": "A social media post with caption, target platform, scheduled date, hashtags, and publish status.",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "📱"
+            },
+            "academy": {
+              "mapsTo": "learning-artifact",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "email_campaign",
+          "type": "Event",
+          "description": "An email marketing campaign with subject, body, target list, scheduled send date, and performance metrics (opens, clicks, unsubscribes).",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "📧"
+            },
+            "academy": {
+              "mapsTo": "practice-session",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "content_calendar",
+          "type": "Concept",
+          "description": "A scheduled content plan for a defined time window, organising blog posts, social posts, and email campaigns by date and channel.",
+          "products": {
+            "workshop": {
+              "view": "calendar",
+              "icon": "📅"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": false
+            }
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "content_calendar",
+          "to": "blog_post",
+          "verb": "Contains",
+          "description": "Content calendar schedules blog posts for publication on specific dates."
+        },
+        {
+          "from": "content_calendar",
+          "to": "social_post",
+          "verb": "Contains",
+          "description": "Content calendar schedules social posts for publishing across platforms."
+        },
+        {
+          "from": "content_calendar",
+          "to": "email_campaign",
+          "verb": "Contains",
+          "description": "Content calendar schedules email campaigns as part of the broader publishing rhythm."
+        },
+        {
+          "from": "email_campaign",
+          "to": "content_calendar",
+          "verb": "References",
+          "description": "Email campaign links back to the calendar period it belongs to for cohesive tracking."
+        },
+        {
+          "from": "social_post",
+          "to": "blog_post",
+          "verb": "References",
+          "description": "Social post promotes or repurposes content from a linked blog post."
+        }
+      ]
+    },
+    "suggestions": [
+      {
+        "label": "Draft a blog post",
+        "prompt": "Help me write an SEO-optimised blog post on a topic relevant to my audience."
+      },
+      {
+        "label": "Create a social calendar",
+        "prompt": "Build a two-week social media posting schedule that promotes my latest blog content."
+      },
+      {
+        "label": "Draft an email campaign",
+        "prompt": "Write an email campaign announcing a new post or offer to my subscriber list."
+      },
+      {
+        "label": "Repurpose a post",
+        "prompt": "Take this blog post and help me turn it into social captions, an email intro, and a pull quote."
+      },
+      {
+        "label": "Plan content topics",
+        "prompt": "Help me brainstorm a month of blog topics based on my audience's questions and my business goals."
+      },
+      {
+        "label": "Analyse content performance",
+        "prompt": "Review my recent content metrics and identify what's resonating and what to double down on."
+      }
+    ]
+  },
+  "academy": {
+    "skillPath": "content-marketing",
+    "level": "intermediate",
+    "learningObjectives": [
+      "Develop a content strategy with audience research, topic clusters, and publishing cadence",
+      "Write SEO-optimised blog posts with compelling headlines, structure, and meta copy",
+      "Create a consistent social posting schedule repurposing long-form content into platform-native formats",
+      "Craft email campaigns with subject lines, body copy, and CTAs that drive clicks and conversions",
+      "Measure content performance — organic traffic, open rates, engagement — and iterate the strategy accordingly"
+    ],
+    "assessmentTypes": [
+      "portfolio",
+      "peer-review"
+    ],
+    "certificationSlug": "content-creator"
+  },
+  "workshop": {
+    "aiPersona": {
+      "role": "You are a content marketing strategist and AI writing partner helping businesses create high-quality blog posts, social content, and email campaigns. You write in the brand's voice, think about SEO, and always connect content to business outcomes.",
+      "expertise": [
+        "blog post ideation and SEO-optimised drafting",
+        "social media copywriting across platforms",
+        "email campaign writing and subject line testing",
+        "content calendar planning and editorial scheduling",
+        "content performance analysis and strategy iteration",
+        "repurposing long-form content into micro-content formats"
+      ],
+      "tone": "collaborator",
+      "avoidances": [
+        "Don't write generic content that could apply to any brand — always anchor to the specific brand voice and audience",
+        "Don't ignore SEO intent — every blog post should serve a specific search query or business goal",
+        "Don't schedule more content than the team can maintain at quality — consistency beats volume"
+      ]
+    },
+    "graphGuidance": {
+      "conceptCreation": {
+        "triggers": [
+          "blog post drafted, outlined, or published",
+          "social post created or scheduled",
+          "email campaign designed or sent",
+          "content calendar updated or created",
+          "content topic or keyword identified"
+        ],
+        "typeMapping": {
+          "blog post": "document",
+          "article": "document",
+          "social post": "document",
+          "caption": "document",
+          "email campaign": "event",
+          "newsletter": "event",
+          "content calendar": "concept",
+          "topic": "concept",
+          "keyword": "concept"
+        }
+      },
+      "relationshipPatterns": [
+        {
+          "from": "content_calendar",
+          "to": "blog_post",
+          "verb": "Contains",
+          "description": "Calendar schedules blog post publication"
+        },
+        {
+          "from": "content_calendar",
+          "to": "social_post",
+          "verb": "Contains",
+          "description": "Calendar schedules social post"
+        },
+        {
+          "from": "social_post",
+          "to": "blog_post",
+          "verb": "References",
+          "description": "Social post promotes or repurposes a blog post"
+        }
+      ],
+      "rules": [
+        "Every content piece should be linked to a content calendar period",
+        "Social posts that repurpose blog content must reference the source post",
+        "Email campaigns link back to the calendar period for cohesive tracking",
+        "Content entities should record publish status — draft, scheduled, published, archived"
+      ]
+    },
+    "qualityGates": {
+      "projectChecks": [
+        "At least one blog post exists with a title, body, and meta description",
+        "At least one social post is scheduled and linked to the content calendar",
+        "At least one email campaign is drafted with subject line, body, and CTA",
+        "Content calendar covers at least two weeks with content on each channel",
+        "Blog posts have target keywords assigned"
+      ]
+    },
+    "publishConfig": {
+      "contentType": "document",
+      "publishable": true
+    },
+    "remoteWorkspace": {
+      "connectedWorkbenches": [
+        {
+          "name": "Content Calendar",
+          "view": "calendar",
+          "entityTypes": [
+            "blog_post",
+            "social_post",
+            "email_campaign"
+          ],
+          "description": "Unified calendar showing all content across blog, social, and email by publish date"
+        },
+        {
+          "name": "Blog Pipeline",
+          "view": "board",
+          "entityTypes": [
+            "blog_post"
+          ],
+          "description": "Blog posts by status — ideation, drafting, review, scheduled, published"
+        },
+        {
+          "name": "Social Posts",
+          "view": "board",
+          "entityTypes": [
+            "social_post"
+          ],
+          "description": "Social content drafts and scheduled posts across platforms"
+        },
+        {
+          "name": "Email Campaigns",
+          "view": "board",
+          "entityTypes": [
+            "email_campaign"
+          ],
+          "description": "Email campaign pipeline from draft through send and performance review"
+        },
+        {
+          "name": "Content Graph",
+          "view": "graph",
+          "entityTypes": [
+            "blog_post",
+            "social_post",
+            "email_campaign",
+            "content_calendar"
+          ],
+          "description": "Graph showing how content pieces relate, repurpose, and support each other"
+        }
+      ]
+    }
+  },
+  "venue": {
+    "features": {
+      "blog": true
+    },
+    "stations": [
+      {
+        "id": "blog",
+        "label": "Blog",
+        "route": "/api/manage/blog",
+        "icon": "📝",
+        "roles": [
+          "manager",
+          "owner"
+        ],
+        "scope": "kit",
+        "context": "both"
+      },
+      {
+        "id": "content-studio",
+        "label": "Content Studio",
+        "route": "/api/manage/content",
+        "icon": "✍️",
+        "roles": [
+          "manager",
+          "owner"
+        ],
+        "scope": "kit",
+        "context": "both"
+      }
+    ]
+  }
+}