CommunityProgramación y desarrollogithub.com

3d-builder

Creación y edición de modelos 3D basada en especificaciones en Blender o FreeCAD. Mantiene todo organizado en modelos/<nombre>/, escribe un archivo de especificación, hace preguntas aclaratorias una por una, registra cada decisión y suposición, dibuja planos SVG por planta para aprobación en edificios, y construye el modelo a través de un servidor MCP o un script Python generado.

¿Qué es 3d-builder?

Este skill permite a un agente de IA crear y modificar modelos 3D siguiendo un flujo de trabajo estructurado de cuatro fases: especificación, preguntas aclaratorias, planos de planta (solo edificios) y modelado. Está diseñado para evitar errores comunes al modelar sin claridad previa, asegurando que cada decisión geométrica esté documentada y validada con el usuario antes de construir. Soporta Blender y FreeCAD a través de servidores MCP (preferido) o scripts Python generados automáticamente como respaldo. Es útil para diseñar piezas funcionales, objetos decorativos, activos para juegos/web (exporta .glb/.fbx) y edificios con planos por planta. El skill gestiona todo el ciclo de vida del modelo: desde la creación de la carpeta del proyecto, la redacción de la especificación a partir de la solicitud del usuario, la realización de preguntas una por una para resolver ambigüedades (con reglas para optimizar la interacción), la generación y aprobación de planos SVG para edificios, y finalmente la construcción del modelo en sí. El resultado se guarda en el formato nativo (.blend/.FCStd) y, si es necesario, se exporta a formatos compatibles con motores como glTF o FBX. Además, el skill verifica el modelo final contra la especificación, actualiza el estado y presenta un resumen al usuario.

Compatible con~Claude Code~Codex CLI~Cursor
Part ofMobile
npx skills add https://github.com/thanikc/3d-builder/tree/HEAD/skills/3d-builder

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace 3d-builder?

No adivines un modelo 3D. Escribe lo que se va a construir, aclara lo ambiguo con el usuario, registra cada suposición, y solo entonces modela. Un modelo construido con dimensiones supuestas se corrige una y otra vez; una especificación atrapa las suposiciones antes de que se conviertan en geometría.

El flujo de trabajo tiene estas fases, siempre en este orden: especificación → preguntas → planos de planta (solo edificios) → modelo. No abras Blender o FreeCAD, y no escribas código de modelado, antes de que exista la especificación y las preguntas estén hechas. Para un edificio, el usuario también debe haber aprobado primero los planos de planta.

Estructura del proyecto

Un proyecto puede contener varios modelos, por lo que todo lo que pertenece a un modelo vive en su propia carpeta:

models/
  <nombre>/
    specs/
      <aaaa-mm-dd-hhmmss>-<solicitud>.md   # una especificación por solicitud
    plans/                               # solo edificios
      layout.json
      floor-<id>.svg
    <nombre>.blend | <nombre>.FCStd      # el modelo
    <nombre>.py                          # solo script de respaldo
    <nombre>.glb | <nombre>.fbx          # solo exportaciones para juegos/web
.3d-builder.json                         # elección de herramienta recordada, para todo el proyecto

<nombre> es un nombre corto en kebab-case para el objeto (soporte-telefono, montaje-muro-router). Nombra la carpeta y los archivos del modelo. Todas las rutas a continuación son relativas a models/<nombre>/ a menos que se indique lo contrario.

Proyectos antiguos pueden usar aún la estructura plana anterior (specs/ y plans/ en la raíz del proyecto, models/<nombre>.blend). Si encuentras uno, trabaja con él tal cual y ofrece una vez mover los archivos a esta estructura. No muevas nada sin preguntar.

Fase 1: Escribir la especificación

  1. Elige el <nombre> del modelo. Para un modelo nuevo, verifica que models/<nombre>/ no exista aún, luego créalo junto con su carpeta specs/.
  2. Obtén la marca de tiempo del reloj del sistema (ej. date +%Y-%m-%d-%H%M%S) en lugar de inventarla.
  3. Crea specs/<aaaa-mm-dd-hhmmss>-<solicitud>.md usando la plantilla en references/spec-template.md. <solicitud> es una etiqueta corta en kebab-case para esta solicitud: inicial para un modelo nuevo, o el cambio para una edición (gancho-mas-grueso, mover-cocina-este).

