| name | openscad-simplify |
| description | Simplify an OpenSCAD model without changing its geometry. Use when the user asks to simplify SCAD code, reduce duplication, replace local geometry code with modules from modules.scad, or make a model easier to maintain while preserving rendered output. |
OpenSCAD Simplify
Workflow
- Read the target
.scad file and modules.scad.
- Identify repeated or overly complex geometry that can be expressed more directly without changing dimensions:
- Repeated holes, ribs, pins, clips, chamfers, frames, or cutouts.
- Boolean blocks that can be grouped into named top-level modules.
- Magic offsets that duplicate existing variables.
- Look for reusable modules in
modules.scad that can replace local code.
- Preserve behavior:
- Do not change model dimensions, clearances, placement, orientation, or
test_fragment behavior unless the user asks.
- Keep all modules at top scope.
- Keep variables in
snake_case and all dimensions in millimeters.
- Apply small refactors:
- Extract top-level modules for repeated fragments.
- Replace duplicated numeric expressions with named variables.
- Use list-driven loops for repeated positions when clearer.
- Verify by running a render/export or the closest available project check and comparing the relevant preview images if they exist.
Output
Summarize what was simplified and explicitly call out that geometry was intended to remain unchanged.
