Viral Shorts & Ad Director
Viral Shorts & Ad Director turns a topic or product into a complete, ready-to-produce video plan — and tells you why your published Shorts aren’t getting views.
What you get
3 creative concepts with a recommendation
A second-by-second script and storyboard (exact frame timing)
Copy-paste prompts for AI image and video tools, written to keep your subject consistent across shots
On-screen text and voiceover, checked to be readable in the time they’re on screen
Sound, music and motion-graphics direction
A quality and compliance check (no invented claims or fake testimonials)
Optional Remotion specs to assemble the final video in code
Built for the feed
Every short-form plan is designed around the two moments that decide distribution: the first second (do people stop scrolling?) and the ending (do they rewatch?). Hook and loop rules come from a real AI-generated science Shorts channel, with each rule labelled by how strong its evidence is.
Diagnose published videos
Share your “stayed to watch” % and average view duration, and it finds whether you’re losing viewers at the opening, the middle or the ending, then redesigns only that part.
Works in 12+ languages. Ask in your language; on-screen text, voiceover and subtitles can each be set to a different one.
This agent plans and writes; it doesn’t generate video files itself. Use the prompts with your own AI image and video tools. No view counts are guaranteed.
Here are the setup commands in order, matching what worked on your Mac. The same guide is now in the repository README on GitHub.
- Check that Node.js is installed
node -v
2. Install Claude Code with the official installer (no admin rights needed)
curl -fsSL https://claude.ai/install.sh | bash
3. Add Claude Code to your PATH (needed on your Mac: claude was “command not found” until this step)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
claude --version
4. Get the skill. Either use GitHub → Code → Download ZIP and unzip it in Downloads, or clone it:
git clone https://github.com/wj08kim-arch/viral-video-director.git
5. Install the skill as a personal skill. This is the ZIP version you used; if you cloned instead, use viral-video-director/viral-video-director-pro as the source.
mkdir -p ~/.claude/skills && cp -r ~/Downloads/viral-video-director-main/viral-video-director-pro ~/.claude/skills/
ls ~/.claude/skills/viral-video-director-pro
You should see SKILL.md examples references scripts templates.
- Start Claude Code in a working folder. The first run asks you to log in.
mkdir -p ~/shorts && cd ~/shorts && claude
7. First request (type it inside Claude Code)
Use the viral-video-director-pro skill to plan a YouTube Short: What if the Earth stopped spinning? 20 seconds, AI video, no voiceover, English on-screen text.
