Ir a la guía de uso

FreeCAD Scripts Skill.

Convierte una tarea de modelado con dimensiones en objetos de FreeCAD que se puedan inspeccionar y ajustar.

  • Diseño 3D
  • CAD
  • Python
Revisión de la fuente · FreeCAD ScriptsSKILL.md
Tarea Diseño 3D Genera • Una macro de Python para FreeCAD o un objeto paramétrico con script • Un documento con sólidos, bocetos o propiedades personalizadas con nombre • Una exportación STEP, STL, IGES u OBJ, si se solicita Antes de empezar FreeCAD con su Python incluido; el trabajo con interfaz gráfica usa además PySide incluido, y el trabajo con grafo de escena usa Pivy.
Resumen editorial · fuente revisada 2026-10-07 · no es un ejemplo generado

01 Qué hace

Crea modelos CAD paramétricos con Python

Una referencia de Python para FreeCAD que abarca objetos de documento, geometría paramétrica, bocetos, interfaz de la aplicación y flujos de exportación.

Flujo basado en la fuenteNo es una prueba de ejecución

Método de trabajo

FreeCAD Scripts guía a un agente por el entorno de Python integrado de FreeCAD en lugar de tratar un modelo CAD como una malla genérica. Cubre geometría Part basada en OpenCASCADE, operaciones con Mesh, bocetos restringidos y objetos FeaturePython cuyas propiedades reconstruyen la forma. Resulta relevante para piezas repetibles, pequeñas herramientas de modelado y automatización CAD donde las dimensiones importan.

La fuente también distingue la lógica del modelo del trabajo de interfaz de la aplicación. Los diálogos de PySide, los paneles de tareas y los elementos del grafo de escena Coin3D requieren la interfaz gráfica, mientras que el código de geometría reutilizable puede protegerse para ejecutarse sin ella. Una buena primera tarea es una única pieza parametrizada con un requisito de exportación claro; pedir un workbench completo añade mucha más responsabilidad de integración.

Entregables esperados

  • Una macro de Python para FreeCAD o un objeto paramétrico con script
  • Un documento con sólidos, bocetos o propiedades personalizadas con nombre
  • Una exportación STEP, STL, IGES u OBJ, si se solicita
Ver el brief de ejemplo

Del brief a la revisión

  1. 01
    Definir unidades y geometría

    Describe las dimensiones, la ubicación en el sistema de coordenadas y si se desea un sólido o una malla. La fuente asume milímetros para las longitudes sin unidad; las unidades de longitud indicadas explícitamente se convierten a los milímetros internos de FreeCAD.

  2. 02
    Construir el modelo del documento

    Crea objetos con nombre y la geometría o las restricciones necesarias. Usa FeaturePython cuando las propiedades editables deban guiar futuros recálculos.

  3. 03
    Recalcular y verificar

    Recalcula tras los cambios, inspecciona las propiedades de la forma y valida la exportación elegida. Protege las importaciones de la interfaz gráfica si la macro también debe ejecutarse sin ventana.

02 Cuándo usarlo

Cuándo usarlo

FreeCAD con su Python incluido; el trabajo con interfaz gráfica usa además PySide incluido, y el trabajo con grafo de escena usa Pivy.

Casos adecuados

  • Piezas ajustablesÚtil para una pieza cuya longitud, anchura u otras dimensiones de diseño deban seguir siendo propiedades explícitas y no constantes ocultas.
  • Operaciones CAD repetitivasSirve para macros de matrices, operaciones booleanas, conversión a malla y exportación de objetos seleccionados.

Límites que conviene comprobar

  • Python específico de la aplicaciónLos módulos de FreeCAD no son módulos normales de la biblioteca estándar de Python. Redactar un script fuera de FreeCAD no valida su comportamiento en ejecución.
  • La validación del modelo sigue siendo necesariaEl skill cubre la construcción de geometría, pero no certifica la fabricabilidad, la seguridad estructural ni la idoneidad para mecanizado.

Aporta estos datos

  • Brief con dimensionesIndica las dimensiones, las tolerancias relevantes para la tarea y las unidades usadas en el plano.
  • Parámetros editablesNombra los valores que deben convertirse en propiedades del documento y las relaciones que deben permanecer restringidas.
  • Ejecución y exportaciónIndica la versión de FreeCAD, si se usa con interfaz gráfica o sin ella, y el formato de archivo necesario después.

