@soulcraft/kits 1.0.0

package/kits/youtube-content-plan/kit.json

@@ -0,0 +1,346 @@
+{
+  "$schema": "https://soulcraft.com/schemas/kit/v2.json",
+  "id": "youtube-content-plan",
+  "type": "soulcraft",
+  "role": "primary",
+  "status": "released",
+  "name": "YouTube Channel Content Plan",
+  "description": "Content calendar, video scripts, and channel strategy for YouTube creators",
+  "longDescription": "Complete YouTube content planning system with video ideas, scripts, SEO optimization, thumbnail concepts, and analytics tracking. Plan your content calendar, organize videos into playlists, and track performance metrics all in one connected workspace.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Soulcraft Labs",
+    "email": "kits@soulcraft.com",
+    "url": "https://soulcraft.com"
+  },
+  "icon": "🎥",
+  "tags": [
+    "youtube",
+    "video",
+    "content-creation",
+    "social-media"
+  ],
+  "variables": [
+    {
+      "key": "projectName",
+      "label": "Channel/Series Name",
+      "description": "The name of your YouTube channel or series",
+      "type": "string",
+      "required": true,
+      "example": "TechTips Weekly"
+    },
+    {
+      "key": "author",
+      "label": "Creator",
+      "description": "Your name as the content creator",
+      "type": "string",
+      "required": false,
+      "example": "Your Name"
+    },
+    {
+      "key": "niche",
+      "label": "Channel Niche",
+      "description": "The primary topic or focus of your channel",
+      "type": "string",
+      "required": false,
+      "example": "Web Development Tutorials"
+    }
+  ],
+  "shared": {
+    "industry": "writing-publishing",
+    "category": "creative",
+    "aiExpertise": [
+      "YouTube content strategy",
+      "Video script writing",
+      "SEO title and description optimization",
+      "Thumbnail concept development",
+      "Channel growth strategy"
+    ],
+    "dataModelHints": [
+      "document",
+      "collection",
+      "concept",
+      "person"
+    ],
+    "dataModel": {
+      "entities": [
+        {
+          "domain": "video",
+          "type": "Document",
+          "description": "A YouTube video with script, title, and SEO metadata",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "🎥"
+            },
+            "academy": {
+              "mapsTo": "learning-artifact",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "series",
+          "type": "Concept",
+          "description": "A thematic series or playlist grouping related videos",
+          "products": {
+            "workshop": {
+              "view": "timeline",
+              "icon": "📚"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "topic",
+          "type": "Concept",
+          "description": "A content topic or keyword a video targets",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "💡"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "collaborator",
+          "type": "Person",
+          "description": "A creator or guest featured in a video",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "👤"
+            },
+            "academy": {
+              "mapsTo": "learning-subject",
+              "assessable": false
+            }
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "video",
+          "to": "series",
+          "verb": "PartOf",
+          "description": "Video belongs to this series or playlist"
+        },
+        {
+          "from": "video",
+          "to": "topic",
+          "verb": "References",
+          "description": "Video covers this topic or keyword"
+        },
+        {
+          "from": "video",
+          "to": "collaborator",
+          "verb": "Contains",
+          "description": "Video features this collaborator"
+        },
+        {
+          "from": "video",
+          "to": "video",
+          "verb": "RelatedTo",
+          "description": "Related videos for cross-promotion"
+        }
+      ]
+    },
+    "suggestions": [
+      {
+        "label": "Plan a video",
+        "prompt": "Help me plan and outline a new YouTube video"
+      },
+      {
+        "label": "Write a script",
+        "prompt": "Help me write a script for my next video"
+      },
+      {
+        "label": "Optimize titles",
+        "prompt": "Help me write compelling titles and descriptions for my videos"
+      },
+      {
+        "label": "Plan a series",
+        "prompt": "Help me plan a multi-video series on a topic"
+      },
+      {
+        "label": "Content strategy",
+        "prompt": "Review my channel content and suggest strategic improvements"
+      },
+      {
+        "label": "View content calendar",
+        "prompt": "Show me my video schedule in the calendar view"
+      }
+    ]
+  },
+  "academy": {
+    "skillPath": "video-production",
+    "level": "beginner",
+    "learningObjectives": [
+      "Write a video script with a hook that delivers the core value promise within the first 30 seconds",
+      "Optimise a title and description using keyword research and click-through best practices",
+      "Plan a content calendar that batches production and maintains a consistent publishing cadence",
+      "Structure a video series so each episode drives viewers to the next with clear continuity"
+    ],
+    "assessmentTypes": [
+      "portfolio",
+      "peer-review"
+    ],
+    "certificationSlug": "content-creator"
+  },
+  "workshop": {
+    "difficulty": "intermediate",
+    "templateTier": 4,
+    "aiPersona": {
+      "role": "You are a YouTube growth strategist and video content expert helping creators plan, script, and optimize their content for maximum reach and audience engagement.",
+      "expertise": [
+        "YouTube content strategy",
+        "Video script writing",
+        "SEO optimization",
+        "Thumbnail and title strategy",
+        "Channel growth and retention"
+      ],
+      "tone": "collaborator"
+    },
+    "workspaceConfig": {
+      "paradigm": "planner",
+      "defaultTab": "explore",
+      "defaultView": "calendar",
+      "defaultFile": "content/video-ideas.md",
+      "layout": {
+        "leftDock": "files",
+        "rightDock": "views"
+      },
+      "onboarding": {
+        "showGuide": true,
+        "highlightFeatures": [
+          "calendar",
+          "board",
+          "ai-chat"
+        ],
+        "suggestedActions": [
+          "Brainstorm video ideas in the content folder",
+          "Plan your release schedule in Calendar view",
+          "Track video status in Board view",
+          "Ask AI for title and thumbnail ideas"
+        ]
+      }
+    },
+    "graphGuidance": {
+      "conceptCreation": {
+        "triggers": [
+          "When user creates a new video idea",
+          "When user defines a series or playlist",
+          "When user identifies a topic or keyword",
+          "When user notes a collaboration"
+        ],
+        "typeMapping": {
+          "video": "document",
+          "series": "collection",
+          "playlist": "collection",
+          "topic": "concept",
+          "collaborator": "person"
+        }
+      },
+      "relationshipPatterns": [
+        {
+          "from": "document",
+          "to": "collection",
+          "verb": "partOf",
+          "description": "Video in playlist"
+        },
+        {
+          "from": "document",
+          "to": "concept",
+          "verb": "references",
+          "description": "Video covers topic"
+        },
+        {
+          "from": "document",
+          "to": "person",
+          "verb": "contains",
+          "description": "Video features collaborator"
+        },
+        {
+          "from": "document",
+          "to": "document",
+          "verb": "relatedTo",
+          "description": "Related videos"
+        }
+      ],
+      "rules": [
+        "Create document entities for video ideas",
+        "Link videos to their playlists and topics",
+        "Track collaborations and features",
+        "Note content pillars and themes"
+      ]
+    },
+    "qualityGates": {
+      "fileChecks": [
+        {
+          "path": "scripts/*.md",
+          "required": [
+            "Title",
+            "Hook",
+            "Script"
+          ],
+          "optional": [
+            "B-Roll",
+            "Thumbnail Concept",
+            "Production Notes"
+          ]
+        },
+        {
+          "path": "channel-strategy.md",
+          "required": [
+            "Mission Statement",
+            "Content Pillars"
+          ],
+          "optional": [
+            "Publishing Schedule",
+            "Growth Strategy"
+          ]
+        }
+      ],
+      "projectChecks": [
+        "Channel strategy is defined",
+        "Content pillars are identified",
+        "At least one script is complete",
+        "Publishing schedule is set"
+      ],
+      "exportReady": [
+        "Scripts have production notes",
+        "Thumbnails are designed",
+        "Metadata is optimized",
+        "Content calendar is current"
+      ]
+    },
+    "exporters": [
+      {
+        "id": "youtube-package",
+        "name": "YouTube Production Package",
+        "description": "Scripts, calendar, and analytics in one bundle",
+        "icon": "📦",
+        "format": "zip",
+        "category": "archive",
+        "handler": "markdown-bundle",
+        "options": {
+          "includeFiles": [
+            "**/*.md"
+          ],
+          "preserveStructure": true,
+          "addReadme": true
+        }
+      }
+    ],
+    "templateMetadata": {
+      "identifyByStructure": true
+    }
+  }
+}

