Setup
Install the RiffAds plugin in Claude Code and make your first video.
Read as MarkdownThe RiffAds plugin gives Claude Code the RiffAds tools plus seven skills that price a job before they spend. Using another client? Go to MCP setup.
You need Claude Code and a RiffAds workspace on a paid plan or an active trial.
Install
Add the marketplace and install
Type these two lines in Claude Code:
/plugin marketplace add riffads-ai/skills
/plugin install riffads@riffadsriffads@riffads means the plugin riffads from the marketplace riffads. The public repo is its own marketplace:
Sign in
The plugin adds the RiffAds MCP server for you. There is no API key: you sign in with your RiffAds account.
- Not asked to sign in? Run
/mcp, pick the RiffAds server (plugin:riffads:riffads) and sign in when the browser opens. - If a RiffAds approve screen opens, keep Generate and spend credits. Read only can browse and price, but never make anything.
No RiffAds server in /mcp at all? Add it by hand in a terminal:
claude mcp add --transport http riffads https://mcp.riffads.comPick a workspace (only if you have several)
- One workspace: the connection uses it. Nothing to do.
- The approve screen opened: you already picked it under Which workspace pays. Nothing to do.
- Several workspaces and no approve screen: every ask is refused until you pick one. Open your connections page, switch to the workspace that pays, and press Use (workspace name) next to the waiting agent.
Check it
Ask Claude:
Try asking
Claude calls riffads_ping, which is free. The answer names the workspace, its plan, and whether this connection may spend.
First video
There is no command to type. Ask in plain words:
Try asking
The cost-aware-generation skill loads and:
- Checks which workspace pays and how many credits you have.
- Reads what the model accepts, so the job is set up right.
- Prices the exact job for free and tells you the price.
- Waits for your yes, then starts the job.
- Follows the job by itself and hands you the link when it is ready.
The same flow runs on every surface: How it works. Links expire, so say "send it again" for a fresh one (Download links).
More asks to try: Prompting guide. What each skill does: All skills.
Update the plugin
Version 0.2.0 has all seven skills. An early install (0.1.0) has only three. Check yours in a terminal with claude plugin list.
To update, run these in a terminal, then restart Claude Code:
claude plugin marketplace update riffads
claude plugin update riffads@riffadsStill on the old version? Uninstall the plugin and install it again with the two lines in Install.
Troubleshooting
Every refusal code: Errors.