Golpo Skill for Claude Code
Generate AI videos with Golpo directly from any
Claude Code conversation. Give Claude a prompt, a script, an audio file, or
a PDF — Claude submits the job, polls until it's done, downloads the MP4
to your computer, and shows you the file path plus the hosted URL.
You: "Make a 30-second video about why the sky is blue."
Claude: ✓ Submitted (job 1b489b1c…). Polling…
status=generating … status=generating … status=completed
Saved to ~/Golpo/videos/20260429-015856_why-is-the-sky-blue_1b489b1c.mp4
Hosted at https://golpo-podcast-inputs.s3.us-east-2.amazonaws.com/files/894abde8-…mp4
Real transcript from a smoke test. Filename and URLs are unaltered.
Table of contents
What it does
The plugin registers a Claude Code skill named golpo with one helper script
underneath. When you ask Claude to make a video, the skill:
- Verifies your environment (Python,
requests, API key).
- Asks for your Golpo API key on first run, saves it to
~/.golpo/api_key
with 0600 perms.
- Gathers requirements from your message — prompt, script, attachments,
duration, voice, language, style. Defaults are sensible so most asks need
no follow-up.
- Uploads any audio/document files (two-step: API call + S3 PUT).
- Submits the generate job, then polls the status endpoint with exponential
backoff. Resilient to transient 5xx errors.
- Downloads the MP4 to
~/Golpo/videos/ with a readable filename.
- Shows you the local file (clickable) and the hosted URL.
It supports both Golpo engines:
- Golpo Sketch — whiteboard line-art animation (Classic, Improved,
Formal, Dry Erase, Professional Clean, Crayon).
- Golpo Canvas — richer, image-driven look (Chalkboard B/W, Chalkboard
Color, Whiteboard, Modern Minimal, Playful, Technical, Editorial,
Sharpie), with optional drawing-cursor effects.
Install
Recommended — plugin marketplace
In the Claude Code terminal CLI:
/plugin marketplace add Golpo-AI/golpo-claude-skill
/plugin install golpo@GolpoSkill
golpo is the plugin name; GolpoSkill is the marketplace name. Both
are case-sensitive.
/plugin update golpo later when a new version ships.
Manual
git clone https://github.com/Golpo-AI/golpo-claude-skill.git ~/.claude/plugins/golpo
Restart Claude Code.
From a local checkout (for forks / dev)
git clone https://github.com/Golpo-AI/golpo-claude-skill.git
cd golpo-claude-skill
# In Claude Code:
# /plugin marketplace add /absolute/path/to/golpo-claude-skill
# /plugin install golpo@GolpoSkill
Requirements
- Python 3.8+ (preinstalled on macOS and most Linux distros).
requests Python package — install with pip3 install --user requests
if missing. The skill prompts you with the exact command.- A Golpo API key — get one at https://video.golpoai.com (API tier:
$200 minimum entry, $1 = 1 credit, 2 credits per minute of video).
First run
The first time you ask Claude to make a video:
- Claude runs
golpo.py check and notices key_configured=false.
- It explains that the skill needs your API key, then asks you to paste it.
- Behind the scenes it runs
golpo.py auth --key <YOUR_KEY>.
- Subsequent invocations skip auth.
The key lives at ~/.golpo/api_key (mode 0600). To rotate later:
python3 ~/.claude/plugins/golpo/skills/golpo/scripts/golpo.py auth --key NEW_KEY --force
To use an env var instead (overrides the file):
export GOLPO_API_KEY=...
Usage examples
Just talk to Claude in plain English:
JuliusBrussee
anthropics
wshobson
thedotmack
coreyhaines31
Lucklyric