Agent skill

Youtube Script Writer

by raroque in raroque/boop-agent

Write a tight, retention-focused YouTube script from a topic, outline, or research brief.

MITAuto-check passedMedia & Creative

Install Youtube Script Writer

skills CLI
$ npx skills add raroque/boop-agent --skill youtube-script-writer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install raroque/boop-agent youtube-script-writer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/raroque/boop-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/youtube-script-writer .claude/skills/youtube-script-writer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
youtube-script-writer
GitHub stars
1.4k
Token cost
~1.1k tokens
SKILL.md length
594 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Write a tight, retention-focused YouTube script from a topic, outline, or research brief.

  • Works in 5 steps: Hook — first 5 seconds → Setup — seconds 5–20 → Body — main content → …
  • The user asks for a video script
  • SKILL.md covers When to use, When NOT to use, Inputs to gather first and Script structure (standard 5–8…, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Youtube Script Writer is an agent skill from raroque/boop-agent. Write a tight, retention-focused YouTube script from a topic, outline, or research brief. Use when the user asks for a video script, wants to turn notes or research into a YouTube video, needs a hook/intro rewritten, or wants to plan a video end-to-end with pacing, visual beats, and CTAs.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering Video scripts and shorts. It works with YouTube. The repository describes itself as: iMessage personal agent: choose Claude Agent SDK (Claude Code) or Codex app-server runtime (Codex/ChatGPT), with memory, sub-agents, automations, integrations. The licence is MIT.

When your agent uses it

  • The user asks for a video script
  • Wants to turn notes
  • Research into a YouTube video
  • Needs a hook/intro rewritten

Example prompts

  • “/youtube-script-writer”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Hook — first 5 seconds
  2. Setup — seconds 5–20
  3. Body — main content
  4. Payoff — deliver on the hook
  5. CTA — final 15 seconds

What it can do on your machine

Read from SKILL.md and the folder at commit 3197913. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Youtube Script Writer loads about 1.1k tokens when it runs. Until then it costs about 78 tokens; SKILL.md has 594 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~78
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from raroque/boop-agent at commit 3197913, republished under its MIT licence (© raroque). 594 words, ~1,136 tokens.

Download SKILL.mdSave it as .claude/skills/youtube-script-writer/SKILL.md (or your agent's skills folder).
name
youtube-script-writer
description
Write a tight, retention-focused YouTube script from a topic, outline, or research brief. Use when the user asks for a video script, wants to turn notes or research into a YouTube video, needs a hook/intro rewritten, or wants to plan a video end-to-end with pacing, visual beats, and CTAs.

YouTube Script Writer

Turn a topic, outline, or research dump into a YouTube script that holds attention from second 0 through the CTA.

When to use

  • "Write a YouTube script about X"
  • "Turn this research into a video"
  • "Draft an intro / hook for a video on Y"
  • "Plan out a 5-minute video about Z"

When NOT to use

  • Long-form blog posts or articles (different pacing rules — don't force them into this template)
  • Podcast outlines (conversational, not scripted)
  • Shorts under 60s (different structure — lead with the payoff, no setup)

Inputs to gather first

Before writing, confirm (ask if missing):

  1. Topic / angle — what is the one idea the viewer walks away with?
  2. Target length — under 3 min, 3–8 min, or 10+ min? Pacing changes.
  3. Audience — beginners, experts, or mixed? Sets vocabulary floor.
  4. Research or source material — any facts, stats, quotes, URLs to include?
  5. Tone — casual/educational, docu-style, chaotic/entertainment?

If the user didn't supply research and the topic needs facts, use WebSearch / WebFetch BEFORE writing. Never invent stats or quotes.

Script structure (standard 5–8 min video)

Write the script in these labeled sections. Don't skip any.

1. Hook — first 5 seconds
  • One sentence that promises a payoff or opens a loop.
  • No "hey guys welcome back." No throat-clearing.
  • Patterns that work:
    • Curiosity gap — "Everyone gets X wrong. Here's what actually works."
    • Bold claim — "You can do X in 10 minutes. I'll prove it."
    • Pattern interrupt — visual or verbal surprise.
  • End with an implicit "keep watching to find out."
2. Setup — seconds 5–20
  • Context: why does this matter NOW, for THIS viewer?
  • Credibility beat (one sentence max): who you are / why listen.
  • Restate the promise in sharper form. No long preamble.
3. Body — main content
  • Break into 2–4 clearly-labeled sections/chapters.
  • Retention rule: every 30–45 seconds, re-hook. Tease what's coming ("but here's the twist…"), change visual pattern, or drop a memorable line.
  • One idea per section. Don't stack.
  • Concrete > abstract. Examples, numbers, screenshots, demos.
  • If you have research: cite specifically (brand, study, date). No vague "studies show."
4. Payoff — deliver on the hook
  • Close the loop opened in the hook.
  • Summarize the one takeaway in one sentence. Viewer should be able to repeat it.
Show full SKILL.md (231 more words)Show less
5. CTA — final 15 seconds
  • ONE ask. Not three. Pick: subscribe, comment prompt, link in description, or watch-next video.
  • Make it natural, tied to the content. "If this saved you X, subscribe" beats "smash that like button."
  • End on a strong visual beat, not a fade.

Format the output

Deliver the script as:

TITLE: <working title, clickable but honest>

THUMBNAIL IDEA: <1 sentence, what's on screen>

---

[0:00] HOOK
<exact words to say>

[0:05] SETUP
<exact words>

[0:20] SECTION 1 — <name>
<exact words>
[VISUAL: brief note on B-roll / cut / graphic]

[...continue...]

[X:XX] CTA
<exact words>

Rules for the script body:

  • Write the spoken words, not stage directions, as the main text.
  • Put visual/cut notes in [VISUAL: …] tags inline, indented under the spoken line they belong to.
  • Use short sentences. Read it aloud in your head — if a sentence is hard to say, rewrite it.
  • Contractions always (don't → that's how people talk).
  • No jargon without a one-line definition.

After the script

Close with:

  • Estimated runtime — rough estimate based on ~150 wpm spoken pace.
  • Open questions — anything you had to guess at (e.g. target audience assumed to be X; pick a different tone if wrong).
  • Variants to consider — one alt hook and one alt CTA, one line each. Gives the user pivot options.

Retention checklist (self-review before delivering)

  • Hook is under 10 seconds and makes a clear promise
  • Setup ends in under 30 seconds total
  • A re-hook or pattern break every 30–45 seconds of body
  • Every claim has a source or is clearly framed as opinion
  • Exactly one CTA
  • Body reads aloud cleanly — no tongue-twisters, no buried verbs
  • Sources section follows (if WebSearch/WebFetch was used)

© raroque, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/youtube-script-writer of raroque/boop-agent.

Open the folder on GitHubat commit 3197913

Compare with similar skills

Youtube Script Writer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Youtube Script Writer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Youtube Script Writer this skillraroque/boop-agent1.4k—~1.1kAutomated safety check: PassMIT
Youtube Viral Optimizerinfranodus/skills119—~3.6kAutomated safety check: PassNone
Hook Writersocial-media-skills/skills125—~1.7kAutomated safety check: PassMIT
Youtube Scriptmohitagw15856/pm-claude-skills1.4k—~1.4kAutomated safety check: PassMIT
Video Script Writernicepkg/ai-workflow285—~2.2kAutomated safety check: PassMIT
Content Video Script Writerchendongqi/OPB-Skills125—~844Automated safety check: PassNone

Similar skills

  • Youtube Viral Optimizer

    infranodus/skills

    Generate high-CTR YouTube thumbnails, titles, and video scripts optimized for virality.

    119 GitHub stars~3.6k tokensUpdated 17 days ago
    Media & CreativeAuto-check passed
  • Hook Writer

    social-media-skills/skills

    A skill your agent uses to write the hook — the opening that earns attention — for any social content: a caption's first line, a video's first three seconds, a carousel cover slide, a thread opener…

    125 GitHub stars~1.7k tokensUpdated 7 days ago
    Media & CreativeAuto-check passed
  • Youtube Script

    mohitagw15856/pm-claude-skills

    Write a long-form video script for YouTube — an explainer, tutorial, video essay, review, or talking-head — built on the packaging→cold-open→value-stack→retention structure that holds watch-time…

    1.4k GitHub stars~1.4k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Video Script Writer

    nicepkg/ai-workflow

    Write engaging video scripts for YouTube, TikTok, and other platforms.

    285 GitHub stars~2.2k tokensUpdated 8 mo ago
    Media & CreativeAuto-check passed
  • Content Video Script Writer

    chendongqi/OPB-Skills

    视频脚本助手 - 专业的视频内容策划与脚本创作专家。适用场景: (1) 短视频脚本创作(抖音/快手/视频号) (2) 中长视频脚本(B站/YouTube) (3) 分镜头脚本设计 (4) 口播文案撰写 (5) 视频大纲与结构设计 (6) 视频标题与封面文案 (7) 视频SEO优化(标题/描述/标签)…

    125 GitHub stars~844 tokensUpdated 7 mo ago
    Media & CreativeAuto-check passed
  • Yt Script

    Jakeschincariol/youtube-agent-skill

    Write a YouTube video script from a raw idea - hook options off 21 formulas, scored, then the full spoken script with the retention beats marked.

    651 GitHub stars~672 tokensUpdated 22 days ago
    Media & CreativeAuto-check passed

More from raroque/boop-agent

  • Upgrade Boop

    raroque/boop-agent

    Pull upstream Boop changes into a customized fork. An agent skill from raroque/boop-agent.

    1.4k GitHub stars~1.9k tokensUpdated 2 mo ago
    Auto-check: notes

Works with

Questions about Youtube Script Writer

What does Youtube Script Writer do?

Write a tight, retention-focused YouTube script from a topic, outline, or research brief. Youtube Script Writer is an agent skill from raroque/boop-agent. Write a tight, retention-focused YouTube script from a topic, outline, or research brief.

When should I use Youtube Script Writer?

Youtube Script Writer fits situations like: the user asks for a video script; wants to turn notes; research into a YouTube video; needs a hook/intro rewritten.

How do I install Youtube Script Writer in Claude Code?

Run `npx skills add raroque/boop-agent --skill youtube-script-writer -a claude-code`. Or copy the skill folder (.agents/skills/youtube-script-writer in raroque/boop-agent) into .claude/skills/youtube-script-writer in your project. Claude Code loads it when a task matches its description.

How do I install Youtube Script Writer in Codex?

Run `npx skills add raroque/boop-agent --skill youtube-script-writer -a codex`. Or copy the skill folder (.agents/skills/youtube-script-writer in raroque/boop-agent) into .agents/skills/youtube-script-writer in your project. Codex loads it when a task matches its description.

Can I use Youtube Script Writer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add raroque/boop-agent --skill youtube-script-writer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/youtube-script-writer, .gemini/skills/youtube-script-writer, .github/skills/youtube-script-writer and .opencode/skills/youtube-script-writer in your project.

What does Youtube Script Writer need to run?

SKILL.md names no scripts, command-line tools or credentials: Youtube Script Writer is instructions for the agent only.

Does Youtube Script Writer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Youtube Script Writer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Youtube Script Writer use?

Youtube Script Writer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Youtube Script Writer use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Youtube Script Writer?

Skills that share tags, products or a category with Youtube Script Writer: Youtube Viral Optimizer (infranodus/skills, 119 stars), Hook Writer (social-media-skills/skills, 125 stars), Youtube Script (mohitagw15856/pm-claude-skills, 1.4k stars) and Video Script Writer (nicepkg/ai-workflow, 285 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Youtube Script Writer?

raroque (a GitHub user) maintains it in raroque/boop-agent, which has 1,371 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on July 13, 2026.

Source: raroque/boop-agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.