๐ฌ youtube-script-writer
High-retention YouTube and Shorts scripts with hooks, open loops and B-roll cues. A free, open-source Agent Skill for Claude Code, Cline, Cursor, Codex and 75+ AI agents.
Install youtube-script-writer
# Claude Code (all 51 skills)
/plugin install all-skills --marketplace milad-ahmd/agent-skills
# Cursor, Codex, Cline, Windsurf, Copilot + 75 more agents
npx skills add milad-ahmd/agent-skills --skill youtube-script-writer
# Shell installer
curl -fsSL https://raw.githubusercontent.com/milad-ahmd/agent-skills/main/install.sh | bash -s -- youtube-script-writerIncluded in packs: creator-pack
What to say to your agent
Write a 10-minute YouTube script about XTurn this blog post into a YouTube Short
When it triggers
Writes high-retention YouTube scripts for long-form videos and Shorts, with a 30-second hook, structured outline, open loops, pattern interrupts, B-roll and graphics cues, sponsor segments, and CTAs, from a topic, notes, article, or research. Use when the user asks to write or improve a YouTube script, video outline, intro, or Shorts script.
Full skill instructions (SKILL.md)
YouTube Script Writer
Hold attention from second 0 to the end screen.
1. Brief
Topic, target viewer, the one promise of the video (what they'll get by the end), length (Short of 60 seconds or less, or long-form 8โ15 minutes), style (talking head, faceless voiceover, tutorial, documentary), the creator's voice and any sources or facts to use. If the user provides research, use only facts from it or well-established knowledge, and mark claims that need verifying with [VERIFY].
2. Structure (long-form)
[0:00โ0:30] HOOK
- Visual/claim that matches the title & thumbnail promise immediately
- Stakes: why this matters to the viewer
- Open loop: "and the 3rd one surprised me the most"
- No "Hey guys, welcome back" before value
[0:30โ1:00] SETUP โ credibility in one line, roadmap of the video
[BODY] 3โ7 segments, each:
- mini-hook โ point โ example/story/demo โ payoff โ transition that opens next loop
- pattern interrupt every 60โ90s (B-roll, graphic, zoom, joke, question)
[Mid-roll] sponsor or CTA bridged naturally from content
[CLIMAX] best point saved for late (pays off the open loop)
[END] quick recap โ next-video CTA (point to specific video) โ no long outro
3. Output format (a two-column script)
| Spoken (A-roll) | Visual / B-roll / on-screen text / SFX |
|---|---|
| "Most people get this wrong..." | [Zoom-in] Text: "โ Common mistake" |
Then add: the estimated runtime (about 150 words per minute), a list of the B-roll shots to film or source, and 3 title and thumbnail pairings that match the hook (for youtube-seo-optimizer).
4. Shorts version
45 seconds or less, the hook in the first second, one idea only, a fast payoff, and a loop ending. Write it as a separate script.
Style rules
- Write for the ear: short sentences, contractions, "you" language, one idea per sentence.
- Use specific examples and numbers instead of generic advice.
- Remove filler, and cut any sentence that doesn't move the story forward.
- Read it in the creator's voice. Ask for an earlier script or transcript to match their style.
- Sponsored segments must be clearly disclosed.
View source on GitHub โญ Star the collection
Related skills
๐ฃ ad-copy-generator
Ad copy for Meta, TikTok, Google and YouTube within each platform's limits, plus an A/B test matrix
๐จ brand-voice-guide
A brand voice, positioning and personas guide, then rewrites copy on-brand
๐ต๏ธ competitor-spy
Competitor analysis of pricing, messaging, socials, ads and reviews, with a SWOT and opportunities
โป๏ธ content-repurposer
One video or podcast into 15+ posts: Shorts, Reels, threads, LinkedIn, carousel, newsletter
๐ง email-campaign-writer
Welcome, launch, cart and newsletter email sequences with subject-line tests
๐ช hook-generator
Scroll-stopping hooks for videos, posts, emails and ads, scored and ranked