Install
$ agentstack add skill-yaxeen-storytelling-skills-titles-and-thumbnails ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
Titles & Thumbnails
- The click is one decision made in under a second — title and thumbnail are designed together as a pair, never in isolation.
- They must complement, not repeat: the thumbnail shows the emotion/stakes, the title names the gap (or vice versa). If both say the same thing, you waste half the real estate.
- The pack's job is the right click, not the most clicks. A title that pulls the wrong viewers spikes CTR and kills retention — which suppresses the video. Keep a qualifying signal (audience, situation, stakes) in the pair.
- Built on the six levers — see storytelling-hooks. Recap: 1. Curiosity gap · 2. Emotional mirror · 3. Conflict engine · 4. Relatability · 5. Pattern + surprise · 6. Three-act.
When to Use
- Writing a video title or a batch of title variations.
- Designing or briefing a thumbnail concept.
- Diagnosing low click-through rate (CTR) on existing uploads.
- Any niche: tutorials, vlogs, business, finance, faith, entertainment.
The Pairing Principle (Quick Reference)
| Thumbnail does | Title does | |----------------|------------| | Emotion + stakes (visual) | The curiosity gap (words) | | One focal subject | The specific promise/number | | Shows the "what" | Asks/implies the "why/how" |
- Test: cover the title — does the thumbnail still raise a question? Cover the thumbnail — does the title still pull? Both should pass.
Title Formulas
- Curiosity gap: "The one [thing] nobody tells you about [topic]."
- Stakes/loss: "This [mistake] is costing you [outcome]."
- Result-first: "How I [result] in [timeframe] (without [expected cost])."
- Pattern break: "Everyone does [common thing]. Here's why it's wrong."
- Specific number: "[N] [things] that [outcome]." Concrete numbers beat vague ("7 settings" > "some settings").
- Question gap: "Why does [surprising thing] happen?"
- Rules:
- Front-load the hook word — mobile shows roughly the first 40 characters; keep the full title ≤ ~60.
- One idea per title; don't stack two gaps.
- Promise something the video actually delivers (broken promises tank retention and the algorithm).
- Write 5–10 variants — cover at least 4 different formulas above, don't write 8 versions of one.
- Pick by sharpest gap + best fit for the target viewer — not raw breadth. Relatability serves the audience you want, not everyone.
Thumbnail Concept Patterns
- Single focal point: one subject, instantly readable at small size. Clutter loses.
- Emotion on a face: genuine expression (shock, joy, worry) triggers the emotional mirror.
- Contrast / before-after: two states side by side create instant conflict.
- The object of curiosity: show the unnamed "thing" partially or circled.
- Scale/number callout: a big bold number or stakes figure.
- Directional cues: eyes, arrows, or gaze pointing at the focal element.
- Craft rules:
- High contrast, few colors, large readable text (≤4 words).
- Readable as a thumbnail-sized image AND on desktop — check both.
- Faces large; expressions exaggerated but believable.
- Text on thumbnail must NOT duplicate the title — add the missing half.
Generation Workflow
- Intake. Confirm: topic and what the video actually delivers (real numbers, real outcome), target viewer in one sentence, and channel tone. Ask if missing when the user can respond; otherwise state assumptions up front — never invent "concrete" numbers silently.
- Variants. Write 5–10 titles across ≥4 formulas; note which formula each uses. Read patterns.md (same folder) for fill-in structures per formula plus thumbnail concepts and overlay pairings — adapt, don't copy.
- Select. Show all variants, then recommend 1–2, saying which gap each opens and who it qualifies.
- Pair. For each recommended title, deliver a thumbnail brief: focal point, expression/emotion, overlay text (≤4 words, the other half of the story), contrast element, color/craft notes.
- Test. Run the cover-one-half pairing test and the honesty check on every recommended pair; state the results.
Bad → Good Rewrite
- ❌ "Meal Prep Tips for Students" — a topic label: no gap, no stakes, no number, qualifies no one strongly.
- ✅ "How I Eat All Week on $25 as a College Student (No Ramen)" — result-first + concrete number + qualifier ("college student") + a pattern break ("no ramen") that kills the expected objection. (The $25 here is illustrative — in real work the number comes from intake, never invented.)
Curiosity Without Clickbait
- Clickbait = a gap the video never closes → high CTR, dead retention, suppressed reach.
- Honest hook = a real gap the video genuinely pays off.
- If the most dramatic frame isn't in the video, don't put it on the thumbnail.
Common Mistakes
| Mistake | Fix | |---------|-----| | Thumbnail text repeats the title | Overlay carries the other half (reframe the number, show the stakes) | | Optimizing for the most clicks | Optimize for the right viewer — qualify in the title or thumbnail | | Vague words where numbers exist | Ask for the real figure; never fabricate one | | 8 variants of one formula | Spread variants across ≥4 formulas | | Hook word buried at the end | Front-load — assume only ~40 characters show | | Promise the video can't keep | Honesty check before delivery; adjust the claim, not the video |
Click-Through Checklist
- [ ] Do title and thumbnail say different halves of the same story?
- [ ] Does the pair qualify the target viewer, not just maximize clicks?
- [ ] Does the thumbnail read clearly at small/mobile size?
- [ ] One focal subject, genuine emotion or clear contrast?
- [ ] Title front-loads the hook word and fits mobile truncation?
- [ ] At least one concrete number or specific where facts allow?
- [ ] Is the promise something the video actually delivers?
- [ ] Did you write 5+ title variants before choosing?
Related
- storytelling-hooks — the six levers behind the gap.
- long-form-youtube — the video the click must deliver on.
Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: yaxeen
- Source: yaxeen/storytelling-skills
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.