New: Earn 20% as an AgentAlley affiliate. Share your link and earn on every sale you refer. Join now New: Earn 20% as an affiliate. Join now

Long-form vs YouTube Shorts mix, posting cadence

YouTube Content Planner

by sergebulaev · MIT license · ★ 36 on GitHub · updated Sep 17

YouTube Content Planner cover

Build a weekly YouTube upload plan: long-form vs YouTube Shorts mix, posting cadence, per-slot title and thumbnail pairing, hook angle, community-tab posts between uploads, and a goal balance across CTR, retention, and subscribes. Maps…

---
name: yt-content-planner
description: "Build a weekly YouTube upload plan: long-form vs YouTube Shorts mix, posting cadence, per-slot title and thumbnail pairing, hook angle, community-tab posts between uploads, and a goal balance across CTR, retention, and subscribes. Maps Shorts as top-of-funnel that points at long-form, and long-form as the loyalty and watch-time engine. Use to plan a week or a content calendar instead of shipping ad hoc. Not for writing a single title, description, or hook (use the dedicated yt skills)."
---

# YouTube Content Planner

Turns a channel theme, an audience, and content pillars into a structured week:
what to upload, when, in which format, and how the title and thumbnail pair on
each slot. It plans; the dedicated skills write each piece.

## When to use

- User says "plan my week of YouTube content" or "build me a content calendar"
- User wants a long-form vs Shorts mix and a cadence they can hold
- User wants each slot pre-paired (format, title angle, thumbnail angle, hook)
- User wants the community-tab posts scheduled between uploads

Overview

Turns a channel theme, an audience, and content pillars into a structured week: what to upload, when, in which format, and how the title and thumbnail pair on each slot. It plans; the dedicated skills write each piece.

Manual install (npx, ZIP)
Claude Codenpx skills add sergebulaev/youtube-skills --skill yt-content-planner -g -a claude-code
Claude Code (manual)mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/sergebulaev/youtube-skills/tar.gz/0e0a8cae2a7c \ | tar -xz -C ~/.claude/skills --strip-components=4 youtube-skills-0e0a8cae2a7c/.codex-marketplace/youtube-skills/skills/yt-content-planner
Windows (PowerShell)New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/939f7d7a6af746e46ea0/yt-content-planner.zip" -OutFile "$env:TEMP\yt-content-planner.zip"; Expand-Archive "$env:TEMP\yt-content-planner.zip" -DestinationPath "$HOME\.claude\skills" -Force
Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md5.0 KB
  • references/2 files · 6.0 KB
Read the files here
sergebulaev/0e0a8ca3 files
Shared references3SKILL.md reads these from elsewhere in the repo. Not in the ZIP.Get them on GitHub ↗
SKILL.md
Show the full text97 lines

YouTube Content Planner

Turns a channel theme, an audience, and content pillars into a structured week: what to upload, when, in which format, and how the title and thumbnail pair on each slot. It plans; the dedicated skills write each piece.

When to use

  • User says "plan my week of YouTube content" or "build me a content calendar"
  • User wants a long-form vs Shorts mix and a cadence they can hold
  • User wants each slot pre-paired (format, title angle, thumbnail angle, hook)
  • User wants the community-tab posts scheduled between uploads

What it produces

  • A weekly grid: each slot has a format (long-form or Short), a working title angle, a thumbnail angle, the hook formula, the pillar, and a posting window.
  • A long-form vs Shorts ratio sized to the channel's stage and capacity.
  • Community posts placed on the non-upload days to keep the channel warm.
  • A goal balance check: across the week, are you spread across CTR-first, retention-first, and subscribe-first pieces, not all one note.

