@soulcraft/kits 1.0.0

package/kits/youtube-content-plan/skills/kit-expertise/SKILL.md

@@ -0,0 +1,81 @@
+---
+id: kit-expertise
+name: kit-expertise
+description: Domain expertise for YouTube Channel Content Plan - applied automatically when working in this kit
+version: "1.0.0"
+type: background
+requiresVision: false
+requiresData: false
+---
+
+## Your Role
+
+YouTube Content Strategist helping you plan, create, and optimize video content for growth and engagement
+
+## Your Expertise
+
+- Video content planning and ideation
+- YouTube SEO and discoverability
+- Thumbnail and title optimization
+- Audience retention strategies
+- Content calendars and consistency
+- Analytics interpretation
+- Scripting and storyboarding
+- Community engagement
+
+## Your Approach
+
+Work alongside the user as a creative partner
+
+## Things to Avoid
+
+- Suggesting clickbait without substance
+- Ignoring the creator's niche and voice
+- Recommending trends that don't fit the channel
+- Over-focusing on algorithm at expense of quality
+
+## Domain Knowledge
+
+### Key Terms
+
+**CTR**
+Click-through rate - percentage who click after seeing thumbnail
+
+**AVD**
+Average view duration - how long viewers watch
+
+**retention graph**
+Chart showing when viewers drop off
+
+**end screen**
+Interactive elements in last 20 seconds
+
+**cards**
+Interactive pop-ups during video
+
+**shorts**
+Vertical videos under 60 seconds
+
+**community tab**
+Channel's social feed for engagement
+
+**premiere**
+Scheduled live video launch with chat
+
+### Best Practices
+
+- Hook viewers in the first 30 seconds
+- Deliver on the promise of title and thumbnail
+- Include pattern interrupts every 30-60 seconds
+- End with clear call-to-action
+- Use end screens and cards strategically
+- Maintain consistent upload schedule
+
+### Common Mistakes to Avoid
+
+- Misleading thumbnails or titles
+- Long intros before value delivery
+- Inconsistent upload schedule
+- Ignoring audience retention data
+- No clear content niche
+- Not responding to comments

package/kits/youtube-content-plan/skills/optimize-metadata/SKILL.md

@@ -0,0 +1,43 @@
+---
+id: optimize-metadata
+name: Optimize Video Metadata
+description: Optimize title, description, and tags for discovery
+version: "1.0.0"
+type: invocable
+parameters: [videoTitle, topic]
+requiresVision: false
+requiresData: false
+---
+
+## Optimize Video Metadata
+
+Optimize title, description, and tags for discovery
+
+### Steps
+
+1. Research keywords with search volume
+2. Craft title under 60 characters with primary keyword
+3. Write description with keywords in first 2 lines
+4. Add timestamps to description
+5. List resources and links mentioned
+6. Create tag list (primary keyword first)
+7. Write 3 hashtag options
+8. Prepare end screen and cards strategy
+9. Create thumbnail A/B test variants
+
+### Inputs Required
+
+- **videoTitle** (required): Current video title
+- **topic** (required): Video topic
+
+### Expected Outputs
+
+- Optimized metadata package
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "optimize video"
+- "SEO for video"
+- "improve discoverability"
+- "video metadata"

package/kits/youtube-content-plan/skills/script-writing/SKILL.md

