sergebulaev/youtube-skills / .codex-marketplace/youtube-skills
youtube-marketing
VerifiedPlan, write, and publish for YouTube and YouTube Shorts. Use when the user wants high-CTR video titles, an SEO description with chapters and links, a first-30-seconds retention script (or a 3-second Shorts hook), a designer-ready thumbnail brief, a community-tab post or poll, or a weekly upload plan. The user supplies the video; the skills produce the title, description, hook, and thumbnail brief, then on approval upload and schedule via the Publora API.
references/voice-rules.md
View on GitHub# Voice Rules for YouTube
These are the canonical voice rules for the whole bundle. Every skill inherits
them. Skill-local "Hard rules" sections only add format-specific overrides (title
char caps, description structure, script pacing) and point back here.
## Hard rules
1. **Em dashes (`—`) capped at about 1 per 100 words** (so at most one in a
title or community post, 1-2 in a description). The character is no longer
a tell (2026 models use fewer than humans); the density is. In a title, a
colon or a clean break reads cleaner anyway. Replace the excess with a
comma, colon or line break, never a period. No en dashes (`–`) between
clauses, no double dashes (`--`).
2. **Use `..` as a soft pause** in a script line where you would reach for an em
dash. A dash in a script is only a breath mark the reader sees, and `..`
reads the way a person actually talks on camera.
3. **Capitalize personal, company, and product names** (Notion, Claude, Sony,
DaVinci Resolve). A lowercased brand reads as careless.
4. **Specific numbers beat adjectives.** "in 3 days" beats "fast". "cut render
time 40%" beats "way faster". One real number in the title or the first line
of the description wherever the claim allows it.
5. **Say the payoff out loud, do not bury it.** A title or a hook that hides what
the viewer gets loses the click and the first 30 seconds.
6. **Write the title and thumbnail as a pair, never in isolation.** They are read
together in under a second on the home feed. The title says what the thumbnail
does not, and the reverse. Do not repeat the same words in both.
7. **Do not keyword-stuff.** YouTube ranks on watch-time and satisfaction, not
tag density. Natural language with the real search phrase once beats a wall of
keywords.
## Vocabulary markers (density-scored)
Count these per description paragraph or script beat. One is English; two is borderline (flag it in the report, leave the words);
three in one description paragraph reads as AI and the whole description paragraph gets rewritten. A title is one line, so there any marker is already a cluster.
The durable 2026 set (significant, crucial, notably, particularly,
comprehensive, insights, robust, leverage, foster, landscape, nuanced,
streamline, elevate, empower) counts alongside the older corporate words:
- leverage, utilize, facilitate, streamline, robust, seamless, delve, navigate,
unlock, harness, foster, cultivate
- fundamentally, essentially, ultimately, crucially, notably
- landscape, ecosystem, paradigm, realm, tapestry, journey
## Always forbidden (single hit, regardless of density)
These are scrubbed on sight. They are reveal bridges, negative parallelism,
dead phrases or performed sincerity, not vocabulary:
- "It's not just X, it's Y"
- "In today's fast-paced world"
- "game-changer", "deep dive", "at the end of the day", "needle-mover"
- "without further ado", "in this video we will", "smash that like button"
(dead 2014 phrasing)
- Sincerity announcements as an opener or pivot: "let me be honest", "I'll be
real", "honestly?", "real talk", "not gonna lie", "unpopular opinion:" on a
take that is actually popular. State the fact flat instead.
## YouTube-native style
- **The title is a promise, not a summary.** It tells the viewer what they walk
away with or what tension gets resolved. Curiosity plus a concrete payoff beats
vagueness ("You won't believe..") and beats a dry topic label.
- **The first line of the description is a second hook**, not boilerplate. Only
the first ~150 chars show before "Show more", and they appear in search and
suggested. Lead with the payoff or the question, not "Hi everyone, welcome
back to the channel".
- **The spoken hook is the real algorithm.** No copy survives a weak first 30
seconds (or first 3 seconds on a Short). Open mid-action, restate the title's
promise in your own voice, and tell them why to stay.
- **Talk like one person to one person.** "you" not "you guys", "I" not "we",
unless it is genuinely a team channel.
## Length
- **Title: up to 100 characters, but the sweet spot is 40 to 60.** Mobile and the
sidebar truncate around 60 chars. Front-load the words that earn the click.
- **Description: up to 5,000 characters.** The first 150 are visible before "Show
more" and carry the SEO and the hook. Chapters, links, and keywords fill the
rest.
- **Shorts hook: the first 3 seconds.** No intro, no logo sting, no "what's up
guys". The payoff or the loop opens on frame one.
- **Long-form hook: the first 30 seconds.** This is where the retention graph
lives or dies. Earn the next 30 by the end of it.
## Structure
- **Title carries the click. Thumbnail carries the emotion. First 30 seconds
carry the retention.** Each does a different job. Build all three to point at
the same promise.
- **End the video on a reason to do the next thing**: watch the next video,
subscribe because more like this is coming, or comment a specific answer. A
flat "thanks for watching" wastes the highest-intent moment you get.
## Anti-patterns
- Clickbait the payoff does not honor. A title that overpromises spikes the click
and craters retention, which YouTube punishes harder than a soft title.
- Generic openers: "Hey guys, welcome back", "before we get started", "make sure
to like and subscribe" in the first 10 seconds.
- ALL CAPS TITLES for intensity. One emphasized word is fine; a full caps title
reads as spam.
- Stacked or hollow rule of three ("faster, cheaper, easier"); one natural
triple with concrete items is fine.
- Keyword-stuffed titles and tag dumps in the description.
- Emoji pile-ups in the title. Zero or one, and only if it adds meaning.
## Algorithmic note (what the ranker actually reads)
YouTube's 2026 system optimizes for **satisfied watch-time**, predicted from two
multiplied signals: will this person click (CTR), and once they do, will they
keep watching and come back (retention plus session time). A high-CTR title with
weak retention loses. A great video with a flat thumbnail never gets the
impression. Before you publish, check: does the title earn the click honestly,
and does the first 30 seconds (or 3 on a Short) pay it off? If either link is
weak, fix it before anything else.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |