sergebulaev/youtube-skills / .codex-marketplace/youtube-skills/skills/yt-description-writer
yt-description-writer
VerifiedWrite a full YouTube video description under 5,000 characters with a first-150-character hook (the only part visible before Show more, and what shows in search and suggested), timestamped chapters, naturally placed keywords, links, and a clear call to action. Covers long-form and YouTube Shorts. Becomes the create-post content that publishes with the video. Use to write or rework a description. Not for the title (use yt-title-optimizer) or the spoken opening (use yt-hook-scripter).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.8 KB |
| references/description-template.md | markdown | 2.6 KB |
references/description-template.md
View on GitHub# Description Template
A reusable skeleton. Fill the brackets, keep the first 150 chars doing real work,
and stay under 5,000 characters total.
## Long-form skeleton
```
{Payoff or question in plain language, with the primary keyword, that reads well
as a standalone snippet.} <-- the first ~150 chars, visible before "Show more"
{2 to 4 short paragraphs. Restate what the viewer gets. Place the main keyword
and 2 to 3 secondary keywords in natural sentences. Put the single most
important link right here, labeled.}
Main resource: {label} -> {url}
CHAPTERS
0:00 {hook / intro}
0:45 {first section}
3:10 {second section}
7:20 {third section}
11:05 {payoff / recap}
LINKS
{label} -> {url}
{label} -> {url}
CONNECT
{platform} -> {url}
{platform} -> {url}
{One-line CTA: subscribe for the specific reason, e.g. "New build-in-public video
every Tuesday."}
#{primaryHashtag} #{secondaryHashtag} #{thirdHashtag}
```
## Shorts skeleton (no chapters)
```
{One-line hook with the keyword, that reads well truncated.} <-- first ~150 chars
{One or two sentences of context.}
{One link if relevant, labeled.}
#Shorts #{topicHashtag} #{secondaryHashtag}
```
## Rules baked into the template
- **First 150 chars:** the only text shown before "Show more", and the snippet in
search and suggested. Lead with payoff or question plus the primary keyword.
Never a greeting.
- **Chapters:** at least 3, the first at `0:00`, or YouTube will not render the
chapter UI. Short, descriptive labels. Long-form only; skip for Shorts.
- **Keywords:** in natural sentences. The primary phrase once in the first 150
chars and once in the body. Secondary keywords sprinkled, never dumped.
- **Links:** always labeled. The most important one goes in the body, not buried
in the furniture.
- **Hashtags:** 3 to 5, at the very end. The first 3 surface above the title.
More than 15 makes YouTube ignore all of them.
- **CTA:** one line, specific ("new editing breakdown every Thursday"), not
"smash like and subscribe".
## Keyword placement map
| Position | What goes there |
|---|---|
| First 150 chars | primary keyword, once, inside the hook sentence |
| Body paragraph 1 | primary keyword again + 1 secondary |
| Body paragraph 2 | 1 to 2 more secondary keywords, naturally |
| Chapters | descriptive labels that happen to contain query terms |
| Hashtags | 3 to 5 topic tags, the broadest first |
## Length budget
- Hard cap: 5,000 characters.
- Realistic target: 600 to 1,500 chars for most videos. Longer only if the links
and chapters genuinely need it.
- Always verify the first 150 chars read well when cut off mid-thought.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |