← Back to Skills Marketplace
Melies
by
Romain SIMON
· GitHub ↗
· v2.1.0
· MIT-0
262
Downloads
1
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install melies
Description
AI filmmaking CLI with 148 built-in actors, 98 visual styles, and smart model selection. Generate images, videos, posters, and thumbnails without prompt engi...
Usage Guidance
This skill appears to do what it says: a CLI that talks to melies.co. Before installing, confirm you trust the melies npm package and the melies.co domain. Be aware the CLI saves your API token to ~/.melies/config.json and will open a browser and run a short-lived localhost server during the login flow — both are standard but mean the token is stored locally. Only provide a token with the minimum needed permissions and do not set MELIES_API_URL to an untrusted host (changing it could redirect your token/requests). If you need stronger assurance, review the package source on the upstream repo and install from a verified registry account.
Capability Analysis
Type: OpenClaw Skill
Name: melies
Version: 2.1.0
The Melies CLI skill bundle is classified as suspicious due to significant security vulnerabilities that could be exploited via prompt injection. Specifically, the login command in src/commands/login.ts (and the compiled dist/index.js) is vulnerable to shell injection because it incorporates the MELIES_API_URL environment variable into a child_process.exec call without sanitization. Additionally, multiple commands including image, video, and pipeline (src/commands/image.ts, src/commands/video.ts, src/commands/pipeline.ts) allow arbitrary file writes via the --output flag without path validation, potentially enabling the overwriting of sensitive system files. While these appear to be unintentional vulnerabilities rather than intentional malware, they pose a high risk in an autonomous agent environment.
Capability Assessment
Purpose & Capability
Name/description (AI filmmaking CLI) match the code, SKILL.md, and package.json. Requested binaries (melies), declared config path (~/.melies/config.json), and env vars (MELIES_TOKEN, MELIES_API_URL) are appropriate for a networked CLI that authenticates to melies.co. The node/npm install of the 'melies' package is proportionate.
Instruction Scope
SKILL.md and the code instruct normal CLI operations: npm install, melies login (browser flow or token), generation commands, and optional --sync/--dry-run. Runtime code starts a local HTTP listener to receive an auth callback and opens a browser (child_process.exec) — this is common for CLI OAuth flows but worth noting. The CLI reads/writes only its declared config file (~/.melies/config.json) and calls the melies API; it does not attempt to read other system files or unrelated credentials.
Install Mechanism
Install spec is a published Node package ('melies') that creates the 'melies' binary. No downloads from ad-hoc URLs or archive extraction is used. The package.json and built/dist files are present and consistent with the SKILL.md.
Credentials
Only MELIES_TOKEN (primary credential) and MELIES_API_URL are required — reasonable for an API-backed CLI. One caution: MELIES_API_URL (and the config file) can be overridden; if pointed to a malicious endpoint, a token could be sent to an attacker-controlled server. Ensure you only set MELIES_API_URL to trusted endpoints and use tokens with appropriate scope/limits.
Persistence & Privilege
The skill does not request always:true and uses normal autonomous invocation. It stores its own token to ~/.melies/config.json (consistent with a CLI) and does not modify other skills or system-wide settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install melies - After installation, invoke the skill by name or use
/melies - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.1.0
- Added browser-based login: run `melies login` to authenticate via browser (no token required).
- Updated authentication instructions in documentation for clarity and multiple login methods.
- Refactored login command to support browser auth and streamline token usage.
- Improved DX for CI and agents (token now consistent as CLI flag or env var).
- Minor documentation updates for commands and options.
v2.0.0
**Major update – skill expanded with actor presets, style flags, and new creative pipelines**
- Added 148 built-in AI actors and 98 visual styles; use --actor, --art-style, --lighting, --mood flags instead of detailed prompt engineering.
- Introduced thumbnail, pipeline, upscale, and remove-bg commands for streamlined creative tasks.
- Smart model selection with `--fast`, `--quality`, and `--best` presets; model overrides still supported.
- Visual style and camera/lens attribute flags now available for more cinematic control.
- New commands: melies actors, melies styles, melies pipeline, melies thumbnail, melies remove-bg, melies upscale.
- Comprehensive CLI documentation updated; poster, image, and video commands enhanced for natural language and style-flag input.
v1.1.1
- Added MELIES_API_URL as a required environment variable in metadata.
- Listed ~/.melies/config.json as a config file in metadata.
- Version bumped from 1.1.0 to 1.1.1.
v1.1.0
Melies 1.1.0 Changelog
- Added detailed documentation (SKILL.md) covering installation, authentication, and CLI command usage.
- Enhanced CLI support for image, video, and movie poster generation using 50+ models.
- Introduced new features: style transfer, image-to-video, and consistent character/object references with `melies ref`.
- Improved workflows for filmmakers and content creators: batch generation, YouTube thumbnails, and asset management.
- Clarified authentication methods and options for both API token and email/password logins.
- Provided usage examples and best practices for common generation pipelines.
Metadata
Frequently Asked Questions
What is Melies?
AI filmmaking CLI with 148 built-in actors, 98 visual styles, and smart model selection. Generate images, videos, posters, and thumbnails without prompt engi... It is an AI Agent Skill for Claude Code / OpenClaw, with 262 downloads so far.
How do I install Melies?
Run "/install melies" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Melies free?
Yes, Melies is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Melies support?
Melies is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Melies?
It is built and maintained by Romain SIMON (@romainsimon); the current version is v2.1.0.
More Skills