use-openscad

Writes OpenSCAD code and compiles parametric models to STL, 3MF, DXF, SVG, and PNG outputs.

588|49|Updated Aug 4, 2025
One-click install
npx skills add https://github.com/FradSer/dotclaude --skill use-openscad
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: use-openscad
Source: https://github.com/FradSer/dotclaude/tree/main/hardware/skills/use-openscad
Command: npx skills add https://github.com/FradSer/dotclaude --skill use-openscad

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Designing 3D-printable parts or laser-cut plates normally requires manual CAD work; this Skill lets you describe a part in natural language and get fabrication-ready files by generating OpenSCAD code and driving the openscad CLI compiler.

Core Features & Use Cases

  • Parametric CAD generation: Authors .scad models with tunable dimensions exposed via -D command-line variables for batch variant rendering.
  • Multi-format export: Produces STL/3MF/AMF meshes for 3D printing, DXF/SVG for laser cutting, and PNG previews with camera control.
  • Mesh validation: Scans compiler stderr for manifold, self-intersection, and degenerate-geometry warnings after every mesh export.
  • Use Case: Ask for a parametric enclosure box with specific dimensions and bolt holes, and receive a validated binary STL plus a preview PNG, with the option to batch-render size variants.

Quick Start

Ask the assistant to design a 3D-printable parametric box with OpenSCAD and export it as a binary STL file.

Frequently Asked Questions about use-openscad

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

FAQPage Schema
How do I export an STL file from OpenSCAD on the command line?

Run openscad with -o out.stl and pass --export-format binstl for binary STL output. Mesh exports always perform full CGAL geometry evaluation, so --render is not needed; scan stderr afterward for manifold warnings.

How do I make an OpenSCAD model parametric from the command line?

Declare tunable variables at the top level of the .scad file, then override them with repeatable -D var=val flags. String values need shell quoting like -D 'mode="parts"', while numeric values need no quotes.

Where is the OpenSCAD binary located on macOS?

The macOS binary is not on PATH; it lives at /Applications/OpenSCAD.app/Contents/MacOS/OpenSCAD. On Linux try openscad or openscad-nightly, on Windows invoke openscad.com, and on servers use a Docker image.

Does OpenSCAD need --render to export STL or 3MF files?

No, --render only affects PNG image export. Mesh exports to STL, 3MF, AMF, DXF, and SVG always get full CGAL geometry evaluation, so a plain openscad -o out.stl model.scad produces a complete mesh.

Why does my exported OpenSCAD mesh fail in a slicer?

OpenSCAD prints manifold, self-intersection, and degenerate-geometry problems to stderr even when the exit code is zero. Capture output with 2>&1 and grep for these warnings, or run with --hardwarnings so any warning causes a non-zero exit.

Can OpenSCAD run headless on a server without a display?

Yes, modern OpenSCAD (2024+) renders PNG headlessly on Linux via EGL without Xvfb; older versions need xvfb-run. For remote servers, the recommended approach is building the openscad-cli Docker image and running it as a container.