MeltFlex AI Skills

AI agent skills for photorealistic interior and exterior design via MeltFlex AI — restyle rooms, place real furniture, swap floors, walls, stairs, doors and windows, redesign kitchens, bathrooms, facades and gardens, and turn 3D drafts into photos, all from a single photo. Also produces cinematic video walkthroughs and 3D models from 2D floorplans. 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.

_{Interior redesign · floor restyle from a material · garden design — a few of the 15 modes, all from one photo.}

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.

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, generate_video, floorplan_to_3d and check_credits tools. Full guide: https://www.meltflexai.com/mcp.

Skills

Skill	Invoke	Description
meltflex-design	/meltflex:design	Restyle a room, facade or garden; swap floors, walls, stairs, doors or windows; redesign a kitchen or bathroom; boost a layout; turn a 3D draft into a photo. 15 prompt-driven modes, plus video walkthroughs and floorplan→3D via the API.
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 — 15 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
layout_boost	Rearrange existing furniture into a better layout
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
stairs	Restyle a staircase in place
doors	Swap interior doors
windows	Swap window frames / glazing
kitchen	Whole kitchen redesign
bathroom	Whole bathroom redesign
photo_to_render	Turn a 3D draft / SketchUp shot into a photo
seasonal	Time-of-day / seasonal / lighting variation

Two more capabilities go beyond stills, using the same API key: a cinematic video walkthrough (POST /api/v1/video) and a 2D floorplan → 3D model (POST /api/v1/floorplan-to-3d). See the design skill and the API docs.

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 (attach the material as a reference)
Restyle stairs, doors or windows	meltflex-design	stairs / doors / windows mode
Redesign a kitchen or bathroom	meltflex-design	kitchen / bathroom mode
Turn a 3D draft into a photo	meltflex-design	photo_to_render mode
Cinematic video walkthrough	meltflex-design	POST /api/v1/video (100–150 credits)
2D floorplan → 3D model	meltflex-design	POST /api/v1/floorplan-to-3d (10 credits)
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 generate from 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.