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, <img src="assets/hermes.png" width="14" align="center" alt="" /> 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.
<p align="center"> <img src="https://www.meltflexai.com/api-docs/tools/interior.webp" width="90%" alt="Interior design — empty room to a fully furnished, photorealistic redesign" /> <br /> <img src="https://www.meltflexai.com/api-docs/tools/floor.webp" width="90%" alt="Floor restyle — upload a material and it is applied to your room" /> <br /> <img src="https://www.meltflexai.com/api-docs/tools/garden.webp" width="90%" alt="Garden design — a plain patio restyled into a Mediterranean garden" /> </p>
<p align="center"><sub>Interior redesign · floor restyle from a material · garden design — a few of the 15 modes, all from one photo.</sub></p>
Install
Pick one. Each method sets up the skills for your agent.
npx skills — recommended, cross-agent
npx skills add MeltFlexDevs/skillsGitHub CLI (v2.90+)
gh skill install MeltFlexDevs/skillsClaude Code marketplace
Inside Claude Code: `` /plugin marketplace add MeltFlexDevs/skills /plugin install meltflex@meltflex ``
Setup script
Universal fallback: ``bash 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):
<p align="center"> <img src="https://www.meltflexai.com/api-docs/step-profile.webp" width="48%" alt="Settings — click API Key" /> <img src="https://www.meltflexai.com/api-docs/step-generate.webp" width="48%" alt="Generate API Key" /> </p>
Then expose it:
export MELTFLEX_API_KEY="mf_sk_xxxxxxxxxxxx"<img src="assets/hermes.png" width="20" align="center" alt="" /> 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): ``bash hermes mcp install meltflex ``
Manually — sign in once, then add the server to ~/.hermes/config.yaml: ``bash npx -y meltflex-mcp auth login ` `yaml 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 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.
