{
  "markdown": "# MeltFlex AI Skills\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-22c55e.svg)](./LICENSE)\n[![Version](https://img.shields.io/badge/version-0.4.0-3b82f6.svg)](./VERSION)\n[![Skills](https://img.shields.io/badge/skills-3-8b5cf6.svg)](#skills)\n[![MCP tools](https://img.shields.io/badge/MCP_tools-6-0ea5e9.svg)](#use-with-the-mcp-server)\n[![Website](https://img.shields.io/badge/meltflexai.com-f97316.svg)](https://www.meltflexai.com)\n\nAI agent skills for **photorealistic interior and exterior design and 3D** 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. Then go further: **cinematic video walkthroughs**, **2D floorplan → 3D model or rendered 3D picture**, **furniture photo → GLB 3D model**, and **photo → explorable 3D world**. Works with Claude Code, <img src=\"assets/hermes.png\" width=\"14\" align=\"center\" alt=\"\" /> Hermes, Cursor, Codex, Cline, and other AI agents that load Markdown-based skills or speak MCP.\n\nEach user authenticates with their **own** MeltFlex API key; every generation is billed to their account credits. The skills call the public [MeltFlex API](https://www.meltflexai.com/api) directly, so there's nothing extra to install.\n\n<p align=\"center\">\n  <img src=\"https://www.meltflexai.com/api-docs/tools/interior.webp\" width=\"90%\" alt=\"Interior design — empty room to a fully furnished, photorealistic redesign\" />\n  <br />\n  <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\" />\n  <br />\n  <img src=\"https://www.meltflexai.com/api-docs/tools/garden.webp\" width=\"90%\" alt=\"Garden design — a plain patio restyled into a Mediterranean garden\" />\n</p>\n\n<p align=\"center\"><sub>Interior redesign · floor restyle from a material · garden design — a few of the 16 image modes, all from one photo.</sub></p>\n\n<p align=\"center\">\n  <img src=\"assets/furniture-3d.webp\" width=\"90%\" alt=\"Furniture photo → GLB 3D model: a blue armchair and a green sofa, each turned into a textured 3D model\" />\n  <br />\n  <img src=\"assets/world-3d.webp\" width=\"90%\" alt=\"Room render → explorable 3D world: a Scandinavian living room turned into a walkable Gaussian-splat world\" />\n  <br />\n  <img src=\"https://www.meltflexai.com/api-docs/tools/floorplan.webp\" width=\"90%\" alt=\"2D floorplan → GLB 3D model\" />\n</p>\n\n<p align=\"center\"><sub>Furniture photo → 3D model · room render → explorable 3D world · 2D floorplan → 3D model. Real outputs of <code>/api/v1/furniture-3d</code>, <code>/api/v1/world</code> and <code>/api/v1/floorplan-to-3d</code>.</sub></p>\n\n## Install\n\nPick one. Each method sets up the skills for your agent.\n\n### `npx skills` — recommended, cross-agent\n```bash\nnpx skills add MeltFlexDevs/skills\n```\n\n### GitHub CLI (v2.90+)\n```bash\ngh skill install MeltFlexDevs/skills\n```\n\n### Claude Code marketplace\nInside Claude Code:\n```\n/plugin marketplace add MeltFlexDevs/skills\n/plugin install meltflex@meltflex\n```\n\n### Setup script\nUniversal fallback:\n```bash\ngit clone --depth 1 https://github.com/MeltFlexDevs/skills.git\ncd skills\n./setup\n```\n\nMore options in [INSTALL.md](./INSTALL.md). Agent-driven install (paste into your agent): [INSTALL_FOR_AGENTS.md](./INSTALL_FOR_AGENTS.md). Cline and other MCP-settings agents: [llms-install.md](./llms-install.md).\n\n## Authenticate\n\nYou 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):\n\n<p align=\"center\">\n  <img src=\"https://www.meltflexai.com/api-docs/step-profile.webp\" width=\"48%\" alt=\"Settings — click API Key\" />\n  <img src=\"https://www.meltflexai.com/api-docs/step-generate.webp\" width=\"48%\" alt=\"Generate API Key\" />\n</p>\n\nThen expose it:\n\n```bash\nexport MELTFLEX_API_KEY=\"mf_sk_xxxxxxxxxxxx\"\n```\n\nIf you use the MCP server / CLI, you can skip the copy-paste and sign in from the browser instead: `npx -y meltflex-mcp auth login` opens <https://www.meltflexai.com/cli/authorize>, mints a key from your signed-in session and stores it in `~/.meltflex/config.json` (chmod 600).\n\n## Skills\n\n| Skill | Invoke | Description |\n|-------|--------|-------------|\n| 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. 16 prompt-driven modes with quality levels, region editing and batches, plus video walkthroughs via the API. |\n| 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). |\n| meltflex-3d | `/meltflex:3d` | 3D output: a furniture photo → GLB model, a 2D floorplan → GLB model or rendered 3D picture, a room photo → explorable 3D world (splat + hosted viewer). Handles the long-build polling. |\n\nImage skills are self-contained: a room photo in, a photorealistic redesign out, **10 credits** per image (auto-refunded on failure).\n\n## Image modes\n\n`meltflex-design` — 16 modes, each the same `POST /api/v1/generate` endpoint with a mode-tuned prompt:\n\n| Mode | What it's for |\n|------|---------------|\n| `restyle` | Change a room's style or theme |\n| `virtual_staging` | Furnish an empty room |\n| `layout_boost` | Rearrange existing furniture into a better layout |\n| `declutter` | Clean up / depersonalize a space |\n| `exterior` | Building facade / house exterior |\n| `garden` | Landscaping and outdoor design |\n| `wall_texture` | Change wall material or finish |\n| `floor_restyle` | Change the flooring |\n| `stairs` | Restyle a staircase in place |\n| `doors` | Swap interior doors |\n| `windows` | Swap window frames / glazing |\n| `kitchen` | Whole kitchen redesign |\n| `bathroom` | Whole bathroom redesign |\n| `photo_to_render` | Turn a 3D draft / SketchUp shot into a photo |\n| `seasonal` | Time-of-day / seasonal / lighting variation |\n| `region_edit` | Change only one area — paint it solid red, send `mask: true` |\n\nOptional fields on every image call: `resolution` (`512` / `1K` / `2K`), `designLevel` (`lite` −2 cr · `quick` · `pro` +5 cr), `variations` (1–3 per call, charged per image), up to 10 `referenceImageUrls`.\n\n## Video & 3D\n\nSame key, five more outputs. The three 3D builds can take minutes; they answer **HTTP 202 + a poll URL** when they outlive the request, and `/meltflex:3d` shows how to poll.\n\n| Output | Endpoint | Credits | Time | MCP tool · CLI |\n|--------|----------|---------|------|----------------|\n| Cinematic walkthrough video (MP4, Veo 3.1) | `POST /api/v1/video` | 100 (4s) / 150 (8s) | ~1 min | `generate_video` · `meltflex video` |\n| Floorplan → rendered 3D picture (PNG) | `POST /api/v1/floorplan-to-3d` `output: \"render\"` | 10 | ~20 s | REST only |\n| Floorplan → GLB 3D model | `POST /api/v1/floorplan-to-3d` `output: \"model\"` | 100 | ~3 min | `floorplan_to_3d` · `meltflex floorplan` |\n| Furniture photo → GLB 3D model (+ USDZ/FBX/OBJ) | `POST /api/v1/furniture-3d` | 75 | 2–3 min | `furniture_to_3d` · `meltflex furniture` |\n| Photo → explorable 3D world (.spz + viewer link) | `POST /api/v1/world` | 30 (draft) / 200 (hd) | ~1 / ~5 min | `generate_world` · `meltflex world` |\n\nFull reference with response bodies and three.js / Spark loader snippets: <https://www.meltflexai.com/api>.\n\n## Quick Reference\n\n| What you want | Skill | Note |\n|---------------|-------|------|\n| Restyle a room from a photo | `meltflex-design` | Pick a mode, write a specific prompt |\n| Furnish an empty room | `meltflex-design` | `virtual_staging` mode |\n| Place a *specific* sofa/bed/table | `meltflex-furniture` | Pass product images as references |\n| Redesign a house exterior or garden | `meltflex-design` | `exterior` / `garden` mode |\n| Swap flooring or wall finish | `meltflex-design` | `floor_restyle` / `wall_texture` (attach the material as a reference) |\n| Restyle stairs, doors or windows | `meltflex-design` | `stairs` / `doors` / `windows` mode |\n| Redesign a kitchen or bathroom | `meltflex-design` | `kitchen` / `bathroom` mode |\n| Turn a 3D draft into a photo | `meltflex-design` | `photo_to_render` mode |\n| Change only one marked area | `meltflex-design` | `region_edit` — paint it red, `mask: true` |\n| Sharper output / several options | `meltflex-design` | `resolution: \"2K\"`, `designLevel: \"pro\"`, `variations: 3` |\n| Cinematic video walkthrough | `meltflex-design` | `POST /api/v1/video` (100–150 credits) |\n| 3D model of a furniture piece | `meltflex-3d` | `POST /api/v1/furniture-3d` (75 credits) |\n| 2D floorplan → 3D model / 3D picture | `meltflex-3d` | `POST /api/v1/floorplan-to-3d` (100 / 10 credits) |\n| Walk through a room in 3D | `meltflex-3d` | `POST /api/v1/world` (30 draft / 200 hd) |\n| Check credit balance | — | `meltflex credits` (CLI) or the MCP `check_credits` tool |\n\n## Use with the MCP server\n\nAgents that prefer tool calls over scripted API calls can run the [`meltflex-mcp`](https://www.meltflexai.com/mcp) server (npm, stdio). It exposes six tools — `generate_interior`, `generate_video`, `floorplan_to_3d`, `furniture_to_3d`, `generate_world`, `check_credits` — and handles polling and saving files to disk.\n\n```bash\nnpx -y meltflex-mcp auth login              # or: npx -y meltflex-mcp auth mf_sk_xxxxxxxx\nclaude mcp add meltflex -- npx -y meltflex-mcp\n```\n\nAny MCP client works with the same shape (`command: npx`, `args: [\"-y\", \"meltflex-mcp\"]`, optional `env.MELTFLEX_API_KEY`). The same package is a terminal CLI: `meltflex generate | video | floorplan | furniture | world | credits`. A Claude Desktop extension bundle lives in [`mcpb/`](./mcpb).\n\n### <img src=\"assets/hermes.png\" width=\"20\" align=\"center\" alt=\"\" /> Hermes\n\n[Hermes](https://hermes-agent.nousresearch.com) (Nous Research) speaks MCP, so it runs MeltFlex through the same server.\n\n**From the catalog** (once merged into the Hermes catalog):\n```bash\nhermes mcp install meltflex\n```\n\n**Manually** — sign in once, then add the server to `~/.hermes/config.yaml`:\n```bash\nnpx -y meltflex-mcp auth login\n```\n```yaml\nmcp_servers:\n  meltflex:\n    command: npx\n    args: [\"-y\", \"meltflex-mcp\"]\n```\nStart `hermes chat` (or run `/reload-mcp` in a session) to load the six MeltFlex tools. Full guide: <https://www.meltflexai.com/mcp>.\n\n## Going further\n\n- **API docs:** <https://www.meltflexai.com/api>\n- **CLI:** <https://www.meltflexai.com/cli> — `meltflex generate` from your terminal\n- **MCP server:** <https://www.meltflexai.com/mcp> — `npx -y meltflex-mcp`\n- **Cookbook:** [COOKBOOK.md](./COOKBOOK.md) · **Changelog:** [CHANGELOG.md](./CHANGELOG.md)\n\n## Security\n\nThe 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](https://www.meltflexai.com/settings).\n\n## License\n\nMIT — see [LICENSE](./LICENSE). Contributions welcome — see [CONTRIBUTING.md](./CONTRIBUTING.md).\n",
  "bytes": 11224,
  "sha": "ff60a38a0be44d4621e46c80779f0c9b3973c7cf645b256aa71c22d3ff12d75a",
  "repo_slug": "meltflexdevs/skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_meltflexdevs_meltflex_92267ba5/readme"
}