Skip to content

sergebulaev/youtube-skills / .codex-marketplace/youtube-skills/skills/yt-description-writer

yt-description-writer

Verified

Write 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).

FileKindSize
SKILL.mdskill md5.8 KB
references/description-template.mdmarkdown2.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.
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall