Quickstarts
Quickstart: Agent Skills
Install the RiffAds plugin in Claude Code and ask for your first video.
Read as MarkdownAgent Skills: not distributed yet
Everything on this page is built and works against the live API. The package itself is not published yet, so the install command below will not resolve until it is. The REST API and the MCP server are open today.
Install one plugin in Claude Code, then ask for a video in plain words. The skill prices it, asks you, then makes it.
You need: a RiffAds workspace on a paid plan and Claude Code. Other clients get the same tools through MCP, without the skill.
Install
Add the plugin
/plugin marketplace add riffads-ai/skills
/plugin install riffads@riffadsApprove the connection
The plugin brings the MCP server https://mcp.riffads.com. Claude asks to connect. Sign in in the browser and allow spending.
No prompt? Add it by hand:
claude mcp add --transport http riffads https://mcp.riffads.comPick a workspace
Only if you have several. Pick one at app.riffads.com/connections. Until then every call returns connection_not_configured.
Make your first video
Nothing to invoke. Ask:
Make an 8 second RiffAds video of a matte black water bottle on wet slate, morning light.The skill then:
- Checks the connection with
riffads_ping. - Picks a capability (text-to-video, like
veo_31) and reads its schema. - Runs
estimate_generationand quotes it to you. - Waits for your yes, then calls
submit_generationwithmax_creditsset from the quote. - Calls
wait_for_generationuntil it's done and hands you the link.
Links expire in about 10 minutes. Ask again for a fresh one.
Other things it understands:
- "give me four variants of this image" (up to 4)
- "the same script with three different actors"
- "what would this cost in RiffAds"