data-layer-id, nombre y posición. La persona edita esas capas en el editor igual que en Figma.set_paint), nunca un "background" detrás.save_version.1. resolve_brand({ workspaceId, brand }) → paleta, tipografías, logo, plantillas de la marca.
2. get_active_styles({ workspaceId }): si hay estilos bloqueados, son obligatorios.
3. Si la marca tiene plantillas aprobadas, parte de ellas (create_from_plantilla, skill musa-marcas) en vez de empezar en blanco.
Pieza nueva (post, story, banner)
1. create_template({ name, workspaceId, engine: "html", width, height }) → templateId y el Frame 1.
2. set_frame_layers({ templateId, frameId, background, fontImports, layers }): el diseño completo como lista plana de capas (id, name, kind, x, y, width, height, contenido, estilo). Es la herramienta recomendada.
3. Si el texto es largo, mide antes con text_metrics para elegir tamaño y que no se desborde.
4. Íconos: search_icons → insert_icon. Fotos: search_stock_image o upload_image; ilustraciones: search_illustrations → get_illustration_svg.
5. Verifica (ver abajo) y entrega el enlace con editor_open({ templateId, surface: "design" }).
Carrusel o deck en una llamada
create_html_carousel({ workspaceId, name, width, height, brandId, frames }).create_deck({ workspaceId, name, brand, cover, slides }). La portada siempre es el primer frame. Ábrela con presentation_open.Editar un diseño existente
1. get_template (o get_html_frames para ver HTML/CSS de los frames) y get_template_structure para el árbol de capas.
2. Cambios puntuales: edit_text_content (textos), set_paint (colores), transform_element (posición y tamaño), update_element (HTML/CSS de una capa), update_frame_content (por selector CSS).
3. Agregar o quitar: add_element, add_primitive, remove_element, duplicate_frame, create_html_frame.
4. Rehacer un frame entero: set_frame_layers de nuevo sobre el mismo frame.
5. Cambios guiados por instrucción en lenguaje natural: enhance_template({ templateId, instruction }).
Llevar a otros formatos
1. adapt_all_formats({ templateId, formats: ["story", "post", "banner", ...] }) o adapt_format para uno.
2. compare_adaptations para revisar lado a lado; corrige lo que se rompa.
Desde una imagen o un prompt
image_to_design convierte una imagen de referencia en capas editables.generate_from_prompt crea un diseño desde texto (modelo del espacio).diff_overlay hasta que coincida.Replicar una referencia con HTML (importar o pegar)
id con sentido a cada elemento (id="paper", id="titleBig"): el editor nombra las capas con el id (o el alt de una imagen), no con «div» o «img».clip-path: polygon(...), circle(), ellipse() o inset() en línea o en una regla CSS. Se ven en el editor y se respetan al exportar a PNG, JPG y PDF, igual que filter: blur() en sombras de color liso o imagen. Los degradados con clip-path se exportan sin el recorte: usa color liso.<svg> es una capa «Vector». Cada forma (path, rect, circle…) tiene su relleno y su trazo en Props y se puede separar en capas. Para que dos partes tengan colores distintos, dibújalas como formas separadas; un trazado con huecos (fill-rule="evenodd", la «a» de una tipografía) es una sola forma y el hueco deja ver lo de atrás.Verificar antes de entregar (obligatorio)
1. lint_design({ templateId, frameId }) → puntaje y problemas (textos desbordados, capas fuera del frame, contraste).
2. validate_brand({ templateId, brandId }) si es de una marca; check_contrast o check_accessibility si hay dudas de lectura.
3. render_frame_png({ templateId, frameId }) para ver el resultado: abre la captureUrl una vez y lee la URL del PNG. Si no puedes abrir páginas, usa render_html_template.
4. Corrige solo lo que falle. update_thumbnail si cambió mucho.
Exportar y compartir
render_html_template, render_to_formats, export_batch (varios frames).export_pdf. SVG editable: export_frame. Código: copy_as.share_design({ templateId, isPublic: true }).musa-video y musa-mailing-eventos.Archivo y frames
list_templates, get_template: buscar y leer diseños (para filtros avanzados: find_templates en musa-diseno-biblioteca).create_template, create_html_template: diseño nuevo (siempre engine: "html").create_html_carousel: carrusel multi-frame en una llamada.create_deck: presentación 1920×1080 en una llamada.update_template, rename_template, duplicate_template, delete_template.create_html_frame, create_frame, update_html_frame, delete_html_frame, delete_frame, duplicate_frame.get_html_frames, list_frames, get_frame.Capas
set_frame_layers: frame completo como lista de capas (recomendada).set_canvas_layers: objetos sueltos en el lienzo, fuera de los frames.set_html, set_css: reemplazan HTML/CSS de un frame (pasan por el normalizador de capas).get_template_structure, select_element: árbol y detalle de capas.add_element, add_primitive, remove_element, update_element, update_frame_content, change_element_tag, reorder_element.edit_text_content: cambiar texto de una capa.transform_element, align_elements, group_elements, smart_layout: posición, alineación, grupos, grillas.set_layer_z: orden de apilado (en el editor es el campo Z de Props: 0 = al fondo).lock_element, hide_element.canvas_select_move, canvas_copy_paste, canvas_undo_redo, canvas_context_menu: lo mismo que hace la persona con el mouse (mover, copiar/pegar, deshacer, clic derecho).Estilo
set_paint: relleno y borde de una capa (la única forma de colorear).set_gradient, set_blend_mode, set_pattern_fill, set_pseudo_state.copy_style, paste_style.text_metrics: mide texto con métricas reales de la fuente antes de crearlo.Contenido visual
search_icons, insert_icon, get_icon_svg, resolve_icon_hints.search_illustrations, get_illustration_svg.search_stock_image, upload_image, replace_asset, list_assets, delete_asset.create_chart: gráficos y diagramas calculados en el servidor.IA de diseño
generate_from_prompt, enhance_template, image_to_design, ai_suggest_layout.detect_structure, analyze_template_structure: entender un diseño ajeno.Formatos
adapt_format, adapt_all_formats, compare_adaptations.Verificación
lint_design, render_frame_png, diff_overlay.validate_brand, check_contrast, check_accessibility, auto_fix_brand (detalle en musa-marcas).Exportar y abrir
render_html_template, render_to_formats, render_batch, batch_render_html.export_pdf, export_frame, export_batch, copy_as.update_thumbnail, upload_cover_image.share_design, editor_open, presentation_open.save_version: guarda un punto del historial antes de cambios grandes.Guías de procedimiento
get_playbook({ name }): pasos detallados para create-from-scratch, replicate-html, csv-batch, design-system, multi-agent. Úsalos solo si el trabajo es de ese tipo.lint_design y una revisión visual.save_version antes.Para reproducir una referencia dejando cada parte como capa nativa (no PNG pegado). En la web están en Props › «Réplica editable» (con un frame elegido) y en la sección de cada capa; por MCP:
layer_vectorize( con engine "trace", "color_layers" o "ai" (ver «Vectorizar en Musa» abajo). Para trazar sin insertar: trace_image(.image_extract_text_layers({ templateId, frameId, layerId | imageUrl, x, y, width, height }); ascii: true para arte ASCII.text_create_ascii({ templateId, frameId, text | imageBase64 (PNG) + columns, font: "Space Mono" }).layer_apply_halftone({ templateId, frameId, layerId, cell, angle, shape, color }); remove: true la quita.import_svg_paths({ templateId, frameId, svg | url }).layer_set_mask({ templateId, frameId, layerId, shape: "circle", size, cx, cy }).text_set_path({ templateId, frameId, layerId, mode, curve }).emoji_insert_vector({ templateId, frameId, emoji, size, x, y }).layer_apply_texture({ templateId, frameId, layerId, texture, amount }).layer_split_subject({ templateId, frameId, layerId }).restore: true): image_inpaint_region({ templateId, frameId, layerId, region: { x, y, w, h } }).design_layer_report({ templateId }). Solo las fotos reales deberían quedar como «imagen (raster)».Una sola herramienta, tres motores: layer_vectorize({ templateId, frameId, layerId, engine, options }). El resultado entra como un grupo «Vector · <capa>» con capas vectoriales nativas, recoloreables una por una; la respuesta dice cuántas capas se crearon y qué quedó raster. En la web: Props de la imagen › «Vectorizar».
Antes de vectorizar, mira la referencia y decide:
1. Ilustración de colores planos (tazas, formas planas, afiches): engine: "trace" (gratis, motor propio de Musa, una capa por color con curvas).
2. Lettering o texto dibujado: si quieres cada letra como capa recoloreable, engine: "color_layers" (las letras salen como los huecos claros del manchón: «letra 1», «letra 2»…); si solo necesitas la forma completa, "trace".
3. Halftone o trama de puntos: no vectorices si puedes evitarlo; usa layer_apply_halftone( (paramétrico). Si no, "trace" funciona pero los puntos pequeños salen algo cuadrados.
4. Textura crayón o grano: "color_layers" conserva el borde moteado pero aplana el relleno a un color. Para textura de relleno usa layer_apply_texture(. No prometas textura de relleno desde una vectorización.
5. Fotos: ningún modo. Son raster por naturaleza; para aislar algo usa layer_split_subject(.
6. Degradados: "trace" con más colores los aproxima como bandas. Si el degradado es protagonista, prueba "ai" o reconstrúyelo como degradado nativo.
7. Íconos y logos simples: "trace".
8. Ilustración densa donde el trace se ve duro: engine: "ai" (Quiver con la llave del usuario). Sin confirmCost: true solo devuelve el costo estimado y no cobra: muéstralo y pide confirmación antes de pagar.
Opciones: trace → colormode (color|bw), colorPrecision, filterSpeckle, cornerThreshold, pathPrecision, hierarchical (stacked|cutout), removeBackground. color_layers → colors (hex picados) o maxColors, tolerance, simplify, lettersAsLayers, keepBackground. ai → model (arrow-1.1 | arrow-2 | arrow-2-telos).
Reglas: nunca pagues el modo "ai" sin mostrar el costo y que la persona confirme; después de vectorizar, reporta qué quedó vector y qué siguió raster (design_layer_report().
import_design_source({ templateId, sourceType: "html", content }) acepta HTML con JavaScript, Tailwind por CDN, React/JSX, GSAP, anime, animaciones CSS/WAAPI, Three.js, React Three Fiber, p5, canvas, Chart.js. Musa lo corre una vez en un espacio aislado (sin acceso a Musa) y deja: el HTML/CSS final como capas, cada animación en frame.animation (exactas las de CSS/WAAPI; las de JavaScript, leídas cuadro a cuadro y ajustadas a pocos keyframes con curva), los ::before/::after como capas reales y cada <canvas> como capa de código vivo. Por MCP (sin navegador) queda lo estático y el resto se termina al abrir el diseño en el editor: design_live_get marca esas láminas con pendingCode.posterSec): el instante de la lámina que ven el lienzo, las miniaturas, PNG/PDF/SVG, el enlace público y el correo. Sugerida = el primer instante en que se ve todo lo que entra. La persona o tú la cambian cuando quieran: set_animation({ templateId, frameId, posterSec }).set_animation({ ..., presentMode }) — enter (por defecto: se reproduce al entrar y queda en su último cuadro), click (portada y se reproduce con un clic), poster (quieta). Transición al pasar a la siguiente lámina: presentTransition = fade, smart (Smart Animate: las capas con el mismo data-layer-name en las dos láminas viajan de un lugar al otro), slide, push, zoom o none.design_live_get({ templateId, frameId?, layerId? }) lista objetos 3D, parámetros, valores y tiempos; design_live_update({ templateId, frameId, layerId, scene: { "Cubo|color": "#ff5e00", "Cubo|px": 1.2 }, values, params, addObjects, duplicateObjects, removeObjects, timing: { start, offset, speed, loop, holdSec } }) escribe en el código (lo mismo que la persona al arrastrar en el lienzo). holdSec = «cuadro propio»: la capa queda en ese segundo de su código aunque la portada de la lámina sea otra. design_live_add({ templateId, frameId, code, x, y, width, height }) agrega una capa viva nueva.render_frame_png: la captura muestra la lámina en su portada.design_from_video({ projectId, atSec, part: "scene" | "all" | "still", templateId? }) = el botón «→ Diseño» del editor de video. atSec es la portada (el cuadro que se ve quieto); scene (por defecto) lleva la escena entre cortes donde cae atSec y la lámina la reproduce al presentar. Se termina de armar al abrir el diseño en el editor; después la portada se cambia con set_animation({ posterSec }).design_code_get({ templateId, frameId }) da la lámina en Musa Design Code (HTML + CSS + capas + musa-animation con portada y presentación + capas vivas); edítalo y mándalo con design_code_apply({ templateId, frameId, code }) (si trae JavaScript o canvas, se termina al abrir el diseño). En la web es el panel «</> Código» del editor (en vivo en los dos sentidos) y «Exportar › HTML (se reproduce)».