Video Content Strategist Skill
Overview
Production-ready video content strategy toolkit for planning content calendars, analyzing thumbnail effectiveness, and optimizing video metadata for platform SEO. Designed for content creators, marketing teams, and video producers managing consistent video output across YouTube, TikTok, LinkedIn, and other platforms.
Clarify First
Before planning, confirm these inputs. If any is unknown or vague, ASK — do not assume:
Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
Quick Start
# Plan a video content calendar from topics and audience data
python scripts/video_content_planner.py topics.json --weeks 8 --frequency 3
# Analyze thumbnail text and composition patterns
python scripts/thumbnail_analyzer.py thumbnails.csv
# Optimize video titles, descriptions, and tags for SEO
python scripts/video_seo_optimizer.py video_data.json --platform youtube
Tools Overview
| Tool |
Purpose |
Input |
Output |
video_content_planner.py |
Content calendar generation |
JSON with topics/audience |
Weekly calendar + production schedule |
thumbnail_analyzer.py |
Thumbnail pattern analysis |
CSV with thumbnail data |
Optimization recommendations |
video_seo_optimizer.py |
Video metadata SEO |
JSON with video details |
Optimized titles, descriptions, tags |
Workflows
Workflow 1: Monthly Video Strategy
- Define audience personas and content pillars in topics JSON
- Run
video_content_planner.py to generate 4-week calendar
- For each planned video, run
video_seo_optimizer.py for metadata
- After publishing, collect thumbnail data and run
thumbnail_analyzer.py
- Feed learnings back into next month's planning cycle
Workflow 2: YouTube Channel Optimization
- Export existing video data (titles, descriptions, tags, performance)
- Run
video_seo_optimizer.py on underperforming videos to identify metadata gaps
- Run
thumbnail_analyzer.py on top vs bottom performers
- Apply optimizations to existing videos and use patterns for new content
Workflow 3: Multi-Platform Video Strategy
- Create topics JSON with platform-specific audience data
- Run
video_content_planner.py with --platforms youtube,tiktok,linkedin
- Get platform-adapted content recommendations
- Optimize each platform's metadata with
video_seo_optimizer.py
Reference Documentation
See references/video-strategy-guide.md for comprehensive frameworks covering:
- Content pillar strategy
- Platform-specific best practices
- Thumbnail design principles
- Video SEO fundamentals
- Production workflow optimization
Common Patterns
Pattern: Topics JSON Format
{
"channel": "TechStartupTV",
"audience": {
"primary": "SaaS founders, 25-45",
"interests": ["startup growth", "fundraising", "product development"],
"pain_points": ["scaling teams", "finding product-market fit", "managing burn rate"]
},
"content_pillars": [
{"name": "Founder Stories", "ratio": 0.3, "format": "interview", "avg_length_min": 25},
{"name": "Tactical Guides", "ratio": 0.4, "format": "tutorial", "avg_length_min": 12},
{"name": "Industry Analysis", "ratio": 0.2, "format": "commentary", "avg_length_min": 8},
{"name": "Behind the Scenes", "ratio": 0.1, "format": "vlog", "avg_length_min": 5}
],
"topics": [
{"title": "How We Hit $1M ARR", "pillar": "Founder Stories", "priority": "high"},
{"title": "5 Pricing Strategies That Work", "pillar": "Tactical Guides", "priority": "high"},
{"title": "AI in SaaS: 2026 Trends", "pillar": "Industry Analysis", "priority": "medium"}
]
}
Pattern: Thumbnail CSV Format
video_id,title,views,ctr_pct,has_face,has_text,text_words,colors_dominant,emotion
V001,How to Scale,15000,8.2,yes,yes,3,red-yellow,surprise
V002,Tech Review,8500,4.1,no,yes,5,blue-white,neutral
Platform Video Length Guidelines
| Platform |
Optimal Length |
Max Recommended |
| YouTube (standard) |
8-15 min |
25 min |
| YouTube Shorts |
30-60 sec |
60 sec |
| TikTok |
30-90 sec |
3 min |
| LinkedIn |
1-3 min |
10 min |
| Instagram Reels |
15-60 sec |
90 sec |
1---
2name: video-content-strategist
3description: >
4 This skill should be used when the user asks to "plan video content", "create a video
5 calendar", "optimize video SEO", "analyze thumbnail performance", "improve video titles",
6 "schedule video production", or "build a YouTube strategy".
7license: MIT + Commons Clause
8metadata:
9 version: 1.0.0
10 author: borghei
11 category: marketing
12 domain: video
13 updated: 2026-04-02
14 tags: [video, youtube, content-calendar, thumbnail, seo, video-strategy]
15---
16
17# Video Content Strategist Skill
18
19## Overview
20
21Production-ready video content strategy toolkit for planning content calendars, analyzing thumbnail effectiveness, and optimizing video metadata for platform SEO. Designed for content creators, marketing teams, and video producers managing consistent video output across YouTube, TikTok, LinkedIn, and other platforms.
22
23## Clarify First
24
25Before planning, confirm these inputs. If any is unknown or vague, ASK — do not assume:
26
27- [ ] **Platform(s)** — YouTube, TikTok, LinkedIn, or Instagram — sets optimal video length and SEO approach
28- [ ] **Deliverable** — content calendar, thumbnail analysis, or SEO metadata optimization — selects the tool and workflow
29- [ ] **Audience & content pillars** — who it's for and the pillar mix/ratios — drives calendar topics and formats
30- [ ] **Posting frequency** — videos per week and planning horizon — sets the production schedule
31
32Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
33
34## Quick Start
35
36```bash
37# Plan a video content calendar from topics and audience data
38python scripts/video_content_planner.py topics.json --weeks 8 --frequency 3
39
40# Analyze thumbnail text and composition patterns
41python scripts/thumbnail_analyzer.py thumbnails.csv
42
43# Optimize video titles, descriptions, and tags for SEO
44python scripts/video_seo_optimizer.py video_data.json --platform youtube
45```
46
47## Tools Overview
48
49| Tool | Purpose | Input | Output |
50|------|---------|-------|--------|
51| `video_content_planner.py` | Content calendar generation | JSON with topics/audience | Weekly calendar + production schedule |
52| `thumbnail_analyzer.py` | Thumbnail pattern analysis | CSV with thumbnail data | Optimization recommendations |
53| `video_seo_optimizer.py` | Video metadata SEO | JSON with video details | Optimized titles, descriptions, tags |
54
55## Workflows
56
57### Workflow 1: Monthly Video Strategy
58
591. Define audience personas and content pillars in topics JSON
602. Run `video_content_planner.py` to generate 4-week calendar
613. For each planned video, run `video_seo_optimizer.py` for metadata
624. After publishing, collect thumbnail data and run `thumbnail_analyzer.py`
635. Feed learnings back into next month's planning cycle
64
65### Workflow 2: YouTube Channel Optimization
66
671. Export existing video data (titles, descriptions, tags, performance)
682. Run `video_seo_optimizer.py` on underperforming videos to identify metadata gaps
693. Run `thumbnail_analyzer.py` on top vs bottom performers
704. Apply optimizations to existing videos and use patterns for new content
71
72### Workflow 3: Multi-Platform Video Strategy
73
741. Create topics JSON with platform-specific audience data
752. Run `video_content_planner.py` with `--platforms youtube,tiktok,linkedin`
763. Get platform-adapted content recommendations
774. Optimize each platform's metadata with `video_seo_optimizer.py`
78
79## Reference Documentation
80
81See `references/video-strategy-guide.md` for comprehensive frameworks covering:
82- Content pillar strategy
83- Platform-specific best practices
84- Thumbnail design principles
85- Video SEO fundamentals
86- Production workflow optimization
87
88## Common Patterns
89
90### Pattern: Topics JSON Format
91```json
92{
93 "channel": "TechStartupTV",
94 "audience": {
95 "primary": "SaaS founders, 25-45",
96 "interests": ["startup growth", "fundraising", "product development"],
97 "pain_points": ["scaling teams", "finding product-market fit", "managing burn rate"]
98 },
99 "content_pillars": [
100 {"name": "Founder Stories", "ratio": 0.3, "format": "interview", "avg_length_min": 25},
101 {"name": "Tactical Guides", "ratio": 0.4, "format": "tutorial", "avg_length_min": 12},
102 {"name": "Industry Analysis", "ratio": 0.2, "format": "commentary", "avg_length_min": 8},
103 {"name": "Behind the Scenes", "ratio": 0.1, "format": "vlog", "avg_length_min": 5}
104 ],
105 "topics": [
106 {"title": "How We Hit $1M ARR", "pillar": "Founder Stories", "priority": "high"},
107 {"title": "5 Pricing Strategies That Work", "pillar": "Tactical Guides", "priority": "high"},
108 {"title": "AI in SaaS: 2026 Trends", "pillar": "Industry Analysis", "priority": "medium"}
109 ]
110}
111```
112
113### Pattern: Thumbnail CSV Format
114```csv
115video_id,title,views,ctr_pct,has_face,has_text,text_words,colors_dominant,emotion
116V001,How to Scale,15000,8.2,yes,yes,3,red-yellow,surprise
117V002,Tech Review,8500,4.1,no,yes,5,blue-white,neutral
118```
119
120### Platform Video Length Guidelines
121
122| Platform | Optimal Length | Max Recommended |
123|----------|---------------|-----------------|
124| YouTube (standard) | 8-15 min | 25 min |
125| YouTube Shorts | 30-60 sec | 60 sec |
126| TikTok | 30-90 sec | 3 min |
127| LinkedIn | 1-3 min | 10 min |
128| Instagram Reels | 15-60 sec | 90 sec |