Rellena lo que la solicitud ya indica, luego lista los puntos abiertos: todo lo que afecta la geometría pero no fue especificado. Puntos abiertos típicos:

  • Dimensiones generales y unidades, y qué dimensiones son fijas vs. libres
  • Ajuste y holgura con objetos reales (un teléfono de 60 mm necesita una ranura ligeramente más ancha que 60 mm; ¿cuánto?)
  • Grosor de pared, redondeos/chaflanes, tamaños de agujeros, tipos de tornillos
  • Método de montaje, orientación, carga
  • Propósito y fabricación (impresión 3D → voladizos, paredes mínimas, base plana; CNC; solo render; activo para juego/web)
  • Para activos de juego/web: motor objetivo, presupuesto de polígonos, escala en unidades del motor, posición del pivote, UVs y texturas vs. colores planos, LODs, malla de colisión
  • Nivel de detalle, materiales (Blender), necesidades paramétricas (FreeCAD)
  • Para edificios: plantas, huella, habitaciones y sus tamaños, escaleras, puertas y ventanas. Estos se resuelven en la Fase 3 con los planos de planta, así que enuméralos allí y no aquí

Editando un modelo existente: primero encuentra la carpeta del objeto en models/. Escribe una nueva especificación para el cambio (cada solicitud tiene su propio archivo, para que el historial sea legible), enlázala a la especificación anterior e indica qué cambia y qué debe permanecer igual. Lee el modelo existente (a través de MCP, o el script que lo construyó) antes de editar, para que la edición comience desde lo que realmente hay. Para un edificio con una carpeta plans/, un cambio de diseño pasa primero por los planos (Fase 3, "Editando un edificio").

Fase 2: Preguntas aclaratorias

Si la solicitud deja puntos abiertos, pregúntalos antes de modelar. El usuario sabe cosas que no puedes inferir (el ancho real del teléfono, dónde van los tornillos de pared), y una pregunta ahora ahorra una reconstrucción después.

Reglas:

  • Una pregunta a la vez. Espera la respuesta antes de hacer la siguiente. Ordena las preguntas por cuánto afectan la geometría: tamaño general y propósito primero, detalles cosméticos al final.
  • Sí/no cuando sea posible. "¿La ranura del cable debe estar centrada?" es mejor que "¿Dónde debe estar la ranura del cable?".
  • De lo contrario, opción múltiple: la opción recomendada primero y marcada "(recomendada)", luego las alternativas, y una respuesta de texto libre al final. Usa la herramienta de preguntas del agente (ej. AskUserQuestion) si la tiene; normalmente añade la opción de texto libre por ti.
  • Lotes de 5. Después de cada 5 preguntas, pregunta si continuar con hasta 5 más, indicando aproximadamente cuántos puntos abiertos quedan. Si el usuario dice que no, deja de preguntar.
  • No preguntes sobre cosas que no importan para este modelo, y no preguntes lo que el usuario ya dijo.
  • Registra cada respuesta en la sección Decisiones de la especificación de inmediato, para que la especificación esté siempre actualizada.

Detente cuando no quede nada importante sin aclarar, o cuando el usuario deje de responder. Por cada punto abierto que quede, decide tú mismo, eligiendo el valor predeterminado sensato para el propósito indicado, y escríbelo en Suposiciones con una razón de una línea. El usuario debería poder leer la especificación y ver cada elección hecha en su nombre.

Si la solicitud ya está completamente especificada, omite las preguntas y dilo en una línea.

Fase 3: Planos de planta (solo edificios)

Si el modelo es un edificio o tiene habitaciones, resuelve la distribución en papel antes de modelar. Lee references/floorplans.md y síguelo:

  1. Discute el plano de planta con el usuario, usando las reglas de preguntas anteriores: plantas, huella, habitaciones, adyacencia, escaleras, puertas y ventanas.
  2. Dibuja un plano vectorial para cada planta. Escribe plans/layout.json y genera plans/floor-<id>.svg con el script incluido scripts/draw_plans.py.
  3. Revisa los planos con el usuario y revísalos hasta que el usuario los apruebe. Registra la aprobación en Decisiones.

El layout.json aprobado es la fuente de verdad para las paredes, aberturas, habitaciones y escaleras del modelo. Omite esta fase para cualquier cosa que no sea un edificio.

Fase 4: Modelo

Guarda el resultado en <nombre>.blend (Blender) o <nombre>.FCStd (FreeCAD) en la carpeta del modelo. Para un activo de juego o web, también expórtalo junto al archivo fuente (ver Exportar para motores).

Elegir la herramienta