Steps

  1. Gather inputs. The channel theme/niche, the audience, 3 to 5 content pillars, the target audience timezone, how many videos per week the user can realistically make, and the current stage (new channel vs established). If a channel URL is given, parse it with lib/url_parser.py and ask the user to paste their recent titles and rough view counts.
  2. Set the mix. Size the long-form vs Shorts ratio to capacity and stage. A common growing-channel rhythm is 1 long-form per week plus 3 to 5 Shorts, but consistency over 12 weeks beats volume. Confirm a cadence the user can hold.
  3. Assign pillars to slots so the week is varied, not five takes on one topic.
  4. Pair each slot. For every upload, set:
    • format (long-form or Short)
    • working title angle (which Y1-Y6 formula)
    • thumbnail angle (what it carries that the title does not)
    • opening hook formula (Y7-Y10), matched via the pairing table
    • primary goal (CTR / retention / subscribes)
    • posting window in the audience timezone
  5. Place community posts on the non-upload days (a poll, a tease, a question).
  6. Run the goal balance check. If every slot is CTR-bait or every slot is a deep tutorial, rebalance. Shorts skew top-of-funnel reach; long-form skews watch-time and loyalty. Make sure both jobs are covered.
  7. Hand each slot to the right skill. The planner does not write the final title, description, hook, or thumbnail; it routes each slot to yt-title-optimizer, yt-description-writer, yt-hook-scripter, and yt-thumbnail-brief.
  8. Optional approval + schedule. If the user has videos ready, each one publishes through its own skill via lib.publish(...); the planner only sets the calendar.

Hard rules

Global voice rules: see root SKILL.md Voice rules. Additional skill-specific rules:

  • Cadence must be one the user can hold for at least 12 weeks. Sustainable beats ambitious.
  • Every upload slot is pre-paired: format, title angle, thumbnail angle, hook, goal, and time. No naked "post a video" slots.
  • Shorts and long-form must have a through-line (Shorts point at the library), not two disconnected audiences.
  • Spread the week across CTR, retention, and subscribe goals. Not all one note.
  • Measure long-form watch-time and returning viewers separately from Shorts views. Do not let Shorts reach inflate the read on growth.

Anti-patterns (skill will refuse)

  • An over-ambitious cadence the user cannot sustain (daily long-form for a solo creator).
  • Five slots that are all the same pillar and the same goal.
  • Shorts with no connection to the long-form library.
  • "Post more" as a plan, with no per-slot pairing.
  • Em dashes above the cap (about one per 100 words) in any drafted title or hook line.

Resources

  • ../../references/algorithm-heuristics.md - long-form vs Shorts strategy, timing, signals
  • ../../references/hook-formulas.md - title and hook formulas to assign per slot
  • references/pillars-framework.md - turning a niche into pillars and a balanced mix
  • references/example-week.md - a fully worked weekly grid
  • yt-title-optimizer - write the title for each planned slot
  • yt-thumbnail-brief - brief the thumbnail for each planned slot
  • yt-hook-scripter - script the opening for each planned slot
  • yt-description-writer - write the description for each planned slot
  • yt-community-post-writer - the between-uploads community posts
