freecad-scripts
Expert skill for writing FreeCAD Python scripts, macros, and automation. Use when asked to create FreeCAD models, parametric objects, Part/Mesh/Sketcher scripts, workbench tools, GUI dialogs with PySide, Coin3D scenegraph manipulation, or any FreeCAD Python API task. Covers FreeCAD scripting basics, geometry creation, FeaturePython objects, interface tools, and macro development.
Profile →npx skills add github/awesome-copilot --skill freecad-scripts --agent copilot
Same command for any agent — swap --agent for claude-code, codex, cursor.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
What it does
Generates Python scripts for FreeCAD to automate modeling tasks, including creating and manipulating 3D geometry (Part, Mesh, Sketcher, Path, FEM), building parametric FeaturePython objects, GUI tools (PySide/Qt), Coin3D scenegraph manipulation, workbench commands, and macro automation.
How it works
Interprets shorthand, quasi-code, and natural-language descriptions of 3D modeling tasks and translates them into FreeCAD Python API calls. It covers:
- Script and macro generation for FreeCAD's console or macro system.
- Geometry creation and manipulation across Part, Mesh, Sketcher, Path, FEM.
- Creation of parametric FeaturePython objects with custom properties and recomputation hooks.
- GUI tool development using PySide/Qt (dialogs, task panels, commands).
- Scenegraph operations via Pivy, custom workbenches, and Gui Commands.
- FEM analyses, raytracing, and drawing exports scripting.
It assumes a FreeCAD environment with core modules (FreeCAD, FreeCADGui when GUI is available, Part, Mesh, Sketcher, Draft, Arch, Path, FEM, TechDraw, BOPTools, CompoundTools).
When to use it
- When writing Python scripts for FreeCAD's console or macro system.
- When creating or manipulating 3D geometry across various workbenches.
- When developing parametric objects with custom properties.
- When building GUI tools within FreeCAD.
- When automating repetitive CAD tasks with macros.
- When converting between mesh and solid representations or scripting analyses and exports.
What it can touch
The skill references the following modules and environments that scripts may import and interact with: FreeCAD, FreeCADGui, Part, Mesh, Sketcher, Draft, Arch, Path, FEM, TechDraw, BOPTools, CompoundTools. It also includes examples of GUI components (PySide2) and Coin3D (Pivy) usage for scenegraph manipulation. Specific code blocks show how to create documents, objects, and shapes, as well as how to perform common operations like recompute and object access.
Caveats
- Requires FreeCAD 0.19+ (0.21+/1.0+ for latest API) and Python 3.x.
- GUI features depend on FreeCADGui and PySide2 being available.
- The skill provides code patterns and examples but may expect adaptation to specific tasks and environments.
# FreeCAD Scripts Expert skill for generating production-quality Python scripts for the FreeCAD CAD application. Interprets shorthand, quasi-code, and natural language descriptions of 3D modeling tasks and translates them into correct FreeCAD Python API calls. ## When to Use This Skill - Writing Python scripts for FreeCAD's built-in console or macro system - Creating or manipulating 3D geometry (Part, Mesh, Sketcher, Path, FEM) - Building parametric FeaturePython objects with custom properties - Developing GUI tools using PySide/Qt within FreeCAD - Manipulating the Coin3D scenegraph via Pivy - Creating custom workbenches or Gui Commands - Automating repetitive CAD operations with macros - Converting between mesh and solid representations - Scripting FEM analyses, raytracing, or drawing exports ## Prerequisites - FreeCAD installed (0.19+ recommended; 0.21+/1.0+ for latest API) - Python 3.x (bundled with FreeCAD) - For GUI work: PySide2 (bundled with FreeCAD) - For scenegraph: Pivy (bundled with FreeCAD) ## FreeCAD Python Environment FreeCAD embeds a Python interpreter. Scripts run in an environment where these key modules are available: ```python import FreeCAD # Core module (also a
- When to Use This Skill
- Prerequisites
- FreeCAD Python Environment
- The FreeCAD Document Model
- Core Concepts
- Vectors and Placements
- Creating and Manipulating Geometry (Part Module)
- Topological Exploration
- Mesh Module
- Sketcher Module
- Compensation Rules (Quasi-Coder Integration)
- References
- Primary Links
- Bundled Reference Documents
What does the freecad-scripts skill do?
Expert skill for writing FreeCAD Python scripts, macros, and automation. Use when asked to create FreeCAD models, parametric objects, Part/Mesh/Sketcher scripts, workbench tools, GUI dialogs with PySide, Coin3D scenegraph manipulation, or any FreeCAD Python API task. Covers FreeCAD scripting basics, geometry creation, FeaturePython objects, interface tools, and macro development.
How do I install it?
Run `npx skills add github/awesome-copilot --skill freecad-scripts --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From github/awesome-copilot, a repository with 37,432 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.