Skip to main content
Agent Skills are folders of instructions, scripts, and resources that agents discover and load on demand to work more accurately. For background, see Agent Skills.
The modellix-plugin repository ships twelve Agent Skills. This page covers installing one skill on its own. modellix-design generates images, videos, and speech with Modellix. The other skills plan prompts or edit files that are already on disk. Their roles are listed on the Plugin page.
The execution skill directory moved from skills/modellix to skills/modellix-design. Update install commands to --skill modellix-design.

Skill or Plugin

See the Plugin guide for marketplace and npm installs.

What You Can Install Alone

skills.sh can install these two skills from the repository: The other ten skills ship with the plugin and with a checkout of the repository. Installing only modellix-design does not include them. Symlink <name> from skills/<name> when you want one of those skills from a local clone. The Plugin page lists each skill.

What the Skill Gives Your Agent

modellix-design teaches the agent to:
  • Submit through Media Generation when its tools are available and the input is not a local file
  • Otherwise use the CLI: preflight, then model get-schema when the body is incomplete, then model run --wait, then task download
  • Fall back to REST submit-and-poll when Media Generation and the CLI are both unavailable
  • Ask which provider/model slug to run when you do not name one, and wait for the answer
  • Discover models through model list and model describe, and read live request schemas from model get-schema
  • Discover an existing API key before asking, prefer a session-only key, and persist a key only when you ask
  • Map retries to HTTP status codes and CLI exit codes, and avoid re-running a paid submission when the outcome is unknown

Requirements

The skill works without the CLI by calling the REST API when Media Generation is also unavailable. The CLI gives your agent single-command waiting, safer downloads, and local task history. Preflight can install or refresh the CLI before the first paid command. See the Plugin requirements.

Install

Works with any Agent Skills host:
Target one agent:
Update:

Configure Your API Key

The skill discovers an existing key before it asks you for one:
  1. It first checks the session environment for MODELLIX_API_KEY.
  2. It then checks for a saved CLI profile through modellix-cli auth status or doctor.
  3. Only when neither exists does it ask you for a key.
The CLI resolves keys in this order: --api-key, then MODELLIX_API_KEY, then the selected saved profile.
The skill does not persist your key automatically. Ask for persistence explicitly, and prefer modellix-cli auth login or modellix-cli init so the CLI validates and stores the profile. Never commit an API key or print it in logs.

Verify the Install

Name the model in the prompt. The skill asks and waits when the slug is missing.
1

Check the Environment

doctor reports the Node.js version, the API-key source, API connectivity, and your team balance without printing the key.
2

Prompt Your Agent

The skill submits the task, waits for it, and downloads the result.
3

Compare with the Manual Flow

Supported Task Types

Exact schemas come from modellix-cli model get-schema or modellix_get_schema. See Inspect a Request Schema.

Name the Model

Use the provider/model slug you named. If you did not name one, the skill asks which model to run and waits. It does not invent a slug.
Model slugs are exact, and decimals matter. Copy the slug from model list or the model page. Do not guess it from a documentation filename.

Inspect a Request Schema

On the Media Generation path, the skill calls modellix_get_schema with the exact slug. On the CLI path, it reads the live request and response contract with modellix-cli model get-schema <provider/model>. That endpoint is public and does not need an API key. JSON is the default.
Command details: CLI schema command. REST contract: Get Schema. The agent calls get-schema when:
  • the body needs fields beyond the documented examples
  • a previous submit returned HTTP 400
  • it needs to report required fields, such as TTS voices
It skips get-schema when you supplied a complete body. If the CLI and Media Generation are both unavailable, the skill uses Docs Search when connected, then docs_url from model describe, or the model page in llms.txt.

What Is Inside the Skill

These paths are relative to skills/modellix-design/: Your agent loads references progressively, reading only the files a task needs.

Error Handling the Skill Follows

Troubleshooting

Next Steps

Plugin

Install all twelve skills from a host marketplace or npm.

CLI

Learn the modellix-cli commands the skill runs.

REST API

Call Modellix directly without the CLI.

Pricing

Review model pricing before running paid tasks.