Conviu Agent

Your AI assistant, taught to run your product feeds.

Connect Conviu to Claude (or Cursor, Codex, Copilot…), install this skill, and then just say what you need — in your own words, in your own language:

"Google rejected my products — why?"

"Make me a Heureka feed from my import."

"My export has been empty since yesterday."

"Show me everything over 1000 that's out of stock."

"Check all my e-shops and tell me what's broken."

Without the skill, an AI assistant pointed at Conviu guesses: it invents field names, picks the wrong feed format, dumps raw ids at you, and changes things you didn't ask for. The skill teaches it Conviu's vocabulary, the FQL filter syntax, and the right order of steps for each job — so it looks things up in your account before answering, and asks before it changes anything.

Step 1 — connect Conviu

The skill works through the Conviu MCP server; without it there's nothing to act on. Connect it in your AI tool first:

https://mcp.conviu.io

It acts with your own identity and your own permissions — it can see and do exactly what you can.

Step 2 — install the skill

Claude Code

/plugin marketplace add conviu/conviu-skills
/plugin install conviu-agent@conviu-skills

Every other tool — one command

npx conviu-agent init --ai <tool>

Pick your tool:

| Your tool | Command | |---|---| | Claude Code | npx conviu-agent init --ai claude | | Cursor | npx conviu-agent init --ai cursor | | Windsurf | npx conviu-agent init --ai windsurf | | Codex | npx conviu-agent init --ai codex | | Gemini CLI | npx conviu-agent init --ai gemini | | GitHub Copilot | npx conviu-agent init --ai copilot | | Kiro | npx conviu-agent init --ai kiro | | OpenCode | npx conviu-agent init --ai opencode | | Roo Code | npx conviu-agent init --ai roocode | | KiloCode | npx conviu-agent init --ai kilocode | | Qoder | npx conviu-agent init --ai qoder | | Trae | npx conviu-agent init --ai trae | | Continue | npx conviu-agent init --ai continue | | CodeBuddy | npx conviu-agent init --ai codebuddy | | Droid (Factory) | npx conviu-agent init --ai droid | | Warp | npx conviu-agent init --ai warp | | Augment | npx conviu-agent init --ai augment | | Antigravity | npx conviu-agent init --ai antigravity | | CodeWhale | npx conviu-agent init --ai codewhale |

Each tool gets the skill in the layout it expects — you don't need to know where it goes.

Handy extras

npx conviu-agent init --all              # install for every tool above
npx conviu-agent init --ai cursor --global   # install for your whole machine, not just this folder
npx conviu-agent uninstall --ai cursor   # remove it again
npx conviu-agent list                    # show supported tools

Add --force to overwrite an existing install, or --dir <path> to install somewhere specific.

Step 3 — just ask

Open a new session (skills load at start) and describe your problem the way you'd describe it to a colleague. The assistant will find the right import, export or product itself.

What it can do

| You want to… | It will… | |---|---| | Set up from scratch | Detect your feed's format from its URL, create the import, check the products actually landed, then build the export — and tell you when it refreshes. | | Fix a broken feed | Work out whether the import or the export is at fault, read the real run logs, and offer the fix. | | Deal with a rejection | Pull the feed validation for Google / Heureka / Zboží.cz and explain what's wrong — no guessing about platform rules; it reads the docs. | | Find products | Turn "over 1000 and out of stock" into a correct FQL filter over your real fields. | | Watch everything | Report every module's health — and for agencies, sweep every organization you manage and list only what needs you. | | Change something | Edit only what you asked for, and confirm before anything is deleted, triggered, or switched off. |

Under the hood it prefers Conviu's own live playbooks (get_workflow) and falls back on bundled references for depth: Conviu's concepts and identifiers, FQL syntax, imports, exports, diagnostics, feed validation, health checks, onboarding, and a list of the things the tools genuinely can't do.

It's honest about limits by design — where Conviu can't do something through the API, it says so instead of inventing a workaround.

Use it as a documentation source

This repository is indexed by Context7, so any Context7-enabled assistant can query the same material on demand:

https://context7.com/conviu/conviu-skills

Useful when you'd rather ask a question than install anything.

License

MIT © Conviu