← Back to Skills Marketplace
449
Downloads
2
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install skill-freecad
Description
Create or modify 3D CAD models in FreeCAD using parametric JSON operations.
Usage Guidance
This skill appears to do what it claims: it runs a packaged Python engine that uses your local FreeCAD installation to create and export CAD models. Before installing or running:
- Ensure FreeCAD is installed on the host; the script will try to auto-locate it and can also use FREECAD_PATH if you set it.
- Do NOT set FREECAD_PATH to an untrusted directory — the skill imports FreeCAD modules from that path, and a malicious path could execute arbitrary Python code during import.
- The skill saves files (model.FCStd, model.step, and any export filename you request) into the working directory; confirm that writing these files is acceptable.
- There are no declared network calls or secret-collection behaviors, but the code runs local Python imports and file I/O, so run it in an environment you control (or sandbox) if you have concerns.
- Optional: review the FreeCAD installation and the working directory permissions before use. Overall the package is internally consistent with its stated purpose, though it assumes a correctly installed FreeCAD runtime.
Capability Analysis
Type: OpenClaw Skill
Name: skill-freecad
Version: 1.0.1
The FreeCAD skill provides a structured and safe interface for 3D modeling using parametric JSON operations. The implementation in `scripts/cad_engine.py` and its supporting modules (e.g., `scripts/ops/export.py` and `scripts/ops/utils.py`) includes path traversal protections by using `os.path.basename` on user-provided filenames. The skill instructions in `SKILL.md` enforce the use of structured JSON and discourage the agent from generating raw Python code, which reduces the risk of execution errors or injection. No evidence of data exfiltration, unauthorized network access, or malicious persistence was found.
Capability Assessment
Purpose & Capability
The name/description (parametric FreeCAD operations) aligns with the included scripts: primitives, booleans, transforms, arrays, profiles, export and document management. The only external dependency is the FreeCAD Python libraries, which the code tries to locate. No unrelated binaries or credentials are requested.
Instruction Scope
SKILL.md instructs the agent to produce structured JSON and call the packaged engine (python scripts/cad_engine.py), then read JSON from stdout. The skill writes model.FCStd and model.step and returns object metadata; these outputs are declared. The runtime code also references an optional FREECAD_PATH and standard OS program folders to find FreeCAD — this is reasonable for locating the FreeCAD runtime but is not documented in SKILL.md.
Install Mechanism
There is no external installer or network download; code is bundled with the skill and executed via the system python. No archives or remote URLs are fetched, which keeps install risk low.
Credentials
The skill declares no required env vars, but the code optionally reads FREECAD_PATH and uses standard ProgramFiles/ProgramW6432/ProgramFiles(x86) locations to find FreeCAD. This is proportionate to the purpose (locating the FreeCAD installation). Be aware that FREECAD_PATH (if set) points the interpreter at a directory whose contents will be imported — setting it to an untrusted path could cause arbitrary code execution during import.
Persistence & Privilege
The skill does not request always:true, does not modify other skills or system-wide agent settings, and only reads/writes files in the working directory (model.FCStd, exported files). It does not request elevated privileges or credentials.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install skill-freecad - After installation, invoke the skill by name or use
/skill-freecad - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Fix "suspicious patterns detected" by OpenClaw:
- Added Dependencies: Added formal metadata.openclaw frontmatter declaring the python runtime requirement.
- Auto-Discovery: Implemented a dynamic path-injector in the engine. Standard python will now automatically hunt for and bind to local FreeCAD installations (Windows/Mac/Linux) without crashing.
- Security (Sandboxing): Enforced os.path.basename() on all file export operations to prevent path traversal attacks. The skill can no longer write files outside of its active workspace directory.
- Clarified Scope: Updated the description to explicitly clarify the use of parametric JSON operations.
v1.0.0
Introducing the FreeCAD Engine for OpenClaw! A fully autonomous, two-way bridge allowing LLM agents to procedurally generate and modify 3D mechanical designs without writing raw Python scripts.
Features:
- Structured Generative Architecture: Create and modify complex 3D CAD models entirely through atomic JSON payloads passed to a persistent headless engine.
- Complete CSG Modeling: Native support for 3D primitives (box, cylinder, sphere, cone, torus) and 2D-to-3D sketching (extrude/revolve polyline profiles).
- Advanced Modifiers & Arrays: Easily apply fillets, chamfers, or duplicate objects across linear and polar array patterns.
- Intelligent Boolean Batching: Orchestrate massive, multi-step CAD assemblies (fuse, cut, common) in a single workflow execution using the batch operation.
- Two-Way Intelligence (Inspect): The engine intercepts standard FreeCAD output and responds exclusively in JSON, granting the AI "vision" into the document state (bounding box dimensions, volume, and object layers) so it can perfectly align subsequent parts.
- Automated Exporter: Operates against a single persistent model.FCStd file and supports exporting geometry natively to .step, .stl, and .brep.
Requirements:
- FreeCAD installed on the host machine.
- A python environment containing the FreeCAD library bindings (the environment must be able to run import FreeCAD).
(Developer Note: Do not let the agent write messy FreeCAD scripts! Strictly map thoughts into the JSON schema and let cad_engine.py handle the topological Heavy-Lifting).
Metadata
Frequently Asked Questions
What is FreeCAD?
Create or modify 3D CAD models in FreeCAD using parametric JSON operations. It is an AI Agent Skill for Claude Code / OpenClaw, with 449 downloads so far.
How do I install FreeCAD?
Run "/install skill-freecad" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is FreeCAD free?
Yes, FreeCAD is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does FreeCAD support?
FreeCAD is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created FreeCAD?
It is built and maintained by Luc (@ninja7v); the current version is v1.0.1.
More Skills