@intentsolutionsio/youtube-strategy 1.0.0 → 1.0.1

package/agents/channel-analyzer.md

@@ -34,6 +34,7 @@ You are a YouTube competitive intelligence analyst. For each channel in your bat
 ### 4. Content Gap Identification
 
 Using the strategy context provided:
+
 - What topics does the target audience care about that this channel covers poorly or not at all?
 - What content formats does this channel NOT use that could work?
 - Where does this channel go too technical for the target audience?
@@ -42,6 +43,7 @@ Using the strategy context provided:
 ### 5. Opportunity Assessment
 
 For each channel, produce:
+
 - **Steal-worthy patterns:** What's working that should be adapted
 - **Content gaps:** What they're missing that can be filled
 - **Differentiation notes:** How a different approach would stand out for the same topic
@@ -50,6 +52,7 @@ For each channel, produce:
 ## Output Format
 
 Save as JSON array to the specified file path:
+
 ```json
 [
   {

package/agents/idea-validator.md

@@ -13,6 +13,7 @@ You are a YouTube content strategy validator. For each video idea in your batch,
 ### 1. Search Demand Assessment
 
 Use WebSearch to check:
+
 - YouTube search volume signals (autocomplete suggestions, related searches)
 - Google Trends data for the topic/tool
 - Reddit/forum discussions indicating interest
@@ -23,6 +24,7 @@ Score: **High** (actively searched, trending up), **Medium** (some demand, stead
 ### 2. Competition Analysis
 
 Use WebSearch to check YouTube for existing videos on this exact topic:
+
 - How many videos already exist on this topic?
 - Who made them? (competitor channels or random small channels?)
 - How old are the top results? (old = opportunity for fresh content)
@@ -42,6 +44,7 @@ Score: **Rising** (trending up, act now), **Stable** (evergreen, no urgency), **
 ### 4. Audience Fit
 
 Using the strategy context provided:
+
 - Does this topic serve the target audience?
 - Is the tool/feature accessible at the right skill level?
 - Would the audience find this practically useful (not just interesting)?
@@ -52,6 +55,7 @@ Score: **Strong** (core audience, high relevance), **Moderate** (adjacent, some
 ### 5. Opportunity Score
 
 Combine all signals into an overall opportunity score (1-10):
+
 - High demand + Low competition + Rising trend + Strong audience fit = 9-10
 - Medium demand + Medium competition + Stable trend + Strong fit = 6-8
 - Low demand or High competition or Weak audience fit = 1-5
@@ -59,6 +63,7 @@ Combine all signals into an overall opportunity score (1-10):
 ## Output Format
 
 Save as JSON array to the specified file path:
+
 ```json
 [
   {

package/agents/yt-scraper.md

@@ -53,6 +53,7 @@ Use `offset` and `limit` parameters for pagination on large datasets. Save each
 ## Output
 
 Save JSON files to the specified directory. Report:
+
 - Total channels scraped (with data vs without data)
 - Total videos fetched
 - Total search results fetched

package/commands/yt-pipeline.md

@@ -34,10 +34,12 @@ Use web research and optional sub-agents for parallel execution:
 ### 1.2 Merge and Report
 
 After all research completes, merge results into:
+
 - `niche-analysis.json` - structured data
 - `niche-report.md` - human-readable summary
 
 Report to user:
+
 ```
 Research complete.
 - Channels analyzed: [N]
@@ -48,6 +50,7 @@ Research complete.
 
 Present the niche report and ask:
 "Here's what I found. Ready to move to ideation, or want to research more channels?"
+
 - Move to ideation
 - Research additional channels
 - Dig deeper into a specific channel
@@ -60,6 +63,7 @@ Present the niche report and ask:
 ### 2.1 Generate Ideas
 
 Using research findings, generate 15-20 video ideas. Each idea must include:
+
 - **Title concept** (working title)
 - **Content tier** (Tier 1 or Tier 2)
 - **Content type** (Full Tutorial, Feature Tutorial, Update Video, Use Case Video, etc.)
@@ -83,6 +87,7 @@ Here are the validated ideas, ranked by opportunity score:
 
 Which ideas do you want to develop into briefs?
 ```
+
 - Pick 1-3 ideas
 - Generate more ideas
 - Adjust the focus area
@@ -100,6 +105,7 @@ For each idea the user selects:
 4. Present to user for review
 
 "Here's the brief for '{idea title}'. Review and approve?"
+
 - Approve and move to packaging
 - Adjust the angle
 - Change key points
@@ -116,6 +122,7 @@ For each approved brief:
 3. Output: `packaging-{slug}.md`
 
 "Here are the title and thumbnail options. Pick your favorites."
+
 - Pick title + thumbnail direction
 - Request more options
 - Adjust the angle

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentsolutionsio/youtube-strategy",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Complete YouTube content production workflow: research competitors, generate video ideas, build briefs, craft titles and thumbnails, and create detailed video outlines with demo prep checklists.",
   "keywords": [
     "youtube",

package/skills/yt-brief/SKILL.md

@@ -1,16 +1,26 @@
 ---
 name: yt-brief
-description: |
-  Refine a YouTube video idea into a structured production brief with angle, key points, value proposition,
-  CTA asset, and audience segment. Use this skill whenever the user says "create a brief", "brief this idea",
-  "develop this idea", "write a video brief", "production brief", or has selected a video idea from ideation
-  and wants to define the angle and structure before packaging and outlining. Use when working with yt brief. Trigger with 'yt', 'brief'.
+description: 'Refine a YouTube video idea into a structured production brief with
+  angle, key points, value proposition,
+
+  CTA asset, and audience segment. Use this skill whenever the user says "create a
+  brief", "brief this idea",
+
+  "develop this idea", "write a video brief", "production brief", or has selected
+  a video idea from ideation
+
+  and wants to define the angle and structure before packaging and outlining. Use
+  when working with yt brief. Trigger with ''yt'', ''brief''.
+
+  '
 allowed-tools: WebSearch, Read, Write
 version: 1.0.0
 author: Claude Code Plugins <plugins@claudecodeplugins.io>
 license: MIT
-compatible-with: claude-code, codex, openclaw
-tags: [productivity, yt-brief]
+tags:
+- productivity
+- yt-brief
+compatibility: Designed for Claude Code, also compatible with Codex and OpenClaw
 ---
 # YouTube Brief
 
@@ -30,6 +40,7 @@ If the user is coming from the ideation flow, load `validated_ideas.json` for th
 ### Step 1: Research the Topic
 
 Before writing the brief, understand the topic deeply:
+
 - What does this feature/tool actually do? (Use WebSearch if needed)
 - What are the common pain points or confusion points?
 - What existing content exists? What angle would differentiate this video?
@@ -40,16 +51,19 @@ Before writing the brief, understand the topic deeply:
 Work with the user to lock in:
 
 **Content Type & Tier:**
+
 - Confirm which tier and category this falls under
 - This determines the format, length, and production approach
 
 **The Angle:**
+
 - What's the unique take? Why would someone click THIS video over alternatives?
 - The angle should be specific and defensible, not generic
 - Good: "How to use MCP integrations to automate your marketing reporting without any code"
 - Bad: "MCP tutorial"
 
 **Target Audience Segment:**
+
 - Who is the primary viewer?
 - What's their starting knowledge level for this topic?
 
@@ -80,6 +94,7 @@ Present the complete brief and ask:
 ```
 
 "What would you like to adjust?"
+
 - Approve - move to packaging
 - Adjust the angle
 - Add/remove key points
@@ -143,4 +158,4 @@ Refine a YouTube video idea into a structured production brief with angle, key p
 
 - Official Yt Brief documentation
 - Community best practices and patterns
-- Related skills in this plugin pack
+- Related skills in this plugin pack

package/skills/yt-ideation/SKILL.md

@@ -1,16 +1,26 @@
 ---
 name: yt-ideation
-description: |
-  Generate and validate YouTube video ideas aligned with content pillars, audience strategy,
-  and priority tiers. Use this skill whenever the user says "generate ideas", "brainstorm videos",
-  "what should I make next", "video ideas", "content ideas", "ideation", "what topics should I cover",
-  or wants to come up with new video concepts. Use when working with yt ideation. Trigger with 'yt', 'ideation'.
+description: 'Generate and validate YouTube video ideas aligned with content pillars,
+  audience strategy,
+
+  and priority tiers. Use this skill whenever the user says "generate ideas", "brainstorm
+  videos",
+
+  "what should I make next", "video ideas", "content ideas", "ideation", "what topics
+  should I cover",
+
+  or wants to come up with new video concepts. Use when working with yt ideation.
+  Trigger with ''yt'', ''ideation''.
+
+  '
 allowed-tools: WebSearch, Read, Write, Task
 version: 1.0.0
 author: Claude Code Plugins <plugins@claudecodeplugins.io>
 license: MIT
-compatible-with: claude-code, codex, openclaw
-tags: [productivity, yt-ideation]
+tags:
+- productivity
+- yt-ideation
+compatibility: Designed for Claude Code, also compatible with Codex and OpenClaw
 ---
 # YouTube Ideation
 
@@ -31,6 +41,7 @@ If the user provided focus already, confirm and proceed.
 ### Step 1: Load Context
 
 Understand the creator's:
+
 - **Content pillars** - What core topics does the channel focus on?
 - **Audience** - Who are the viewers? What's their skill level?
 - **Content types** - What formats work best? (tutorials, reviews, updates, comparisons)
@@ -41,26 +52,31 @@ Understand the creator's:
 Use these ideation methods:
 
 **Method 1: Gap Analysis** (if research data available)
+
 - Content gaps from competitor analysis
 - Topics with high demand but low competition
 - Complex concepts that need accessible translation
 
 **Method 2: Trend Riding**
+
 - Recent tool updates or feature launches
 - Industry developments relevant to the audience
 - Viral topics that can be made practical
 
 **Method 3: Format Innovation**
+
 - Existing topics in new formats (comparison, mega-guide, use-case compilation)
 - Content types competitors aren't using
 - Series potential (multi-part tutorials)
 
 **Method 4: Audience Needs**
+
 - Questions the audience is asking (Reddit, YouTube comments, community)
 - Problems viewers face with the tools they use
 - "How do I..." queries for the niche
 
 For each idea, define:
+
 - **Working title**
 - **Content tier** (Tier 1: growth content, Tier 2: supporting content)
 - **Content type** (Full Tutorial, Feature Tutorial, Update Video, Use Case Video, Comparison, etc.)
@@ -68,12 +84,14 @@ For each idea, define:
 - **Timeliness** (trending/urgent or evergreen)
 
 **Priority distribution:**
+
 - 60-70% Tier 1 ideas (the growth engine)
 - 30-40% Tier 2 ideas (supporting content)
 
 ### Step 3: Quick Self-Filter
 
 Before validation, run each idea through a strategy test:
+
 - Does it serve the target audience? (Must be yes)
 - Can it be practically demonstrated? (Prefer yes)
 - Does it support the content funnel? (Can we give away an asset?)
@@ -84,6 +102,7 @@ Remove ideas that fail the test. Note why for transparency.
 ### Step 4: Validate Ideas
 
 Spawn `idea-validator` sub-agents (5 ideas per agent) to assess:
+
 - Search demand (YouTube autocomplete, Google Trends, forums)
 - Competition level (existing videos, quality bar)
 - Trend direction (rising, stable, declining)
@@ -110,6 +129,7 @@ Which ideas do you want to develop into briefs?
 ```
 
 Options:
+
 - Pick 1-3 ideas to brief
 - Generate more ideas in a different direction
 - Refine a specific idea before briefing
@@ -165,4 +185,4 @@ Generate and validate YouTube video ideas aligned with content pillars, audience
 
 - Official ORM documentation
 - Community best practices and patterns
-- Related skills in this plugin pack
+- Related skills in this plugin pack

package/skills/yt-outline/SKILL.md

@@ -1,16 +1,26 @@
 ---
 name: yt-outline
-description: |
-  Build detailed step-by-step YouTube video outlines with demo prep, screen-share sequences, and visual
-  planning. Use this skill whenever the user says "create an outline", "outline this video", "video outline",
-  "build the outline", "production outline", or has an approved brief and packaging and needs the final
-  pre-production document before demo prep and filming. Use when working with yt outline. Trigger with 'yt', 'outline'.
+description: 'Build detailed step-by-step YouTube video outlines with demo prep, screen-share
+  sequences, and visual
+
+  planning. Use this skill whenever the user says "create an outline", "outline this
+  video", "video outline",
+
+  "build the outline", "production outline", or has an approved brief and packaging
+  and needs the final
+
+  pre-production document before demo prep and filming. Use when working with yt outline.
+  Trigger with ''yt'', ''outline''.
+
+  '
 allowed-tools: WebSearch, Read, Write
 version: 1.0.0
 author: Claude Code Plugins <plugins@claudecodeplugins.io>
 license: MIT
-compatible-with: claude-code, codex, openclaw
-tags: [productivity, yt-outline]
+tags:
+- productivity
+- yt-outline
+compatibility: Designed for Claude Code, also compatible with Codex and OpenClaw
 ---
 # YouTube Outline
 
@@ -29,6 +39,7 @@ You need:
 ### Step 1: Research the Topic in Depth
 
 Before writing the outline, deeply understand the feature/tool being demonstrated:
+
 - Verify all steps work as expected (use WebSearch to check documentation)
 - Identify potential gotchas or failure points
 - Note any prerequisites the viewer needs
@@ -39,6 +50,7 @@ Before writing the outline, deeply understand the feature/tool being demonstrate
 Based on the content type from the brief, choose the appropriate structure:
 
 **For Feature Tutorials (15-30 min):**
+
 1. Hook (30-60 sec) - What they'll be able to do by the end
 2. Context (1-2 min) - Why this matters, brief overview
 3. Core demonstration (10-20 min) - Step-by-step walkthrough
@@ -46,6 +58,7 @@ Based on the content type from the brief, choose the appropriate structure:
 5. CTA + wrap (1-2 min) - Asset giveaway, community mention
 
 **For Update Videos (10-20 min):**
+
 1. Hook (30 sec) - What just changed
 2. Overview (1-2 min) - What the update includes
 3. Walkthrough (8-15 min) - Demo each new feature
@@ -53,6 +66,7 @@ Based on the content type from the brief, choose the appropriate structure:
 5. CTA + wrap (1 min) - Asset giveaway
 
 **For Use Case Videos (15-30 min):**
+
 1. Hook (30-60 sec) - The impressive outcome
 2. Problem (1-2 min) - What manual process this replaces
 3. Solution overview (1-2 min) - High-level workflow
@@ -61,6 +75,7 @@ Based on the content type from the brief, choose the appropriate structure:
 6. CTA + wrap (1-2 min) - Asset giveaway
 
 **For Full Tutorials (30-90+ min):**
+
 1. Hook (1-2 min) - What they'll know by the end
 2. Overview/roadmap (2-3 min) - What the tutorial covers
 3. Setup (5-10 min) - Getting started from scratch
@@ -74,27 +89,32 @@ Based on the content type from the brief, choose the appropriate structure:
 For each section, specify:
 
 **Talking points:**
+
 - Key message for this section (not a script - bullet points)
 - Transition from previous section
 - Any specific phrases or analogies to use
 
 **What's on screen:**
+
 - Screen-share of what tool/feature
 - Specific actions to perform (click here, type this, navigate there)
 - Any diagrams, slides, or supporting visuals
 
 **Demo sequence:**
+
 - Exact steps to demonstrate
 - Expected outcome the viewer should see
 - What to do if something goes wrong (backup plan)
 
 **Timing:**
+
 - Target duration for this section
 - Running total to stay within target video length
 
 ### Step 4: Create Demo Prep Checklist
 
 For each demo in the outline, specify what the team needs to prepare:
+
 - Accounts and tools to have logged in
 - Sample data or projects to have ready
 - Environment settings (clean workspace, no notifications, etc.)
@@ -121,6 +141,7 @@ Also present the demo prep checklist separately:
 ```
 
 "Here's the outline and demo prep list. The team can start preparing."
+
 - Approve and start prep
 - Adjust section order
 - Add/remove sections
@@ -130,6 +151,7 @@ Also present the demo prep checklist separately:
 ### Step 6: Save
 
 Save two files:
+
 - `video-outline-yt-outline.md` - The full outline
 - `demo-prep-checklist-yt-outline.md` - The team's preparation checklist
 
@@ -184,4 +206,4 @@ Build detailed step-by-step YouTube video outlines with demo prep, screen-share
 
 - Official Yt Outline documentation
 - Community best practices and patterns
-- Related skills in this plugin pack
+- Related skills in this plugin pack

package/skills/yt-packaging/SKILL.md

@@ -1,16 +1,26 @@
 ---
 name: yt-packaging
-description: |
-  Create optimized YouTube titles and thumbnail concepts for maximum CTR. Use this skill whenever the user
-  says "title ideas", "thumbnail concepts", "package this video", "CTR optimization", "title options", "packaging",
-  or has an approved brief and needs to finalize the title and thumbnail direction before outlining. Packaging
-  determines whether viewers click. Use when working with yt packaging. Trigger with 'yt', 'packaging'.
+description: 'Create optimized YouTube titles and thumbnail concepts for maximum CTR.
+  Use this skill whenever the user
+
+  says "title ideas", "thumbnail concepts", "package this video", "CTR optimization",
+  "title options", "packaging",
+
+  or has an approved brief and needs to finalize the title and thumbnail direction
+  before outlining. Packaging
+
+  determines whether viewers click. Use when working with yt packaging. Trigger with
+  ''yt'', ''packaging''.
+
+  '
 allowed-tools: WebSearch, Read, Write
 version: 1.0.0
 author: Claude Code Plugins <plugins@claudecodeplugins.io>
 license: MIT
-compatible-with: claude-code, codex, openclaw
-tags: [productivity, yt-packaging]
+tags:
+- productivity
+- yt-packaging
+compatibility: Designed for Claude Code, also compatible with Codex and OpenClaw
 ---
 # YouTube Packaging
 
@@ -29,6 +39,7 @@ You need from the user:
 ### Step 1: Competitive Title Analysis
 
 Before writing titles, research what's already out there:
+
 - Search YouTube for the topic
 - Note the top 5-10 existing titles
 - Identify patterns: what words/structures appear in high-view videos?
@@ -40,25 +51,30 @@ Create 5-10 title options across different strategies:
 
 **Strategy A: Direct Benefit**
 Focus on what the viewer will be able to DO.
+
 - "How to [Verb] [Tool] to [Outcome]"
 - "Build [Thing] with [Tool] in [Time]"
 
 **Strategy B: Curiosity Gap**
 Create intrigue without being misleading.
+
 - "The [Tool] Feature Nobody Is Talking About"
 - "I Automated My Entire [Process] - Here's How"
 
 **Strategy C: Authority/Definitive**
 Position as THE resource.
+
 - "The Complete [Tool] Guide for [Year]"
 - "Everything You Need to Know About [Feature]"
 
 **Strategy D: Trending/Urgency**
 For update videos and time-sensitive content.
+
 - "[Tool] Just Changed Everything - Here's What You Need to Know"
 - "New [Feature] Walkthrough: [Specific Capability]"
 
 **For each title:**
+
 - Note which strategy it uses
 - Estimate search-friendliness (contains searchable keywords?)
 - Estimate curiosity factor (would you click?)
@@ -69,12 +85,14 @@ For update videos and time-sensitive content.
 Create 3-5 thumbnail concepts. Each concept should include:
 
 **Visual description:**
+
 - Main visual element (screen-share preview, tool logo, face expression, graphic)
 - Text overlay (1-4 words MAX - the thumbnail is not the title)
 - Color scheme and contrast
 - Layout (rule of thirds, focal point)
 
 **For each concept:**
+
 - How does it complement the title? (Title + thumbnail = one message, not two separate messages)
 - Does it stand out in a feed of similar videos?
 - Is it readable at mobile size (small thumbnail)?
@@ -83,6 +101,7 @@ Create 3-5 thumbnail concepts. Each concept should include:
 ### Step 4: A/B Test Variants
 
 For the top 2-3 title + thumbnail combos, suggest A/B testing variants:
+
 - Same title, different thumbnail approach
 - Same thumbnail, different title strategy
 - Small tweaks (word swaps, number inclusion)
@@ -118,6 +137,7 @@ Title #[X] + Thumbnail Concept [Y] because [reasoning]
 ```
 
 "Pick your title and thumbnail direction."
+
 - Go with recommended combo
 - Mix and match (pick different title + thumbnail)
 - Request more options
@@ -179,4 +199,4 @@ Create optimized YouTube titles and thumbnail concepts for maximum CTR.
 
 - Official optimization documentation
 - Community best practices and patterns
-- Related skills in this plugin pack
+- Related skills in this plugin pack

package/skills/yt-research/SKILL.md

@@ -1,16 +1,26 @@
 ---
 name: yt-research
-description: |
-  Research competitor YouTube channels, niches, and trending topics for your content strategy.
-  Use this skill whenever the user says "research channels", "analyze competitors", "find trending topics",
-  "niche analysis", "competitive research", "what are other creators doing", "scrape YouTube channels",
-  or wants to understand the competitive landscape for a specific tool or topic area. Use when working with yt research. Trigger with 'yt', 'research'.
+description: 'Research competitor YouTube channels, niches, and trending topics for
+  your content strategy.
+
+  Use this skill whenever the user says "research channels", "analyze competitors",
+  "find trending topics",
+
+  "niche analysis", "competitive research", "what are other creators doing", "scrape
+  YouTube channels",
+
+  or wants to understand the competitive landscape for a specific tool or topic area.
+  Use when working with yt research. Trigger with ''yt'', ''research''.
+
+  '
 allowed-tools: WebSearch, Read, Write, Task
 version: 1.0.0
 author: Claude Code Plugins <plugins@claudecodeplugins.io>
 license: MIT
-compatible-with: claude-code, codex, openclaw
-tags: [productivity, yt-research]
+tags:
+- productivity
+- yt-research
+compatibility: Designed for Claude Code, also compatible with Codex and OpenClaw
 ---
 # YouTube Research
 
@@ -31,6 +41,7 @@ If the user provided context already, confirm your understanding and proceed.
 ### Step 1: Scope the Research
 
 Define the research boundaries:
+
 - Which channels to scrape (user-provided + discovered competitors)
 - Which topics/keywords to search for
 - Time horizon (recent 30 days, 90 days, or all-time)
@@ -40,6 +51,7 @@ Tell the user the plan: "I'll analyze [N] channels and search for [keywords]. Th
 ### Step 2: Collect Channel Data
 
 Use web research to collect:
+
 - Channel metadata (subscribers, total videos, posting frequency)
 - Recent videos (last 30-50 per channel): titles, views, likes, comments, publish dates
 - Video tags and categories where available
@@ -49,6 +61,7 @@ If Apify MCP is available, spawn `yt-scraper` sub-agent for bulk data collection
 ### Step 3: Analyze Channels
 
 For each channel, analyze:
+
 - Engagement pattern analysis (what gets views vs what doesn't)
 - Content type distribution (tutorials, reviews, updates, opinions)
 - Title pattern analysis (what structures and words correlate with views)
@@ -62,16 +75,19 @@ If analyzing 4+ channels, spawn `channel-analyzer` sub-agents (3 channels per ag
 Using the analysis results, identify:
 
 **Content Gaps:**
+
 - Topics the audience searches for but competitors cover poorly
 - Topics that are developer-focused everywhere but could be made accessible
 - Recent tool updates/features with no quality coverage yet
 
 **Trending Signals:**
+
 - Tools/features getting increasing search interest
 - Topics with recent outlier videos (sudden view spikes)
 - Community discussions (Reddit, forums) indicating unmet demand
 
 **Strategic Fit:**
+
 - Which opportunities align with the creator's content pillars?
 - Which serve the target audience?
 - Which have the best effort-to-impact ratio?
@@ -90,9 +106,11 @@ Generate two outputs:
 Present the report to the user:
 
 "Here's the research report. Key findings:"
+
 - [Top 3 findings]
 
 "What would you like to do?"
+
 - Move to ideation with these insights
 - Research additional channels
 - Dig deeper into a specific finding
@@ -148,4 +166,4 @@ Research competitor YouTube channels, niches, and trending topics for your conte
 
 - Official content documentation
 - Community best practices and patterns
-- Related skills in this plugin pack
+- Related skills in this plugin pack