The Pepperly agent skill

Give your AI agent a video crew. The skill teaches Claude Code (and compatible agents) to create walkthrough videos and publish them to your Pepperly workspace — from a prompt like “make a demo video of my app”.

The skill covers three ways to get a video into Pepperly:

Generate with AI — the agent sends a URL plus a description of the flow; Pepperly’s engine plans, films, captions, and edits the video server-side.
Record locally — a scripted Playwright session with a humanized visible cursor, for flows on localhost, behind a VPN, or needing your own credentials. The footage is then uploaded to your workspace.
Upload an existing recording — any mp4 / mov / webm up to 600 MB becomes an editable Pepperly video with AI captions.

Install

Clone the skill into your agent’s skills directory:

git clone https://github.com/yapepperly/pepperly-skill ~/.claude/skills/pepperly

Create an API token in the studio: Settings → API tokens → Create token. The token starts with pk_ and is shown once — treat it like a password.
Make it available to the agent:
```
export PEPPERLY_API_TOKEN=pk_...
```

Requirements: Node 20+. Local recording additionally needs npm i playwright in the working directory.

Then just ask

“Make a demo video of https://myapp.com — sign up, create a project, invite a teammate.”
“Record a walkthrough of my local dev server and upload it to Pepperly.”
“Upload demo.mp4 to Pepperly and call it Q3 release demo.”

The agent polls until the video is ready and hands you the studio link, where you trim, caption, and create the share link.

Source, docs, self-hosting

The skill is open source (MIT) at github.com/yapepperly/pepperly-skill. It talks to the same public API documented in the developer docs — anything the skill does, your own code can do too. Self-hosting Pepperly? Point the skill at your stack with PEPPERLY_API_BASE and PEPPERLY_APP_BASE.