Verifica qué servidores MCP están configurados: mira tus herramientas disponibles para herramientas MCP de Blender o FreeCAD (los nombres suelen contener blender o freecad).

  1. Elección recordada: si .3d-builder.json existe en la raíz del proyecto, usa su "tool" ("blender" o "freecad") a menos que el usuario pida otra cosa.
  2. Exactamente un servidor MCP configurado: usa esa herramienta.
  3. Ambos o ninguno configurado: pregunta al usuario qué herramienta usar (una pregunta de opción múltiple). Recomienda FreeCAD para piezas funcionales con dimensiones precisas (soportes, carcasas, cualquier cosa impresa o mecanizada), y Blender para formas orgánicas, objetos esculpidos o decorativos, cualquier cosa destinada a renderizado, y activos para juegos o web (las mallas teseladas de FreeCAD son poco adecuadas para uso en tiempo real).
  4. Recuerda la elección escribiendo {"tool": "blender"} o {"tool": "freecad"} en .3d-builder.json. Registra la herramienta también en la especificación.

Construir mediante MCP (preferido)

  1. Haz una llamada barata primero (ej. obtener información de la escena/documento). Si da error o no responde en 10 segundos, trata el servidor como no disponible y cambia al script de respaldo. Informa al usuario el motivo en una línea.
  2. Construye el modelo paso a paso a partir de la especificación. Verifica las dimensiones mientras avanzas (consulta cuadros delimitadores o propiedades de objetos) en lugar de confiar en que el código hizo lo que querías.
  3. Guarda en la ruta anterior.

Script de respaldo

Cuando no haya un servidor MCP utilizable, escribe un script Python independiente, <nombre>.py en la carpeta del modelo, que construya el modelo desde cero y guarde <nombre>.blend o <nombre>.FCStd junto a sí mismo. Pon las dimensiones clave como constantes con nombre al principio para que el usuario pueda ajustarlas. Para un edificio, el script lee plans/layout.json y no copia las coordenadas en el código (ver references/floorplans.md, "Construir el modelo a partir del layout").

Luego intenta ejecutarlo sin interfaz gráfica, si la herramienta está instalada:

  • Blender: blender --background --python models/<nombre>/<nombre>.py
  • FreeCAD: freecadcmd models/<nombre>/<nombre>.py (en algunos sistemas FreeCADCmd o freecad.cmd)

Si se ejecuta, verifica la salida (archivo existe, cuadro delimitador impreso coincide con la especificación). Si falla, corrige el script y vuelve a ejecutarlo. Si la herramienta no está en el PATH, indícale al usuario el comando exacto para ejecutar.

Errores típicos y esqueletos de scripts específicos de la herramienta: references/blender.md, references/freecad.md. Lee el correspondiente a la herramienta elegida antes de escribir código.

Exportar para motores

Solo para activos de juego o web. Conserva el .blend como fuente editable y exporta junto a él:

DestinoFormatoArchivo
Web (three.js, Babylon.js), Godot, uso generalglTF binario<nombre>.glb
Unity, UnrealFBX (o .glb si el pipeline del usuario importa glTF)<nombre>.fbx

Los motores son en tiempo real, por lo que el activo debe respetar el presupuesto de la especificación: verifica el recuento de triángulos, aplica transformaciones, coloca el pivote donde dice la especificación, y coincide con la escala y ejes del motor. Configuración de exportación y errores comunes: la sección "Activos para juegos y web" en references/blender.md.

Este skill entrega el archivo del activo. Cargarlo en una escena, escribir scripts de motor o construir una página three.js está fuera de su alcance; si el usuario también quiere eso, hazlo como un paso separado después de que este flujo de trabajo haya terminado.

Finalizar

  1. Verifica el modelo contra la especificación: dimensiones generales, cada característica listada presente, y cualquier requisito de ajuste u holgura. Para activos de juego/web, también el recuento de triángulos contra el presupuesto y el cuadro delimitador del archivo exportado en unidades del motor. Para edificios, también verifica contra los planos aprobados: dimensiones generales, posiciones de paredes, cada puerta y ventana, y niveles de planta.
  2. Actualiza la especificación: establece Estado en hecho, completa Salida (rutas de archivo incluyendo exportaciones y planos, herramienta, MCP o script), y nota cualquier cosa que resultó diferente del plan.
  3. Informa al usuario brevemente: qué se construyó, dónde están los archivos, y las principales suposiciones que quizás quiera revisar (señala la especificación para el resto).

Si el usuario solicita cambios después de eso, trátalos como una nueva solicitud de edición (Fase 1, "Editando un modelo existente"). Seguimientos pequeños en la misma conversación ("un poco más grueso") pueden ir en la misma especificación bajo Revisiones.

Skills relacionados