
MeltFlex AI Skills
AI agent skills for photorealistic interior design via MeltFlex AI โ restyle rooms, place real furniture, virtually stage, and re-theme spaces from a single photo. Works with Claude Code, Hermes, Cursor, Codex, and other AI agents that load Markdown-based skills or speak MCP.
Each user authenticates with their own MeltFlex API key; every generation is billed to their account credits. The skills call the public MeltFlex API directly, so there's nothing extra to install.
Authenticate
You need an active subscription (any paid plan) โ without one the key won't work. After subscribing at https://www.meltflexai.com/settings, open account settings โ API Key under Profile, then Generate API Key (shown once โ copy it):
Then expose it:
export MELTFLEX_API_KEY="mf_sk_xxxxxxxxxxxx"
Use with Hermes
Hermes (Nous Research) speaks MCP, so it runs MeltFlex through the meltflex-mcp server.
From the catalog (once merged into the Hermes catalog):
hermes mcp install meltflex
Manually โ sign in once, then add the server to ~/.hermes/config.yaml:
npx -y meltflex-mcp auth login
mcp_servers:
meltflex:
command: npx
args: ["-y", "meltflex-mcp"]
Start hermes chat (or run /reload-mcp in a session) to load the generate_interior and check_credits tools. Full guide: https://www.meltflexai.com/mcp.
Skills
Skill Invoke Description
meltflex-design /meltflex:design Restyle, redesign, declutter, virtually stage, or re-theme a room, facade, or garden from a photo. 8 modes (restyle, virtual staging, declutter, exterior, garden, wall texture, floor restyle, seasonal).
meltflex-furniture /meltflex:furniture Place specific real furniture/decor products into a room photo, matching their exact colors, materials, and proportions (up to 10 reference items).
Both skills are self-contained: a room photo in, a photorealistic redesign out, 10 credits per generation (auto-refunded on failure).
Modes
meltflex-design โ 8 modes, each the same endpoint with a mode-tuned prompt:
Mode What it's for
restyle Change a room's style or theme
virtual_staging Furnish an empty room
declutter Clean up / depersonalize a space
exterior Building facade / house exterior
garden Landscaping and outdoor design
wall_texture Change wall material or finish
floor_restyle Change the flooring
seasonal Time-of-day / seasonal / lighting variation
Quick Reference
What you want Skill Note
Restyle a room from a photo meltflex-design Pick a mode, write a specific prompt
Furnish an empty room meltflex-design virtual_staging mode
Place a specific sofa/bed/table meltflex-furniture Pass product images as references
Redesign a house exterior or garden meltflex-design exterior / garden mode
Swap flooring or wall finish meltflex-design floor_restyle / wall_texture
Check credit balance โ meltflex credits (CLI) or the MCP check_credits tool
Going further
-
API docs: https://www.meltflexai.com/api
-
CLI: https://www.meltflexai.com/cli โ
meltflex generatefrom your terminal -
MCP server: https://www.meltflexai.com/mcp โ
npx -y meltflex-mcp -
Cookbook: COOKBOOK.md
Security
The skills never contain a key. Each user supplies their own mf_sk_ key via MELTFLEX_API_KEY; generations spend that user's own credits. Credits, auth, and rate limits are all enforced server-side. Never commit your key โ revoke it anytime in settings.
License
MIT โ see LICENSE. Contributions welcome โ see CONTRIBUTING.md.
npx skills add MeltFlexDevs/skillsBefore it works, you'll need: MELTFLEX_API_KEY
Install
Pick one. Each method sets up the skills for your agent.
npx skills โ recommended, cross-agent
npx skills add MeltFlexDevs/skills
GitHub CLI (v2.90+)
gh skill install MeltFlexDevs/skills
Claude Code marketplace
Inside Claude Code:
/plugin marketplace add MeltFlexDevs/skills
/plugin install meltflex@meltflex
Setup script
Universal fallback:
git clone --depth 1 https://github.com/MeltFlexDevs/skills.git
cd skills
./setup
More options in INSTALL.md. Agent-driven install (paste into your agent): INSTALL_FOR_AGENTS.md.
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.