Skip to content

sergebulaev/youtube-skills / .codex-marketplace/youtube-skills

youtube-marketing

Verified

Plan, 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.
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: 323kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall