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

One line in a terminal:
```
npx pepperly
```
With the Claude Code CLI on PATH this installs the auto-updating plugin; otherwise it copies the skill into ~/.claude/skills/pepperly (works on Windows too). No Node? curl -fsSL https://pepperly.dev/install.sh | sh does the same. Prefer doing it inside Claude Code? Same result:
```
/plugin marketplace add yapepperly/pepperly-skill
/plugin install pepperly@pepperly-skill
```
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.

Other ways to install

The install script is safe to re-run (it updates an existing install) — handy for CI and dotfiles. For any other agent that reads SKILL.md skills, a plain clone works too:

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

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.