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.
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-schemawhen the body is incomplete, thenmodel run --wait, thentask download - Fall back to REST submit-and-poll when Media Generation and the CLI are both unavailable
- Ask which
provider/modelslug to run when you do not name one, and wait for the answer - Discover models through
model listandmodel describe, and read live request schemas frommodel 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
- A Modellix API key from the Modellix Console
- Recommended:
modellix-cli0.0.11 or later on Node.js 18.17 or later
Install
- skills.sh
- Cursor
- OpenCode
- Pi
- Hermes
Works with any Agent Skills host:Target one agent:Update:
Configure Your API Key
- It first checks the session environment for
MODELLIX_API_KEY. - It then checks for a saved CLI profile through
modellix-cli auth statusordoctor. - Only when neither exists does it ask you for a key.
--api-key, then MODELLIX_API_KEY, then the selected saved profile.
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
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 theprovider/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.
Inspect a Request Schema
On the Media Generation path, the skill callsmodellix_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.
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
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 toskills/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.