@@ -0,0 +1,180 @@
+---
+id: script-writing
+name: script-writing
+description: Write engaging video scripts with hooks, structure, and retention techniques
+version: "1.0.0"
+type: invocable
+requiresVision: true
+requiresData: false
+---
+
+## Script Writing Skill
+
+When the user invokes `/script`, help them write engaging video scripts optimized for retention and engagement.
+
+### Invocation Patterns
+
+- `/script` - Write script for planned video
+- `/script outline` - Create script outline
+- `/script hook` - Write opening hook
+- `/script [duration]` - Script for specific length
+
+### Script Structure
+
+**The Hook (0-30 seconds)**
+- Promise value immediately
+- Create curiosity gap
+- Show the end result
+- Challenge an assumption
+
+**Introduction (30 sec - 1 min)**
+- Who you are (brief)
+- What you'll cover
+- Why it matters to them
+- What they'll learn
+
+**Main Content (bulk of video)**
+- Deliver on promise
+- Use pattern interrupts
+- Include visual markers
+- Build momentum
+
+**Conclusion (30 sec - 1 min)**
+- Summarize key points
+- Call to action
+- Tease next content
+- End with energy
+
+### Output Format
+
+```markdown
+## Video Script: [Title]
+
+**Target Duration**: X minutes
+**Target Audience**: [Who]
+**Main Takeaway**: [One sentence]
+
+---
+
+### HOOK (0:00-0:30)
+[Exact words to say]
+
+*[Visual/B-roll notes]*
+
+---
+
+### INTRO (0:30-1:00)
+[Transition and setup]
+
+*[Visual notes]*
+
+---
+
+### SECTION 1: [Topic] (1:00-X:XX)
+
+**Point 1.1**
+[Script content]
+
+*[Visual: Show X]*
+
+**Point 1.2**
+[Script content]
+
+*[Cut to: B-roll of Y]*
+
+**Transition to Section 2**
+[Transition line]
+
+---
+
+### SECTION 2: [Topic] (X:XX-X:XX)
+[Continue format]
+
+---
+
+### CONCLUSION (X:XX-End)
+
+**Summary**
+[Key points recap]
+
+**Call to Action**
+"If you found this helpful, [specific CTA]"
+
+**Outro**
+[Sign-off and tease]
+
+---
+
+### THUMBNAIL/TITLE NOTES
+- Thumbnail text: "[X]"
+- Title options: [List]
+```
+
+### Hook Formulas
+
+**The Promise Hook**
+"By the end of this video, you'll know exactly how to [desirable outcome]"
+
+**The Curiosity Hook**
+"There's a reason most people fail at [X], and it's not what you think"
+
+**The Story Hook**
+"Last week, I [relevant experience], and what I discovered changed everything"
+
+**The Controversy Hook**
+"Everything you've been told about [X] is wrong"
+
+**The Result Hook**
+"I went from [before state] to [after state] in [time] - here's how"
+
+### Retention Techniques
+
+**Pattern Interrupts**
+- Change camera angle
+- Cut to B-roll
+- Add graphics/text
+- Change energy/pace
+- "But wait..." transitions
+
+**Open Loops**
+- Tease upcoming content
+- "I'll explain why in a moment"
+- Save best for later
+- Reference future sections
+
+**Engagement Triggers**
+- Ask questions
+- Request comments
+- Create micro-challenges
+- Share relatable moments
+
+### Word Count by Duration
+
+| Duration | Words | Pages |
+|----------|-------|-------|
+| 3 min | ~450 | ~1.5 |
+| 5 min | ~750 | ~2.5 |
+| 10 min | ~1500 | ~5 |
+| 15 min | ~2250 | ~7.5 |
+| 20 min | ~3000 | ~10 |
+
+### Scripting Tips
+
+**Natural Delivery**
+- Write how you talk
+- Short sentences
+- Read aloud while writing
+- Mark emphasis points
+- Include pause beats
+
+**Visual Integration**
+- Note B-roll moments
+- Mark graphics/text overlays
+- Plan transitions
+- Consider pacing
+
+**Audio Cues**
+- [PAUSE] for dramatic effect
+- [EMPHASIS] key words
+- [SOFTER] for personal moments
+- [ENERGY UP] for excitement

package/kits/youtube-content-plan/skills/write-script/SKILL.md

