@soulcraft/kits 1.0.0

package/src/kits/social-media-manager.ts

@@ -0,0 +1,494 @@
+/**
+ * @module @soulcraft/kits/kits/social-media-manager
+ * @description Plan, draft, and schedule social media content across platforms
+ *
+ * Generated from: kits/social-media-manager/kit.json
+ * Do not edit this file directly — edit the source kit.json and re-run `bun run build:kits`.
+ */
+
+import type { SoulcraftKitConfig } from '@soulcraft/kit-schema';
+
+/**
+ * Social Media Manager kit configuration.
+ *
+ * @description Plan, draft, and schedule social media content across platforms
+ * @see {@link SoulcraftKitConfig}
+ */
+const socialMediaManager: SoulcraftKitConfig = {
+	"$schema": "https://soulcraft.com/schemas/kit/v2.json",
+	"id": "social-media-manager",
+	"name": "Social Media Manager",
+	"description": "Plan, draft, and schedule social media content across platforms",
+	"version": "1.0.0",
+	"author": {
+		"name": "Soulcraft Labs",
+		"email": "kits@soulcraft.com",
+		"url": "https://soulcraft.com"
+	},
+	"status": "released",
+	"icon": "📱",
+	"longDescription": "A social media content management system powered by Brainy's knowledge graph. Plan campaigns, draft posts with AI assistance, organise a content calendar, track hashtag performance, and repurpose content across Instagram, LinkedIn, X, and TikTok. Every post, campaign, and hashtag is a first-class node in the graph — so you can see relationships, find gaps, and build a consistent brand voice at scale.",
+	"tags": [
+		"social media",
+		"content",
+		"marketing",
+		"instagram",
+		"scheduling",
+		"calendar",
+		"copywriting"
+	],
+	"role": "primary",
+	"type": "soulcraft",
+	"variables": [
+		{
+			"key": "brandName",
+			"label": "Brand Name",
+			"description": "The name of the brand or account being managed",
+			"type": "string",
+			"required": true,
+			"example": "Olive & Oak Bakery"
+		},
+		{
+			"key": "brandVoice",
+			"label": "Brand Voice",
+			"description": "A short description of your brand's personality and tone of voice",
+			"type": "string",
+			"required": false,
+			"example": "Warm, approachable, and a little bit playful — like a friend who happens to bake"
+		},
+		{
+			"key": "primaryPlatform",
+			"label": "Primary Platform",
+			"description": "The social network where you focus most of your content energy",
+			"type": "string",
+			"required": false,
+			"example": "Instagram",
+			"default": "Instagram"
+		},
+		{
+			"key": "targetAudience",
+			"label": "Target Audience",
+			"description": "A brief description of the people you are trying to reach with your content",
+			"type": "string",
+			"required": false,
+			"example": "Home bakers aged 25–45 who love sourdough and weekend treats"
+		},
+		{
+			"key": "contentPillars",
+			"label": "Content Pillars",
+			"description": "Comma-separated list of 3–5 core themes your content revolves around",
+			"type": "string",
+			"required": false,
+			"example": "Behind the scenes, Recipes, Customer stories, Tips & tricks, Seasonal specials"
+		}
+	],
+	"shared": {
+		"industry": "content-marketing",
+		"category": "business",
+		"glossary": {
+			"content pillar": "A core theme or topic category that all your social content is organised around — typically 3–5 pillars ensure variety while maintaining focus.",
+			"evergreen content": "Posts that remain relevant and valuable regardless of when they are seen — tutorials, how-tos, and timeless tips — as opposed to time-sensitive news or trends.",
+			"social proof": "Content that demonstrates credibility through the words or actions of others — customer testimonials, user-generated content, media mentions, and review highlights.",
+			"engagement rate": "A metric calculated as total interactions (likes, comments, shares, saves) divided by reach, expressed as a percentage.",
+			"reach": "The number of unique accounts that saw a piece of content during a given period.",
+			"impressions": "The total number of times a piece of content was displayed, including multiple views by the same account.",
+			"CTR": "Click-through rate — the percentage of people who saw a post and clicked the link or call-to-action."
+		},
+		"aiExpertise": [
+			"platform-specific content strategy (Instagram, LinkedIn, X, TikTok)",
+			"hashtag research and optimisation",
+			"content calendar planning and cadence",
+			"copywriting for social platforms",
+			"engagement analytics and performance interpretation",
+			"brand voice development and consistency",
+			"content repurposing across formats and platforms"
+		],
+		"dataModelHints": [
+			"post",
+			"campaign",
+			"hashtag",
+			"platform",
+			"analytics",
+			"content_pillar"
+		],
+		"suggestions": [
+			{
+				"label": "Draft a post",
+				"prompt": "Help me write a post for my primary platform that fits my brand voice and content pillars."
+			},
+			{
+				"label": "Plan a campaign",
+				"prompt": "Help me plan a themed content campaign with a goal, posting schedule, and post ideas."
+			},
+			{
+				"label": "Build a content calendar",
+				"prompt": "Create a two-week content calendar with a balanced mix across my content pillars."
+			},
+			{
+				"label": "Research hashtags",
+				"prompt": "Suggest a hashtag strategy for my brand — mixing broad, niche, and branded tags."
+			},
+			{
+				"label": "Repurpose content",
+				"prompt": "Help me adapt this post for Instagram, LinkedIn, and TikTok."
+			},
+			{
+				"label": "Analyse engagement",
+				"prompt": "Review my recent post analytics and identify which content types are performing best."
+			}
+		],
+		"dataModel": {
+			"entities": [
+				{
+					"domain": "post",
+					"type": "Document",
+					"description": "A single piece of social content — caption, media references, hashtags, platform target, scheduled date, and publish status.",
+					"products": {
+						"workshop": {
+							"view": "board",
+							"icon": "📝"
+						},
+						"academy": {
+							"mapsTo": "learning-artifact",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "campaign",
+					"type": "Concept",
+					"description": "A themed content campaign grouping related posts under a shared goal, time window, and target outcome.",
+					"products": {
+						"workshop": {
+							"view": "gallery",
+							"icon": "🎯"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "hashtag",
+					"type": "Thing",
+					"description": "A social media hashtag with usage frequency, platform affinity, and performance tracking metadata.",
+					"products": {
+						"workshop": {
+							"view": "stats",
+							"icon": "#️⃣"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": false
+						}
+					}
+				},
+				{
+					"domain": "platform",
+					"type": "Concept",
+					"description": "A social media platform (Instagram, LinkedIn, X, TikTok) with its own format constraints and audience characteristics.",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "📱"
+						}
+					}
+				},
+				{
+					"domain": "analytics",
+					"type": "Measurement",
+					"description": "Engagement metrics for a post — reach, impressions, likes, comments, shares, saves, and CTR — recorded after publishing.",
+					"products": {
+						"workshop": {
+							"view": "stats",
+							"icon": "📊"
+						},
+						"academy": {
+							"mapsTo": "practice-session",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "content_pillar",
+					"type": "Concept",
+					"description": "One of the brand's core content themes that all posts are categorised under to ensure balanced variety.",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "🏛️"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": false
+						}
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "campaign",
+					"to": "post",
+					"verb": "Contains",
+					"description": "Campaign groups the posts that belong to its themed initiative."
+				},
+				{
+					"from": "post",
+					"to": "hashtag",
+					"verb": "Uses",
+					"description": "Post includes one or more hashtags in its caption or first comment."
+				},
+				{
+					"from": "post",
+					"to": "platform",
+					"verb": "PublishedTo",
+					"description": "Post is scheduled or published to a specific social platform."
+				},
+				{
+					"from": "platform",
+					"to": "analytics",
+					"verb": "Tracks",
+					"description": "Platform records engagement analytics for posts published to it."
+				},
+				{
+					"from": "post",
+					"to": "content_pillar",
+					"verb": "References",
+					"description": "Post is categorised under a content pillar to ensure thematic balance across the calendar."
+				},
+				{
+					"from": "campaign",
+					"to": "content_pillar",
+					"verb": "References",
+					"description": "Campaign is anchored to one or more content pillars that define its focus."
+				}
+			]
+		}
+	},
+	"workshop": {
+		"workspaceConfig": {
+			"paradigm": "planner",
+			"defaultTab": "explore",
+			"defaultView": "calendar"
+		},
+		"graphGuidance": {
+			"conceptCreation": {
+				"triggers": [
+					"post, caption, or social content drafted",
+					"campaign or promotion theme discussed",
+					"hashtag mentioned or researched",
+					"platform (Instagram, LinkedIn, X, TikTok) referenced",
+					"content pillar or theme identified",
+					"analytics or engagement data recorded"
+				],
+				"typeMapping": {
+					"post": "document",
+					"caption": "document",
+					"campaign": "concept",
+					"hashtag": "thing",
+					"platform": "concept",
+					"content pillar": "concept",
+					"analytics": "measurement",
+					"engagement metric": "measurement"
+				}
+			},
+			"relationshipPatterns": [
+				{
+					"from": "campaign",
+					"to": "post",
+					"verb": "Contains",
+					"description": "Campaign owns its constituent posts"
+				},
+				{
+					"from": "post",
+					"to": "hashtag",
+					"verb": "Uses",
+					"description": "Post uses hashtag in caption"
+				},
+				{
+					"from": "post",
+					"to": "platform",
+					"verb": "PublishedTo",
+					"description": "Post is targeted at a specific platform"
+				}
+			],
+			"rules": [
+				"Every post should link to a content pillar for balance tracking",
+				"Campaign posts should share a hashtag for discoverability",
+				"Platform nodes should be reused — one node per network, not one per post",
+				"Analytics entities link back to the post they measure"
+			]
+		},
+		"qualityGates": {
+			"projectChecks": [
+				"At least three content pillars are defined with descriptions",
+				"A content calendar covers at least two weeks of posts",
+				"Each post is linked to a content pillar and a platform",
+				"At least one campaign exists with a defined goal and post count",
+				"Hashtag groups are defined for each content pillar"
+			],
+			"exportReady": [
+				"All draft posts have captions written",
+				"Posting schedule dates are assigned",
+				"Hashtag sets are attached to each post"
+			]
+		},
+		"publishConfig": {
+			"contentType": "document",
+			"publishable": true
+		},
+		"aiPersona": {
+			"role": "You are a social media strategist helping brands create compelling, platform-optimised content that drives engagement and grows their audience. You understand the nuances of each major platform and can write in any brand voice.",
+			"expertise": [
+				"platform-specific content strategy",
+				"hashtag research and optimisation",
+				"content calendar planning and scheduling",
+				"copywriting for Instagram, LinkedIn, X, and TikTok",
+				"engagement analytics and performance measurement",
+				"brand voice development and consistency",
+				"campaign planning and content repurposing"
+			],
+			"tone": "collaborator",
+			"avoidances": [
+				"Don't make engagement guarantees — performance depends on audience, timing, and the algorithm",
+				"Don't copy competitor content — always generate original ideas tailored to the brand",
+				"Don't recommend paid promotion without understanding the budget context first"
+			]
+		},
+		"remoteWorkspace": {
+			"connectedWorkbenches": [
+				{
+					"name": "Content Calendar",
+					"view": "calendar",
+					"entityTypes": [
+						"post"
+					],
+					"description": "Monthly view of scheduled and published posts across all platforms"
+				},
+				{
+					"name": "Campaign Board",
+					"view": "board",
+					"entityTypes": [
+						"campaign",
+						"post"
+					],
+					"description": "Track campaigns from ideation through drafting to published"
+				},
+				{
+					"name": "Hashtag Library",
+					"view": "gallery",
+					"entityTypes": [
+						"hashtag"
+					],
+					"description": "Browse and organise hashtag groups by pillar and platform"
+				},
+				{
+					"name": "Engagement Stats",
+					"view": "stats",
+					"entityTypes": [
+						"analytics"
+					],
+					"description": "Reach, impressions, and engagement rate across published posts"
+				},
+				{
+					"name": "Content Graph",
+					"view": "graph",
+					"entityTypes": [
+						"post",
+						"campaign",
+						"hashtag",
+						"content_pillar"
+					],
+					"description": "Graph of how posts relate to campaigns, hashtags, and pillars"
+				}
+			]
+		},
+		"difficulty": "beginner",
+		"templateTier": 2,
+		"templateMetadata": {
+			"identifyByStructure": true,
+			"runnable": false
+		},
+		"sampleData": {
+			"description": "Sample content pillars, a campaign, and posts to demonstrate the social media manager",
+			"entities": [
+				{
+					"type": "concept",
+					"name": "Behind the Scenes",
+					"properties": {
+						"description": "Authentic glimpses into the kitchen, baking process, and the team that makes it happen.",
+						"color": "#F97316",
+						"postFrequency": "3x per week"
+					}
+				},
+				{
+					"type": "concept",
+					"name": "Valentine's Week Campaign",
+					"properties": {
+						"goal": "Drive bookings for Valentine's Day custom cake orders",
+						"startDate": "2026-02-08",
+						"endDate": "2026-02-14",
+						"targetPlatform": "Instagram",
+						"status": "draft"
+					}
+				},
+				{
+					"type": "document",
+					"name": "Nothing says love like a custom cake 🍰",
+					"properties": {
+						"caption": "Nothing says love like a custom cake 🍰 Order your Valentine's design by Feb 10 — link in bio.",
+						"platform": "Instagram",
+						"scheduledDate": "2026-02-07",
+						"status": "scheduled",
+						"pillar": "Behind the Scenes"
+					}
+				},
+				{
+					"type": "thing",
+					"name": "#valentinescake",
+					"properties": {
+						"platform": "Instagram",
+						"type": "campaign",
+						"estimatedReach": "medium"
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "Valentine's Week Campaign",
+					"verb": "Contains",
+					"to": "Nothing says love like a custom cake 🍰"
+				},
+				{
+					"from": "Nothing says love like a custom cake 🍰",
+					"verb": "Uses",
+					"to": "#valentinescake"
+				},
+				{
+					"from": "Nothing says love like a custom cake 🍰",
+					"verb": "References",
+					"to": "Behind the Scenes"
+				}
+			]
+		}
+	},
+	"academy": {
+		"skillPath": "content-marketing",
+		"level": "beginner",
+		"learningObjectives": [
+			"Develop a set of clearly defined content pillars that give the brand consistent focus and variety",
+			"Write platform-native copy tailored to the tone, format, and audience of each social network",
+			"Build a realistic content calendar with a publishing cadence matched to available capacity",
+			"Research and apply hashtag strategies that combine branded, niche, and high-volume tags",
+			"Measure engagement rate, reach, and impressions, and use data to adjust content strategy"
+		],
+		"assessmentTypes": [
+			"portfolio",
+			"peer-review"
+		],
+		"certificationSlug": "social-media-manager"
+	}
+} satisfies SoulcraftKitConfig;
+
+export default socialMediaManager;