package/kits/youtube-content-plan/skills/analytics-insights/SKILL.md

@@ -0,0 +1,166 @@
+---
+id: analytics-insights
+name: analytics-insights
+description: Interpret YouTube analytics and suggest data-driven improvements
+version: "1.0.0"
+type: invocable
+requiresVision: false
+requiresData: false
+---
+
+## YouTube Analytics Insights Skill
+
+When the user invokes `/analytics`, help them interpret their YouTube analytics and identify actionable improvements.
+
+### Invocation Patterns
+
+- `/analytics` - Overall channel analysis
+- `/analytics [video]` - Specific video analysis
+- `/analytics retention` - Audience retention deep-dive
+- `/analytics growth` - Growth opportunities
+
+### Key Metrics Overview
+
+**Watch Time**
+- Total hours watched
+- Average view duration
+- Indicates content quality
+- Most important for algorithm
+
+**Views & Traffic**
+- Total views
+- Traffic sources
+- Impression sources
+- Geographic distribution
+
+**Engagement**
+- Likes, comments, shares
+- Subscriber conversion
+- End screen clicks
+- Card clicks
+
+**Revenue (if monetized)**
+- RPM (Revenue per mille)
+- CPM (Cost per mille)
+- Best performing content
+
+### Output Format
+
+```markdown
+## Analytics Insights: [Channel/Video]
+
+### Performance Summary
+| Metric | Value | vs. Average | Trend |
+|--------|-------|-------------|-------|
+| Views | X | +/-X% | 📈/📉 |
+| Watch Time | X hrs | +/-X% | 📈/📉 |
+| Avg View Duration | X:XX | +/-X% | 📈/📉 |
+| CTR | X% | +/-X% | 📈/📉 |
+| Engagement Rate | X% | +/-X% | 📈/📉 |
+
+### Retention Analysis
+```
+[Audience retention graph interpretation]
+
+Key moments:
+- 0:00-0:30: [Hook effectiveness]
+- X:XX: [Drop-off point - why?]
+- X:XX: [Spike - what worked?]
+- End: [Retention at end]
+```
+
+### Traffic Source Breakdown
+| Source | Views | % | Opportunity |
+|--------|-------|---|-------------|
+| Search | X | X% | [Action] |
+| Suggested | X | X% | [Action] |
+| Browse | X | X% | [Action] |
+| External | X | X% | [Action] |
+
+### Top Performing Content
+1. **[Video Title]**
+   - Why it worked: [Analysis]
+   - Replicate: [What to copy]
+
+2. **[Video Title]**
+   - Why it worked: [Analysis]
+
+### Underperforming Content
+1. **[Video Title]**
+   - Issue: [What went wrong]
+   - Fix: [Recommendation]
+
+### Audience Insights
+- **Peak activity**: [Days/times]
+- **Demographics**: [Age/gender/location]
+- **Returning viewers**: X%
+- **New viewers**: X%
+
+### Actionable Recommendations
+
+#### Immediate Actions
+1. [Specific action with expected impact]
+2. [Specific action with expected impact]
+
+#### Content Strategy
+- [Topic/format to do more of]
+- [Topic/format to stop/reduce]
+- [New opportunity to test]
+
+#### Optimization Opportunities
+- [Thumbnail/title improvements]
+- [SEO optimizations]
+- [Posting schedule adjustments]
+```
+
+### Retention Analysis Guide
+
+**Healthy Retention Curve**
+- First 30 sec: 70%+ staying
+- 50% point: Around middle
+- End: 30%+ for longer videos
+
+**Common Drop-off Causes**
+- 0-30s: Hook didn't deliver
+- Early drop: Intro too long
+- Mid-video: Content gets boring
+- Before CTA: Saw the end coming
+
+**Spikes Indicate**
+- Rewatching valuable content
+- Shared timestamps
+- Controversial moments
+
+### Benchmarks by Category
+
+**Entertainment**
+- CTR: 4-10%
+- Retention: 40-50%
+
+**Education/Tutorial**
+- CTR: 2-5%
+- Retention: 50-70%
+
+**Vlog/Personal**
+- CTR: 5-10%
+- Retention: 30-40%
+
+### Growth Levers
+
+**To Increase Views**
+- Improve CTR (titles/thumbnails)
+- Target better keywords
+- Post more consistently
+- Ride trends
+
+**To Increase Watch Time**
+- Improve retention
+- Make longer content
+- Create binge-worthy series
+- Better hooks
+
+**To Increase Subscribers**
+- Ask for subs (strategic timing)
+- Deliver value consistently
+- Create community
+- End screen optimization