1---
2name: yt-content-planner
3description: "Build a weekly YouTube upload plan: long-form vs YouTube Shorts mix, posting cadence, per-slot title and thumbnail pairing, hook angle, community-tab posts between uploads, and a goal balance across CTR, retention, and subscribes. Maps Shorts as top-of-funnel that points at long-form, and long-form as the loyalty and watch-time engine. Use to plan a week or a content calendar instead of shipping ad hoc. Not for writing a single title, description, or hook (use the dedicated yt skills)."
4---
5 
6# YouTube Content Planner
7 
8Turns a channel theme, an audience, and content pillars into a structured week:
9what to upload, when, in which format, and how the title and thumbnail pair on
10each slot. It plans; the dedicated skills write each piece.
11 
12## When to use
13 
14- User says "plan my week of YouTube content" or "build me a content calendar"
15- User wants a long-form vs Shorts mix and a cadence they can hold
16- User wants each slot pre-paired (format, title angle, thumbnail angle, hook)
17- User wants the community-tab posts scheduled between uploads
18 
19## What it produces
20 
21- A **weekly grid**: each slot has a format (long-form or Short), a working title
22 angle, a thumbnail angle, the hook formula, the pillar, and a posting window.
23- A **long-form vs Shorts ratio** sized to the channel's stage and capacity.
24- **Community posts** placed on the non-upload days to keep the channel warm.
25- A **goal balance check**: across the week, are you spread across CTR-first,
26 retention-first, and subscribe-first pieces, not all one note.
27 
28## Steps
29 
301. **Gather inputs.** The channel theme/niche, the audience, 3 to 5 content
31 pillars, the target audience timezone, how many videos per week the user can
32 realistically make, and the current stage (new channel vs established). If a
33 channel URL is given, parse it with `lib/url_parser.py` and ask the user to
34 paste their recent titles and rough view counts.
352. **Set the mix.** Size the long-form vs Shorts ratio to capacity and stage. A
36 common growing-channel rhythm is 1 long-form per week plus 3 to 5 Shorts, but
37 consistency over 12 weeks beats volume. Confirm a cadence the user can hold.
383. **Assign pillars to slots** so the week is varied, not five takes on one
39 topic.
404. **Pair each slot.** For every upload, set:
41 - format (long-form or Short)
42 - working title angle (which Y1-Y6 formula)
43 - thumbnail angle (what it carries that the title does not)
44 - opening hook formula (Y7-Y10), matched via the pairing table
45 - primary goal (CTR / retention / subscribes)
46 - posting window in the audience timezone
475. **Place community posts** on the non-upload days (a poll, a tease, a question).
486. **Run the goal balance check.** If every slot is CTR-bait or every slot is a
49 deep tutorial, rebalance. Shorts skew top-of-funnel reach; long-form skews
50 watch-time and loyalty. Make sure both jobs are covered.
517. **Hand each slot to the right skill.** The planner does not write the final
52 title, description, hook, or thumbnail; it routes each slot to
53 `yt-title-optimizer`, `yt-description-writer`, `yt-hook-scripter`, and
54 `yt-thumbnail-brief`.
558. **Optional approval + schedule.** If the user has videos ready, each one
56 publishes through its own skill via `lib.publish(...)`; the planner only sets
57 the calendar.
58 
59## Hard rules
60 
61Global voice rules: see root `SKILL.md` Voice rules. Additional skill-specific
62rules:
63 
64- Cadence must be one the user can hold for at least 12 weeks. Sustainable beats
65 ambitious.
66- Every upload slot is pre-paired: format, title angle, thumbnail angle, hook,
67 goal, and time. No naked "post a video" slots.
68- Shorts and long-form must have a through-line (Shorts point at the library),
69 not two disconnected audiences.
70- Spread the week across CTR, retention, and subscribe goals. Not all one note.
71- Measure long-form watch-time and returning viewers separately from Shorts
72 views. Do not let Shorts reach inflate the read on growth.
73 
74## Anti-patterns (skill will refuse)
75 
76- An over-ambitious cadence the user cannot sustain (daily long-form for a solo
77 creator).
78- Five slots that are all the same pillar and the same goal.
79- Shorts with no connection to the long-form library.
80- "Post more" as a plan, with no per-slot pairing.
81- Em dashes above the cap (about one per 100 words) in any drafted title or hook line.
82 
83## Resources
84 
85- `../../references/algorithm-heuristics.md` - long-form vs Shorts strategy, timing, signals
86- `../../references/hook-formulas.md` - title and hook formulas to assign per slot
87- `references/pillars-framework.md` - turning a niche into pillars and a balanced mix
88- `references/example-week.md` - a fully worked weekly grid
89 
90## Related skills
91 
92- `yt-title-optimizer` - write the title for each planned slot
93- `yt-thumbnail-brief` - brief the thumbnail for each planned slot
94- `yt-hook-scripter` - script the opening for each planned slot
95- `yt-description-writer` - write the description for each planned slot
96- `yt-community-post-writer` - the between-uploads community posts
97 
View all files on GitHub →

Details

Updated
Sep 17, 2026
License
MIT
Stars on the repo
★ 36
Checked
Source
sergebulaev/youtube-skills ↗
Creator
sergebulaev · 77 listings
View creator

Similar skills

