stl-generator-toolkit
Comprehensive toolkit for generating 3D printable STL files for woodworking jigs and fixtures using CadQuery, with pre-built scripts and parametric design patterns
View on GitHubTable of content
Comprehensive toolkit for generating 3D printable STL files for woodworking jigs and fixtures using CadQuery, with pre-built scripts and parametric design patterns
Installation
npx claude-plugins install @ihistand/ihistand/stl-generator-toolkit
Contents
Folders: commands, references, scripts, skills
Files: README.md
Documentation
Comprehensive toolkit for generating 3D printable STL files for woodworking jigs and fixtures using CadQuery. Optimized for Elegoo Neptune 4 Pro with engineering best practices and pre-built parametric scripts.
What’s Included
Skills
stl-generator - Complete guide for 3D printable woodworking jig design that includes:
- Pre-built scripts for common jigs (circle cutting, angle wedges, spacing blocks)
- CadQuery parametric design patterns
- Printer-specific constraints (Elegoo Neptune 4 Pro: 225×225×265mm)
- Structural integrity and printability best practices
- Hardware integration guidelines
- Reference files for design patterns and printer specifications
Slash Commands
/stl-generate - Generate custom STL files for any woodworking jig:
- Ask user for requirements and dimensions
- Use pre-built scripts when applicable
- Write custom CadQuery code for unique designs
- Export and provide download links
/stl-circle-jig - Quick generation of circle cutting jigs:
- Router jigs for perfect circles
- Ideal for lampshade rings and circular frames
- Adjustable inner/outer diameters
/stl-angle-wedge - Generate angle guide wedges:
- Compound miter cuts and angled assembly
- Any angle from 1-60 degrees
- Embossed angle labels for easy identification
/stl-spacing-block - Create precision spacing blocks:
- Single blocks or matched sets
- Embossed dimension labels
- Finger relief cutouts for easy handling
Installation
Option 1: Install from GitHub
# Add marketplace
/plugin marketplace add ihistand/claude-plugins
# Or use the full GitHub URL
/plugin marketplace add https://github.com/ihistand/claude-plugins
# Install plugin
/plugin install stl-generator-toolkit@ihistand
Then restart Claude Code.
Option 2: Install from Local Directory
For development or offline use:
# Add marketplace locally
/plugin marketplace add /path/to/claude-plugins
# Install plugin
/plugin install stl-generator-toolkit@dev
Then restart Claude Code.
Usage Examples
Generate a Circle Cutting Jig
User: I need a jig for cutting a 300mm diameter lampshade ring with 250mm inner diameter
Claude: /stl-circle-jig
[Generates jig with specified dimensions]
Create an Angle Wedge
User: I need a 22.5 degree angle guide for octagon assembly
Claude: /stl-angle-wedge
[Generates wedge with embossed angle marking]
Generate Spacing Blocks
User: I need spacing blocks for 5mm, 10mm, and 15mm gaps
Claude: /stl-spacing-block
[Generates set of three labeled spacing blocks]
Custom Jig Design
User: I need a custom router template for mortising
Claude: /stl-generate
[Gathers requirements and writes custom CadQuery code]
Target Printer Specifications
- Printer: Elegoo Neptune 4 Pro
- Build Volume: 225mm × 225mm × 265mm
- Layer Height: 0.2mm standard
- Units: Metric (millimeters)
All designs are optimized for this printer’s capabilities and constraints.
Pre-Built Scripts
The plugin includes three production-ready Python scripts:
| Script | Purpose | Parameters |
|---|---|---|
circle_cutting_jig.py | Router jigs for perfect circles | outer_diameter, inner_diameter |
angle_wedge.py | Angle guide wedges | angle_degrees (1-60°) |
spacing_block.py | Precision spacing blocks | height (single) or set of heights |
Location: stl-generator-toolkit/scripts/
Design Best Practices
Structural Integrity
- Wall thickness: 3-4 perimeter walls for strength
- Base thickness: Minimum 5mm for flatness
- Chamfers/fillets: 1-2mm to reduce stress concentrations
- Layer orientation: Perpendicular to primary load direction
Printability
- Overhangs: Keep under 45° to avoid supports
- Bridges: Avoid unsupported spans over 30mm
- Orientation: Largest flat surface on print bed
- Draft angles: 0.2mm for nesting parts
Woodworking Functionality
- Reference surfaces: Smooth, no text on work contact areas
- Alignment marks: Visual indicators (notches, text, contrasting surfaces)
- Finger reliefs: Easy handling for small parts
- Clamping access: 25mm+ clearance
Hardware Integration
Common hole sizes (add 0.3-0.5mm clearance):
- M3: 3.3mm hole
- M4: 4.3mm hole
- M5: 5.3mm hole
- #8 wood screw: 4.5mm hole
- 1/4"-20 bolt: 6.6mm hole
CadQuery Quick Reference
Basic structure:
import cadquery as cq
# Create base
part = cq.Workplane("XY").box(50, 30, 10)
# Add features
part = (
part.faces(">Z")
.workplane()
.circle(5)
.cutThruAll()
)
# Export
cq.exporters.export(part, "output.stl")
Essential methods:
.box(w, d, h)- rectangular solid.circle(r)- circle sketch.extrude(height)- extrude 2D to 3D.cutThruAll()- cut through entire part.fillet(radius)- round edges.chamfer(distance)- bevel edges
For detailed patterns, see references/cadquery_patterns.md.
…(truncated)
Included Skills
This plugin includes 1 skill definition:
stl-generator
Generate 3D printable STL files for woodworking jigs and fixtures using CadQuery. Use when the user requests lampshade jigs, circle cutting guides, angle wedges, spacing blocks, alignment fixtures, router jigs, or any custom 3D-printed woodworking aid. Optimized for Elegoo Neptune 4 Pro (225x225x265mm build volume, 0.2mm layer height). Always use metric measurements.
View skill definition
STL Generator for Woodworking Jigs
Generate parametric 3D printable jigs and fixtures for woodworking projects using CadQuery.
Target Printer Specifications
- Printer: Elegoo Neptune 4 Pro
- Build volume: 225mm × 225mm × 265mm
- Layer height: 0.2mm standard
- Units: Metric (millimeters)
For complete specifications and design constraints, read references/printer_specs.md.
Available Pre-Built Scripts
1. Circle Cutting Jig (scripts/circle_cutting_jig.py)
Creates router jigs for cutting perfect circles - ideal for lampshade rings and circular frames.
Usage:
python scripts/circle_cutting_jig.py <outer_diameter> <inner_diameter> [output.stl]
Example:
python scripts/circle_cutting_jig.py 300 250 lampshade_jig.stl
Features:
- Adjustable inner/outer diameters
- Built-in guide ring for router stability
- Center pivot hole for compass-style cutting
- Radial slot for router bit clearance
- Alignment marks every 45°
2. Angle Wedge (scripts/angle_wedge.py)
Creates angle guide wedges for compound cuts and angled assembly work.
Usage:
python scripts/angle_wedge.py <angle_degrees> [output.stl]
Example:
python scripts/angle_wedge.py 15 wedge_15deg.stl
Features:
- Any angle from 1-60 degrees
- Raised reference edge on hypotenuse
- Embossed angle label
- Stable base for accurate positioning
3. Spacing Blocks (scripts/spacing_block.py)
Creates precision spacing bl
…(truncated)