yt-script
/yt-script
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. Use whenever the user wants a video script, a hook, an opening line, "what should I say", "write my next video", or is about to record and does not have the first fifteen seconds yet.
- Author
- mohammedsadeghi ↗
- Repository
- youtube-agent-skill ↗
- Licence
- MIT
- Last repository change
- 29.10.2026
Assessment and security
- Files in this package
- 3
- Scripts
- 1
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 29.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 1 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: hookscore.py
What it does and when to use it
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. Use whenever the user wants a video script, a hook, an opening line, "what should I say", "write my next video", or is about to record and does not have the first fifteen seconds yet.
Triggers from the description
Original author description
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. Use whenever the user wants a video script, a hook, an opening line, "what should I say", "write my next video", or is about to record and does not have the first fifteen seconds yet.
How it works
- Before you write
- The shape
- What to hand back
- The gate
SKILL.md preview
--- name: yt-script description: >- 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. Use whenever the user wants a video script, a hook, an opening line, "what should I say", "write my next video", or is about to record and does not have the first fifteen seconds yet. --- # yt-script One idea into a script somebody finishes. Two tools live in this folder. Use the scorer as a wording checklist, not a prediction of views or retention. ```bash python3 "$SKILL_DIR/hookscore.py" hooks.txt # rank your hook options python3 "$SKILL_DIR/hookscore.py" --hook "one line" # score a single one ``` Before running the helper, set `SKILL_DIR` to the full path to the directory containing this `SKILL.md`. Claude Code provides that path as `CLAUDE_SKILL_DIR`; other agents should resolve it from the loaded skill file. Do not assume the user's working directory is the skill directory. ## Before you write 1. Look for `youtube-voice.md` in the current project, then `~/.youtube-agent-skill/voice.md`. If neither is readable, ask for a sample or voice preferences. Do not create or update a profile unless the user asks. 2. Never invent a number, a result or a source. If a figure would strengthen it and you do not have one, ask for it or write the line without it. ## The shape **The first 15 seconds is the whole job.** It does three things or the video leaks: confirm the click the title promised, open a question the viewer cannot close, and prove the payoff exists. 1. **Hook.** Write FIVE against [the 21 formulas](hooks.json), run them through `hookscore.py`, keep the top two, and show the user both with their scores. Never hand over one hook. 2. **The turn** (0:15-0:45). Say what the video is going to do, in one sentence, and start doing it. No channel intro, no "before we get started", no subscribe pitch. Those are the single most common cause of the 0:30 cliff. 3. **The body.** One idea per beat. Mark each beat with what is ON SCREEN, not just what is said - a talking head with nothing to look at is a podcast. 4. **The payoff.** Deliver the thing the hook promised, explicitly, and say that you are delivering it: "that is the prompt, it is in the description". 5. **The close.** One ask. Not three. ## What to hand back - the two best hooks with their scored panels - the script, beat by beat, with `[ON SCREEN: ...]` on every beat - the runtime estimate at 150 words per minute - one line naming which formula the winning hook used and why it fits this idea ## The gate Nothing here publishes. This skill writes and you publish. Every output ends in a block the user copies, and the last line of every run is the question: **ship it, or change it?**
Files in this package (3)
- SKILL.md 3 KB
- hooks.json 10 KB
- hookscore.py 5 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · mohammedsadeghi/youtube-agent-skill | 100 | MIT |
| NatikChhabra/claude-arsenal | 100 | MIT |
| gladosAagman/youtube-agent-skill | 100 | MIT |
| tajdijdiji/tatsumi-auto-kit | 100 | MIT |
| jakeschincariol/youtube-agent-skill | 100 | MIT |
| kooshamostofi/youtube-agent-skills | 95 | MIT |
Database snapshot: 13.11.2026 · package version 3fa33c95b134 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100ig-reel
Write an Instagram Reel from a raw idea - hook options off 26 formulas, the spoken script, the on-screen text, and a timed beat sheet - in the user's own voice and scored before they shoot it. Use whenever the user wants a Reel, a short-form video script, a hook, a voiceover,… - 100ig-reel
Write an Instagram Reel from a raw idea - hook options off 26 formulas, the spoken script, the on-screen text, and a timed beat sheet - in the user's own voice and scored before they shoot it. Use whenever the user wants a Reel, a short-form video script, a hook, a voiceover,… - 100ig-reel
Write an Instagram Reel from a raw idea - hook options off 26 formulas, the spoken script, the on-screen text, and a timed beat sheet - in the user's own voice and scored before they shoot it. Use whenever the user wants a Reel, a short-form video script, a hook, a voiceover,… - 100ig-reel
Write an Instagram Reel from a rough idea - hook options from 26 formulas, the spoken script, the on-screen text, and a timed beat sheet - in the user's own voice, scored before they film. Use whenever the user wants a Reel, a short-form video script, a hook, a voiceover, "make… - 100im-reel
Write an Instagram Reel from a raw idea - hook options off 26 formulas, the spoken script, the on-screen text, and a timed beat sheet - in the user's own voice and scored before they shoot it. Use whenever the user wants a Reel, a short-form video script, a hook, a voiceover,… - 100ig-reel
Write an Instagram Reel from a raw idea - hook options off 26 formulas, the spoken script, the on-screen text, and a timed beat sheet - in the user's own voice and scored before they shoot it. Use whenever the user wants a Reel, a short-form video script, a hook, a voiceover,…