See all →
SkillA monthly or weekly content calendar01 content calendar globalminhnv0807/ai-business-skills · by minhnv0807Use when the user needs a monthly or weekly content calendar — posting schedule per channel, funnel ratio, content pillars, repurposing matrix, and an owner per slot. Trigger on 'content calendar', 'posting schedule', 'what should we post this month', 'editorial calendar', 'social media plan', 'we post randomly with no plan'. Also use when the user only says the team keeps running out of things to post. Not for — the brief for one specific post, see `36-content-brief-global`; the caption text itself, see `37-social-caption-global`; deciding next period content from last period data, see `40-next-content-plan-global`; a paid campaign timeline, see `02-campaign-brief-global`.★ 599 GitHub starsSkillGenerate a weekly Facebook Page content plan from a themeFacebook Page Content Plannersergebulaev/facebook-skills · by sergebulaevGenerate a weekly Facebook Page content plan from a theme, audience, and content pillars. Produces per-day picks (short post vs story post, hook formula, angle, posting time, primary goal), a short-to-story post mix, a daily comment-reply target, and a share-optimized goal-mix balance check across shares, comments, and reactions. Use when the user wants to plan a week of Page content. Not for drafting one post (use fb-post-writer) or replying to comments (use fb-engagement-drafter).★ 49 GitHub starsPromptCreate a detailed plan to review guides, blog postsComprehensive content review planf/prompts.chat · by Erkam DemirciCreate a detailed plan to review guides, blog posts, and comparison pages for potential issues, verify them, and implement fixes.New listingPromptCreate a detailed studio beauty editorial close-up shotStudio Beauty Editorial (close-up, pro)f/prompts.chat · by DorukCreate a detailed studio beauty editorial close-up shot prompt. The prompt will include specific instructions on subject demographics, pose, setting, camera details, lighting, and mood to achieve a high-end beauty campaign feel. It will also define technical constraints and negative prompts to avoid unwanted elements.New listingMCPCreates comprehensive content outlines and topic clustersSEO content plannerwshobson/agents · by wshobsonCreates comprehensive content outlines and topic clusters for SEO. Plans content calendars and identifies topic gaps. Use PROACTIVELY for content strategy and planning.★ 39.9k GitHub starsMCPBuilds content engines that rank, convert, and compoundContent strategistalirezarezvani/claude-skills · by alirezarezvaniBuilds content engines that rank, convert, and compound. Thinks in systems — topic clusters, not individual posts. Every piece earns its place or gets killed. Use when content needs to behave like a system rather than a stream of posts — e.g., designing a topic-cluster plan to grow organic traffic from zero, or auditing an editorial calendar and killing pieces that don't convert after 90 days. (For single-asset, on-brand copy production, see cs-content-creator.)★ 26.3k GitHub stars

More from sergebulaev

SkillBy density per paragraph, not per wordAI Tells — Complete Blacklist (V3, 2026-09)sergebulaev/linkedin-skills · by sergebulaevScored the way readers read: by density per paragraph, not per word. One marker in a paragraph is English. Three is a signature. The…★ 3.1k GitHub starsSkillFifteen rules from the linkedin-humanizer packageAI-Tell Rules: Tier-Classified Referencesergebulaev/linkedin-skills · by sergebulaevFifteen rules from the linkedin-humanizer package, sorted by what kind of evidence each one actually represents.★ 3.1k GitHub starsSkillPattern data from MagicPost LinkedIn analysisEmoji Patterns — AI vs. Humansergebulaev/linkedin-skills · by sergebulaevPattern data from MagicPost LinkedIn analysis (Feb 2026, viral post with 220 engagement).★ 3.1k GitHub starsSkillRead your Instagram niche and profile from real dataInstagram Audience Insightssergebulaev/instagram-skills · by sergebulaevRead your Instagram niche and profile from real data via Apify, no login. Scan a hashtag for the posts traveling now (likes, comments, owner) to see the format and hook that works. Pull profile stats for any handle, yours or a competitor's: followers, posts, bio, category. Instagram hides who liked or commented on other accounts, so this is discovery plus profiles, not engagers. Triggers on "what works in my niche", "scan the hashtag", "competitor stats". Not for writing captions (use ig-caption-writer).★ 138 GitHub starsSkillDraft an Instagram caption with the hook in the first 125Instagram Caption Writersergebulaev/instagram-skills · by sergebulaevDraft an Instagram caption with the hook in the first 125 characters, a skimmable body, and one clear CTA, using a 2026 hook formula chosen by goal (saves, shares, comments, follows). Runs the humanizer pass and, on approval, publishes with the image or video you supply via the Publora media flow. Use to caption a single image or a Reel. Not for slide-by-slide carousels (use ig-carousel-planner) or auditing a draft (use ig-humanizer --mode audit).★ 138 GitHub starsSkillPlan an Instagram carousel slide by slide, up to 10 slidesInstagram Carousel Plannersergebulaev/instagram-skills · by sergebulaevPlan an Instagram carousel slide by slide, up to 10 slides, with a hook slide that opens a loop, value slides that front-load the payoff, and a payoff slide that earns the save and follow. Picks a 2026 carousel formula (listicle, before/after, myth-buster, framework) by goal (saves, shares, follows), drafts each slide's text plus the caption, then publishes the images you supply via Publora. Use to structure a multi-slide carousel. Not for single-image captions (use ig-caption-writer).★ 138 GitHub stars