AITOPIA README

AITOPIA Skills

AI agent skills for creating, editing and analyzing images, video, voiceovers and music with AITOPIA — plus AITOPIA's production playbooks for product ads, UGC videos, short-form videos, YouTube thumbnails and brand kits. Works with Claude Code, Codex, Cursor and other agents that load Markdown skills, and with any MCP client through the AITOPIA server.

Everything runs on your AITOPIA account through the AITOPIA MCP server (https://mcp.aitopia.ai/mcp). There is nothing to install locally: the first AITOPIA action opens a browser sign-in, and every result is saved to your account, where you can keep working on it.

Install

Pick one. The plugin installs (Claude Code, Codex, Cursor) connect the AITOPIA server for you.

Claude Code marketplace — recommended for Claude Code

/plugin marketplace add AITOPIAai/skills
/plugin install aitopia@aitopia

npx skills — cross-agent

npx skills add AITOPIAai/skills

Installs the skills into Claude Code, Codex, Cursor and many other agents. Connect the AITOPIA server once as well (see INSTALL.md).

Codex

codex mcp add aitopia --url https://mcp.aitopia.ai/mcp
codex mcp login aitopia
npx skills add AITOPIAai/skills --agent codex

One-click: Cursor, VS Code, Gemini CLI

Gemini CLI (server + playbooks):

gemini extensions install https://github.com/AITOPIAai/skills

Any other MCP client: add the remote server https://mcp.aitopia.ai/mcp (Streamable HTTP, OAuth sign-in).

Claude (web and desktop)

Settings → Connectors → Add custom connector → https://mcp.aitopia.ai/mcp, then sign in with AITOPIA. Generated images and videos show inline in the conversation.

ChatGPT

Go to chatgpt.com/plugins → Add → Create MCP App, enter https://mcp.aitopia.ai/mcp, then sign in with AITOPIA. Developer mode is no longer needed.

AITOPIA CLI (terminal)

npm i -g aitopia
aitopia login
aitopia image "a red paper boat on a pond"
aitopia dub video.mp4 --to Spanish --dry-run

aitopia --help lists every command (image, video, audio, edit, analyze, transcribe, dub, upload, models…).

More options in INSTALL.md. Agent-driven install (paste into your agent): INSTALL_FOR_AGENTS.md.

Skills

The second line is the command in the Claude Code plugin; with npx skills the command is the skill name, e.g. /aitopia-generate.

Agents also use the skills on their own when a request fits. The playbooks behind the workflow skills live on AITOPIA and are loaded at run time, so they improve without reinstalling anything.

The skills chain: aitopia-upload turns a local file into an asset URL that every other skill accepts; aitopia-generate produces the stills and clips that aitopia-edit assembles; the workflow skills (product-ad, ugc-video, short-video, youtube-thumbnail, brand-kit) drive both.

Video analysis

Ask your agent what is in a video, image or audio file and it uses AITOPIA's analyze_media tool. The agent watches the video and listens to it, then answers:

• Summary: what happens, what is said, the text on screen, the music and sound.
• Scenes: every shot with its start and end time, ready for cutting with aitopia-edit.
• Ad review: a score out of 10, the hook, message, call to action, pacing, strengths and what to improve.
• Re-create prompt: a prompt that makes a similar image or video with aitopia-generate.
• Your question: "Is the logo visible in the first 3 seconds?", "Is this suitable for children?"

It answers in any language. Try it in Claude, ChatGPT, Cursor or Codex:

Analyze this video and list every scene with its time: <video URL>
Score this ad and tell me how to improve the first 3 seconds: <video URL>
Write a prompt that re-creates this image: <image URL>

A video can be up to 2 MB for now. One analysis costs about 3 credits, and a failed run is not charged. Ask for the price first and the agent checks it with dryRun without running anything. The same analysis is in the AITOPIA CLI (aitopia analyze clip.mp4 --mode scenes) and in AITOPIA chat.

Quick Reference

Recipes that combine skills: COOKBOOK.md.

Credits

Generation spends AITOPIA credits from your account; editing and uploads are cheap or free. If a run needs more credits, the result links to aitopia.ai/pricing.

License

MIT — see LICENSE.