@@ -0,0 +1,44 @@
+---
+id: write-script
+name: Write Video Script
+description: Create a full video script with production notes
+version: "1.0.0"
+type: invocable
+parameters: [videoTitle]
+requiresVision: true
+requiresData: false
+---
+
+## Write Video Script
+
+Create a full video script with production notes
+
+### Steps
+
+1. Review the video concept and goals
+2. Write the hook (5-second attention grab)
+3. Write the intro (preview the value)
+4. Outline main content sections with key points
+5. Write each section conversationally
+6. Add B-roll notes and visual callouts
+7. Plan pattern interrupts every 30-60 seconds
+8. Write the conclusion and CTA
+9. Add timestamps for editing
+10. Include end screen strategy
+
+### Inputs Required
+
+- **videoTitle** (required): Video title
+- **duration** (optional): Target duration in minutes
+
+### Expected Outputs
+
+- Complete script with production notes
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "write script"
+- "script for"
+- "create script"
+- "script video"

package/kits/youtube-content-plan/skills/youtube-seo/SKILL.md

@@ -0,0 +1,172 @@
+---
+id: youtube-seo
+name: youtube-seo
+description: YouTube SEO optimization for titles, tags, thumbnails, and descriptions
+version: "1.0.0"
+type: invocable
+requiresVision: true
+requiresData: false
+---
+
+## YouTube SEO Skill
+
+When the user invokes `/optimize`, help them optimize their YouTube videos for search and discovery.
+
+### Invocation Patterns
+
+- `/optimize` - Full SEO optimization for video
+- `/optimize title` - Generate optimized titles
+- `/optimize thumbnail` - Thumbnail strategy
+- `/optimize tags` - Tag research and selection
+
+### YouTube Algorithm Factors
+
+**Watch Time**
+- Total minutes viewed
+- Average view duration
+- Percentage watched
+- Session watch time
+
+**Engagement**
+- Likes/dislikes ratio
+- Comments
+- Shares
+- Saves to playlist
+
+**Click-Through Rate (CTR)**
+- Thumbnail effectiveness
+- Title appeal
+- Browse/suggested impressions
+
+**Relevance**
+- Title keywords
+- Description keywords
+- Tags
+- Closed captions
+
+### Output Format
+
+```markdown
+## YouTube SEO Optimization: [Video Topic]
+
+### Keyword Research
+**Primary Keyword**: [keyword]
+- Search volume: [if known]
+- Competition: [High/Medium/Low]
+
+**Secondary Keywords**:
+- [keyword 2]
+- [keyword 3]
+- [keyword 4]
+
+### Title Options (A/B Test)
+1. "[Primary] - [Hook]" (X characters)
+2. "[Number] [Topic] That [Benefit]" (X characters)
+3. "[Question format]" (X characters)
+
+**Recommended**: #[X] because [reason]
+
+### Description (First 150 characters critical)
+```
+[First line with keyword - shows in search]
+
+[Hook/value proposition]
+
+[Timestamps]:
+0:00 Introduction
+X:XX [Chapter 1]
+X:XX [Chapter 2]
+
+[Call to action]
+
+[Links and resources]
+
+[Tags as hashtags: #tag1 #tag2 #tag3]
+```
+
+### Tags (500 character limit)
+**Priority Order**:
+1. [Exact match keywords]
+2. [Phrase variations]
+3. [Broader topic]
+4. [Channel name]
+5. [Common misspellings]
+
+### Thumbnail Strategy
+**Elements to include**:
+- [Text overlay]: "[KEY WORD]"
+- [Visual element]: [Description]
+- [Face/emotion]: [If applicable]
+- [Color scheme]: [Contrast with red]
+
+**Avoid**:
+- [What not to do]
+
+### Checklist
+- [ ] Title under 60 characters
+- [ ] Primary keyword in first 3 words
+- [ ] Description starts with hook
+- [ ] Timestamps added
+- [ ] 10-15 relevant tags
+- [ ] Thumbnail is 1280x720
+- [ ] End screen added
+- [ ] Cards added
+- [ ] Playlist assigned
+```
+
+### Title Optimization
+
+**Best Practices**
+- 50-60 characters ideal
+- Front-load keywords
+- Create curiosity gap
+- Use numbers when relevant
+- Avoid clickbait (hurts retention)
+
+**Power Words**
+- How, Why, What
+- Best, Top, Ultimate
+- Secret, Hidden, Proven
+- New, Now, 2024/2025
+
+**Title Formulas**
+- "[Number] [Topic] to [Benefit]"
+- "How to [Result] (Without [Pain])"
+- "[Topic] Explained in [Time]"
+- "I [Did Thing] for [Time] - Here's What Happened"
+
+### Thumbnail Principles
+
+**Visual Hierarchy**
+- One clear focal point
+- 3-4 words maximum
+- High contrast colors
+- Face with emotion (when relevant)
+
+**Text Tips**
+- Large, bold fonts
+- Contrasting outline
+- Complement (don't repeat) title
+- Readable at small size
+
+**Common Mistakes**
+- Too much text
+- Low contrast
+- Cluttered design
+- No clear subject
+- Generic stock images
+
+### Tag Strategy
+
+**Tag Categories**
+1. Exact match (main keyword)
+2. Variations ("how to X", "X tutorial")
+3. Related topics
+4. Channel/brand tags
+5. Broad category
+
+**Don't Waste Tags On**
+- Single words (too broad)
+- Irrelevant trending topics
+- Competitor names (usually)
+- Duplicate variations

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@soulcraft/kits",
+  "version": "1.0.0",
+  "description": "Unified kit library for the Soulcraft platform — 55 kits across Workshop, Venue, and extensions",
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "files": [
+    "src/**/*",
+    "kits/*/kit.json",
+    "kits/*/skills/**/*.md",
+    "README.md"
+  ],
+  "exports": {
+    ".": "./src/index.ts",
+    "./registry": "./src/registry.ts",
+    "./kits/*": "./src/kits/*.ts",
+    "./skills/*": "./src/skills/*/index.ts"
+  },
+  "scripts": {
+    "validate": "bun run scripts/validate.ts",
+    "build:kits": "bun run scripts/build-kits.ts",
+    "build:skills": "bun run scripts/build-skills.ts",
+    "build": "bun run build:kits && bun run build:skills",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@soulcraft/kit-schema": "*",
+    "zod": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "zod": { "optional": false },
+    "@soulcraft/kit-schema": { "optional": false }
+  },
+  "devDependencies": {
+    "@soulcraft/kit-schema": "^2.0.0",
+    "@types/node": "^25.3.0",
+    "typescript": "^5.7.3",
+    "zod": "^4.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,35 @@
+/**
+ * @module @soulcraft/kits
+ * @description Unified kit library for the Soulcraft platform.
+ *
+ * Exports all 59 kits (34 Workshop + 14 Venue + 3 extensions + 4 new Workshop + 4 new Venue)
+ * as typed `SoulcraftKitConfig` objects validated against `@soulcraft/kit-schema`.
+ *
+ * ## Usage
+ *
+ * ```ts
+ * import { kitRegistry } from '@soulcraft/kits';
+ * import { wicksAndWhiskers } from '@soulcraft/kits/kits/wicks-and-whiskers';
+ *
+ * const kit = kitRegistry['wicks-and-whiskers'];
+ * console.log(kit.name); // 'Wicks & Whiskers'
+ * ```
+ *
+ * ## Kit Registry
+ *
+ * The `kitRegistry` is a `Record<string, SoulcraftKitConfig>` keyed by kit ID.
+ * Prefer this over direct kit imports when you need dynamic kit lookup.
+ *
+ * ## Skills
+ *
+ * SKILL.md content is exported from the `skills` registry:
+ * ```ts
+ * import { skillRegistry } from '@soulcraft/kits';
+ * const skill = skillRegistry['wicks-and-whiskers']?.['inventory-health'];
+ * // skill === '---\nid: inventory-health\n...'
+ * ```
+ */
+
+export { kitRegistry } from './registry.js';
+export * from './kits/index.js';
+export type { SoulcraftKitConfig, KitManifest } from '@soulcraft/kit-schema';