Skip to content
youbot
Docs menu

AI agents

Coding agents: install the skill

On this page
Let Claude Code, Codex, Cursor or another coding agent make images, videos, music and voice with you.bot. Install the you.bot skill once, put your API key in an environment variable, then ask in plain words.

1. Install the skill

Run this once on each computer. It needs Node.js.

bash
npx skills add https://you.bot

The installer finds the coding agents on your computer and adds the youbot-media skill to the ones you pick. Running the same command again later brings it up to date.

2. Set your API key

Create a key in Dashboard → API Keys, then set it as YOUBOT_API_KEY in the terminal you start your agent from:

bash
export YOUBOT_API_KEY=sk-live-…

On Windows, in PowerShell — the first line covers the window you are in, the second every window you open after it:

powershell
$env:YOUBOT_API_KEY = "sk-live-…"
setx YOUBOT_API_KEY "sk-live-…"
Keep the key in the environment. Do not paste it into the chat or save it in your project files.

3. Ask

Start your agent from that terminal and say what you want. Mention you.bot so the agent reaches for the skill. If you do not name a model, your agent uses GPT Image 2.5 for images and Seedance 2.5 for video. Name any model from the Market to use it instead.

You wantAsk
An imageMake a 1:1 poster of a lighthouse in a storm with you.bot and save it to ./output.
A videoUse you.bot to make a 5-second video of waves at sunrise.
A songCreate a 2-minute lo-fi track with you.bot and save it in ./music.
A voice-overTurn script.txt into a calm male voice-over with you.bot.
A feature in your appAdd an endpoint to my app that turns a prompt into an image with you.bot.

What the agent does

StepWhat happens
PickUses the model you named, or the default for the job. Other models come from the live list at /llms.txt.
ReadOpens that model's reference page for its parameters, allowed values and price.
UploadHosts any local input file through /api/v1/files/upload.
RunCreates the task with POST /api/v1/generate and checks it until it is done.
SaveDownloads the result into your folder and tells you where it is.

Credits

  • Every task is charged from your credit balance at the same price as the Playground and the API. Failed tasks are refunded automatically.
  • The skill uses your API key, so that key's spending limits and IP allowlist apply. Give your agent its own key if you want a separate limit for it.
  • The skill tells your agent to ask you before a costly job, such as a long or high-resolution video.

Update or remove

The skill on your computer does not change by itself when we update it. Once per session your agent compares its copy with the current one on you.bot. If ours is newer, the agent follows the new version for that session and asks you to update:

bash
npx skills update youbot-media

It only downloads when the skill has changed, so it is safe to run anytime. To remove the skill:

bash
npx skills remove youbot-media

Skill or MCP?

SkillMCP connector
Best forCoding agents in a terminal or editor: Claude Code, Codex, Cursor and othersChat apps: claude.ai and Claude Desktop (also Cursor and VS Code)
Sign-inYour API key in YOUBOT_API_KEYClick Allow in your browser — no key to copy
ResultsSaved as files in your projectLinks in the chat
SetupOne command and one environment variableAdd a connector, sign in, click Allow
UpdatesYour agent tells you when a newer skill is out — npx skills update youbot-media installs itAutomatic — nothing to update

Both spend the same credits at the same prices. See AI agents → Connect Claude, Cursor & VS Code for the connector.

The skill covers image, video and audio models. For chat models, call the API directly.