Modellix Agent Skill

Agent skill for integrating Modellix, a unified Model-as-a-Service (MaaS) platform for image and video generation.

What This Skill Provides

• CLI-first, REST-fallback workflow for async generation tasks
• Model discovery using bundled references/REFERENCE.md
• Task submission + polling guidance (pending / success / failed)
• Retry/error handling for 429, 500, 503
• Credential and egress transparency (MODELLIX_API_KEY, outbound calls to api.modellix.ai)

Install

From GitHub

General:

npx skills add https://github.com/Modellix/modellix-skill/tree/main/modellix-skill

Cursor:

npx skills add https://github.com/Modellix/modellix-skill/tree/main/modellix-skill --agent cursor

Update skills:

npx skills update

From Smithery

General:

npx @smithery/cli@latest skill add modellix/modellix-skill

Cursor:

npx @smithery/cli@latest skill add modellix/modellix-skill --agent cursor

From ClawHub

clawhub install modellix

Update all installed skills:

clawhub update --all

Credential

This skill requires:

• MODELLIX_API_KEY (required)
• Primary credential: MODELLIX_API_KEY
• Required env vars: MODELLIX_API_KEY
• Registry-facing requirement: package metadata should expose MODELLIX_API_KEY as both primary credential and required env var.
• CLI usage policy: default to the two-command flow (modellix-cli model invoke and modellix-cli task get); use --help as assistive fallback, not as trial-and-error.
• If CLI is missing, install is optional (npm i -g modellix-cli) and should be done only with explicit user consent; REST fallback is supported.

Create API key at: https://modellix.ai/console/api-key

Execution Guidance

• Preferred path: direct CLI pair (modellix-cli model invoke -> modellix-cli task get).
• Python scripts in modellix-skill/scripts/ are optional automation helpers.
• If a Python helper fails on your platform, switch directly to the CLI pair and continue.

Supported Task Types

Type	Description
text-to-image	Generate images from text prompts
image-to-image	Edit or transform images with text instructions
text-to-video	Create videos from text descriptions
image-to-video	Convert static images into video sequences
video-to-video	Transform existing videos

Skill Structure

modellix-skill/
├── SKILL.md
├── skill.json
├── scripts/
├── references/
└── assets/

Links

• Docs: docs.modellix.ai
• Agent Skill Guide: ways-to-use/skill
• REST API Guide: ways-to-use/api
• CLI Guide: ways-to-use/cli
• Pricing: get-started/pricing
• Support: support@modellix.ai
• Community: Discord