03 Decisiones importantes

Decisiones importantes

  1. Paramétrico, no estático

    FeaturePython separa las propiedades de entrada de la pieza de su forma generada, de modo que un cambio posterior de dimensión pueda provocar una reconstrucción.

  2. Separación entre geometría e interfaz

    Las protecciones de interfaz gráfica de la fuente ayudan a evitar que una macro de modelado útil dependa por accidente de una vista o un diálogo abiertos.

04 Ejemplo de brief

Prueba un brief concreto

El brief de ejemplo siguiente no se ha probado. Revisa la configuración del skill antes de usarlo.

Revisa la configuración

Mantén los archivos de referencia del skill disponibles para el agente. Revisa cómo las macros generadas modificarán el documento antes de ejecutarlas en FreeCAD.

Archivo fuente original
https://github.com/github/awesome-copilot/blob/3a685010a7afdc0dbd4c83b7fbda6c316aa516e5/skills/freecad-scripts/SKILL.md

FreeCAD con su Python incluido; el trabajo con interfaz gráfica usa además PySide incluido, y el trabajo con grafo de escena usa Pivy.

Empieza con un solo entregable

Adapta el alcance, el material de origen y las restricciones de este brief antes de ejecutar el skill.

Brief de ejemplo
Usa freecad-scripts para redactar una macro de FreeCAD para una placa de montaje rectangular con cuatro agujeros con el mismo retranqueo. Antes de construirla, pide las dimensiones de la placa, el diámetro de los agujeros y el retranqueo. Expón esos valores como propiedades editables, da nombre al objeto resultante, recalcula tras los cambios y exporta una copia STEP. Mantén el código de geometría separado de la visualización opcional en la interfaz gráfica y no afirmes que la pieza esté lista para fabricación.

Inspecciona el resultado

Comprueba el resultado real con estos criterios observables.

  • Al cambiar una dimensión declarada, se recalcula la geometría prevista.
  • Las unidades y la ubicación de los objetos coinciden con el plano suministrado.
  • El archivo exportado contiene el sólido solicitado y no un objeto vacío o parcial no deseado.

OpenDesign ofrece un espacio de trabajo de diseño local para agentes de programación. Este listado no significa que el skill esté incluido ni que se incluyan sus herramientas externas, credenciales y dependencias de software.

05 Fuente y licencia

Fuente y licencia

Esta página describe la revisión fija de la fuente enlazada abajo. El comportamiento y los requisitos originales pueden cambiar.

Propietario de la fuente
GitHub Awesome Copilot Contributors
Licencia
MIT
Versión revisada
2026-10-07 · 3a685010a7af
Resumen editorial de la fuente
Una referencia de Python para FreeCAD que abarca objetos de documento, geometría paramétrica, bocetos, interfaz de la aplicación y flujos de exportación.

Resumen original de OpenDesign, basado en la fuente enlazada. Las estrellas del repositorio son una señal de popularidad con fecha, no una medida de uso del skill ni una puntuación de calidad.

06 Preguntas antes de empezar

Preguntas antes de empezar

¿Puede crear objetos paramétricos editables?

Sí. La fuente documenta proxies FeaturePython, propiedades tipadas y un método execute que se llama durante el recálculo del documento.

¿STL produce lo mismo que STEP?

No. El flujo distingue las mallas trianguladas de los sólidos Part. Elige la representación que necesite la siguiente herramienta en lugar de tratar las exportaciones como intercambiables.

¿Pueden ejecutarse todos los ejemplos sin interfaz gráfica?

No. Los diálogos, los view providers y el trabajo con el grafo de escena dependen de la interfaz gráfica. Las macros sin interfaz deben proteger u omitir esas operaciones.

OpenDesign

Deja espacio para la siguiente iteración de diseño.

Mantén tu brief, el material de origen y tu trabajo de diseño juntos en un espacio de trabajo local. Revisa la configuración propia del skill antes de añadirlo a tu flujo de trabajo.

Archivo fuente original
https://github.com/github/awesome-copilot/blob/3a685010a7afdc0dbd4c83b7fbda6c316aa516e5/skills/freecad-scripts/SKILL.md