freecad

Build parametric FreeCAD macros and export verified STEP assemblies.

465|41|Updated Aug 4, 2026
One-click install
npx skills add https://github.com/autonomous-ai/openharness --skill freecad-autonomous-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: freecad
Source: https://github.com/autonomous-ai/openharness/tree/main/store/agents/freecad/skills/freecad
Command: npx skills add https://github.com/autonomous-ai/openharness --skill freecad-autonomous-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Writing FreeCAD macros that actually produce valid geometry is error-prone: scripts run in FreeCADCmd rather than system Python, exports can silently fail, and a STEP file that looks fine may contain invalid or open solids. This Skill provides a build-and-verify pipeline that runs your parametric macro headlessly, reimports the exported STEP, and confirms it contains closed, valid, positive-volume solids before delivering it. ## Core Features & Use Cases - Headless macro execution: Runs part.FCMacro through FreeCADCmd with an isolated build directory, resolving the FreeCAD binary across PATH, toolchain links, and macOS app bundles. - Geometry verification: Reimports the fresh STEP export, runs shape.check(True), and requires closed, valid solids with positive volume before accepting the output, writing a geometry.json receipt. - Multi-format export: Copies part.step plus optional part.stl (via MeshPart.meshFromShape) and part.FCStd into the workspace only after verification passes. - Use Case: Design a parametric electronics enclosure with a base and vented lid, then build it to get a verified STEP assembly ready to inspect in the CAD viewer or hand off for manufacturing review. ## Quick Start Ask the agent to build the FreeCAD part by running the build-part script, then inspect the verified part.step in the CAD viewer.

Frequently Asked Questions about freecad

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a FreeCAD macro headlessly from the command line?

Execute the macro with FreeCADCmd rather than system Python, since the script imports FreeCAD and Part modules only available inside FreeCAD's interpreter. The build script locates the binary via FREECAD_BIN, the toolchain link, PATH, or the macOS app bundle.

How do I verify a STEP file exported from FreeCAD?

Reimport the STEP with Part.Shape, call shape.check(True), and confirm the shape is valid, closed, contains solids, and has positive volume. Note that shape.check raises exceptions on errors rather than returning a success boolean.

Where is the FreeCAD command line binary on macOS?

Recent macOS packages place the CLI at FreeCAD.app/Contents/Resources/bin/freecadcmd, not necessarily Contents/MacOS/FreeCADCmd. You can also set the FREECAD_BIN environment variable to point at the executable directly.

Why does my FreeCAD build report failure even though FreeCAD exited with code zero?

FreeCAD can exit zero even after a Python exception inside the macro. The Node wrapper rejects the build if the STEP output or geometry receipt is missing, so check .harness/build.log and geometry.json for the actual error.

Does a valid STEP file mean my part is ready for 3D printing or machining?

No. STEP validity only confirms closed, valid solids with positive volume. Wall thickness, clearances, supports, tool access, strength, and material suitability must be reviewed separately for the intended manufacturing process.