package/kits/youtube-content-plan/skills/analyze-performance/SKILL.md

@@ -0,0 +1,43 @@
+---
+id: analyze-performance
+name: Analyze Video Performance
+description: Review video analytics and generate insights
+version: "1.0.0"
+type: invocable
+parameters: [videoTitle]
+requiresVision: false
+requiresData: false
+---
+
+## Analyze Video Performance
+
+Review video analytics and generate insights
+
+### Steps
+
+1. Review CTR compared to channel average
+2. Analyze retention curve - find drop-off points
+3. Check traffic sources breakdown
+4. Compare suggested video performance
+5. Review comments for feedback themes
+6. Identify what worked well
+7. Identify areas for improvement
+8. Create action items for next video
+9. Update analytics tracking document
+
+### Inputs Required
+
+- **videoTitle** (required): Video to analyze
+
+### Expected Outputs
+
+- Performance analysis
+- Insights and recommendations
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "analyze video"
+- "video performance"
+- "how did it do"
+- "video analytics"

package/kits/youtube-content-plan/skills/develop-video-idea/SKILL.md

@@ -0,0 +1,45 @@
+---
+id: develop-video-idea
+name: Develop Video Idea
+description: Turn a topic into a structured video concept
+version: "1.0.0"
+type: invocable
+parameters: [topic]
+requiresVision: true
+requiresData: false
+---
+
+## Develop Video Idea
+
+Turn a topic into a structured video concept
+
+### Steps
+
+1. Define the core topic and target viewer
+2. Research what's already ranking for this topic
+3. Identify your unique angle or value-add
+4. Write 5 potential titles (front-load keywords)
+5. Design thumbnail concept (emotion + text + visual)
+6. Write the hook (first 5 seconds)
+7. Outline the main content sections
+8. Plan the call-to-action
+9. Add to content calendar
+
+### Inputs Required
+
+- **topic** (required): Video topic or idea
+- **targetViewer** (optional): Who is this for?
+
+### Expected Outputs
+
+- Video concept document
+- Title options
+- Thumbnail concept
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "video idea"
+- "new video about"
+- "develop video"
+- "content idea"

package/kits/youtube-content-plan/skills/generate-ideas/SKILL.md

@@ -0,0 +1,42 @@
+---
+id: generate-ideas
+name: Generate Video Ideas
+description: Brainstorm video ideas based on strategy and trends
+version: "1.0.0"
+type: invocable
+requiresVision: false
+requiresData: false
+---
+
+## Generate Video Ideas
+
+Brainstorm video ideas based on strategy and trends
+
+### Steps
+
+1. Review channel content pillars
+2. Analyze what's performing well on the channel
+3. Research trending topics in the niche
+4. Check competitor content for inspiration
+5. Generate 10 topic ideas
+6. Rate each by: searchability, passion, uniqueness
+7. Identify top 5 to add to backlog
+8. Prioritize by potential impact
+9. Add to content calendar
+
+### Inputs Required
+
+- **pillar** (optional): Content pillar to focus on
+
+### Expected Outputs
+
+- 10 video ideas with ratings
+- Prioritized top 5
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "video ideas"
+- "what should I make"
+- "brainstorm content"
+- "ideas for videos"