How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/brentvatne/design-3d-prints --skill 3d-print-designBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
3D Print Design Skill
Gather requirements and create formal specifications for 3D printable objects before implementation.
📋 Use this skill first, then hand off tocadquery(preferred) oropenscadfor implementation.
Design Process Overview
┌──────────────────────────────────────────────────────────────────────────────┐
│ 1. REQUIREMENTS → 2. SPECIFICATION → 3. TEST PLAN → 4. IMPLEMENT │
│ (this skill) (this skill) (this skill) (cadquery) │
└──────────────────────────────────────────────────────────────────────────────┘Do not skip phases. Each phase must be completed and approved before proceeding.
Phase 1: Requirements Gathering (MANDATORY)
Before ANY design work, use the AskUserQuestion tool to gather requirements. Ask too many questions rather than making assumptions.
⚠️ DO NOT SKIP ROUNDS. Each round covers essential aspects of the design: - Rounds 1-2: Structure type and device fit - Round 3: Support configuration - Round 4: Construction (wall thickness AND corner style) ← Often skipped, causes poor edge finishing - Round 5: Printer constraints Skipping Round 4 leads to models with sharp edges that are uncomfortable to handle.
How to Prompt
Use AskUserQuestion with 2-4 focused questions per round. Group related questions together. Continue until all requirements are gathered.
For Stands/Holders/Cradles
Round 1 - Device & Orientation:
Question: "What device is this stand for?"
Options: [User describes device] → Follow up to get exact W × D × H dimensions
Question: "Should the device be tilted?"
Options: ["Flat (0°)", "Slight tilt (5-10°)", "Ergonomic tilt (12-15°)", "Steep (20°+)"]Round 2 - Stand Architecture:
Question: "What type of stand structure?"
Options: [
"Tray/Enclosure - box with hollow interior, device sits on top (Recommended for storage underneath)",
"Open Frame - legs or rails with device resting on shelves (lighter, device visible)",
"Platform - solid base slab with lip around edges (simple, heavy)"
]
→ If "Open Frame", proceed to leg style question below
→ If "Tray/Enclosure", skip to Round 3
→ If "Platform", skip to Round 4Round 2b - Leg Style (Open Frame only):
Visualize options with ASCII diagrams:
SIDE RAILS / SLED BASE CORNER POSTS
───────────────────────── ─────────────────────────
┌─────────────┐ ┌─────────────┐
│ device │ │ device │
────┴─────────────┴──── ────┴──┐ ┌──┴────
│▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│ │▓▓│ │▓▓│
│▓▓▓ LEFT RAIL ▓▓▓│ │▓▓│ │▓▓│
════════════════════════ ════════════════════════
(continuous runners (4 discrete posts,
along each side) minimal material)
A-FRAME / EASEL PERIMETER FRAME
───────────────────────── ─────────────────────────
╱─────────╲ ┌─────────────┐
╱│ device │╲ │ device │
╱ └─────────┘ ╲ ────┴─────────────┴────
╱▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓╲ │▓▓│ │▓▓│
╱▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓╲ │▓▓└─────────────┘▓▓│
════════════════════════ ════════════════════════
(triangular profile, (thin rectangular frame,
good for displays) modern floating look)Question: "What leg/base style for the open frame?"
Options: [
"Side Rails - two continuous runners, device spans between (Recommended for two-piece printing)",
"Corner Posts - four discrete legs at corners (minimal, device visible from all sides)",
"A-Frame - triangular easel style (good for displays, tablets)",
"Perimeter Frame - rectangular base frame with corner posts (modern, floating look)"
]
→ If "Side Rails", follow up: "Should rails include crossbars for extra rigidity?"
→ If "Corner Posts", follow up: "Post style: straight, tapered, or splayed outward?"Round 3 - Support Configuration:
Question: "How should the device be held in place?"
Options: [
"Shelf on all sides with front lip (most secure)",
"Shelf on sides, open back for cables",
"Minimal - just corners",
"Let me specify each side"
]
→ If "specify each side", ask about front/back/left/right individuallyRound 3 - Interior & Features:
Question: "Does the stand need hollow interior storage?"
Options: ["No - solid base", "Yes - for batteries/cables", "Yes - for specific items"]
→ If yes, ask what goes inside with dimensions
Question: "What openings are needed?"
Options: ["Cable hole in back", "Ventilation slots", "USB/power access", "None", "Multiple"]Round 4 - Construction:
Question: "How sturdy should this be?"
Options: [
"Light duty (3mm walls) - decorative, light devices",
"Standard (5mm walls) - most devices (Recommended)",
"Heavy duty (8mm walls) - heavy equipment"
]
Question: "Corner style?"
Options: ["Rounded (8mm) - comfortable grip", "Subtle (3-5mm)", "Sharp - industrial look"]Round 5 - Printer:
Question: "What printer will you use?"
Options: ["Bambu P2S (256mm) (Recommended)", "Bambu P1S/A1 (256mm)", "Prusa MK4 (250×210mm)", "Ender 3 (220mm)", "Other"]For Boxes/Enclosures
Round 1: What needs to fit inside? (get dimensions) Round 2: Lid type? (none, removable, hinged, sliding) Round 3: Wall thickness and mounting method? Round 4: Which sides need openings?
For Brackets/Mounts
Round 1: What's being mounted? (dimensions, weight) Round 2: Mounting surface? (wall, desk, pole) + attachment method? Round 3: Load direction? (hanging, resting, cantilevered) Round 4: Fixed or adjustable?
For Cable Management
Round 1: Cable diameter(s) and quantity? Round 2: Entry/exit configuration? Round 3: Mounting method? (adhesive, screw, clip-on)
When Users Ask for Clarification
If a user asks to clarify options or doesn't understand a choice, visualize with ASCII side-view diagrams. This is especially helpful for:
- Tilt angle options
- Slope compensation choices
- Shelf vs lip configurations
- Interior hollow space options
Example - Visualizing tilt/slope options:
OPTION 1: Add tilt on top (stand tilt + device slope)
─────────────────────────────────────────────────────
___
___/ | ← device
___/▓▓▓▓▓▓▓|
___/▓▓▓▓▓▓▓▓▓▓▓|
|▓▓▓▓▓▓ STAND ▓▓▓|
════════════════════════════════════════════ ← desk
OPTION 2: Compensate to level
─────────────────────────────
_____________________
| device (level) |
|▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓|
\▓▓▓▓▓ STAND ▓▓▓▓▓▓▓/
════════════════════════════════════════════ ← deskExample - Visualizing shelf vs lip:
SHELF (supports from below) LIP (retains from side)
───────────────────────────── ─────────────────────────
┌─────────┐ ┌─────────┐
│ device │ │ device │▌← lip
└────┬────┘ └─────────┘
▓▓▓▓▓▓▓▓▓▓▓ ← shelf ▓▓▓▓▓▓▓▓▓▓▓Include a summary table after the diagrams showing key differences between options.
Phase 2: Formal Specification (MANDATORY)
After gathering requirements, present a formal spec for user approval. DO NOT proceed to implementation until the spec is approved.
Specification Template
# [Object Name] - Design Specification
## Overview
| Field | Value |
|-------|-------|
| Object | [Name] |
| Type | Stand / Box / Bracket / Mount / Other |
| Architecture | Tray/Enclosure / Open Frame / Platform |
| File | `[filename].py` |
## Device/Contents
| Parameter | Value |
|-----------|-------|
| Model | [Device name] |
| Width | ___ mm |
| Depth | ___ mm |
| Height | ___ mm |
| Weight | ___ kg |
| Clearance | ___ mm (default: 0.5) |
## Stand Geometry (if applicable)
| Parameter | Value | Derivation |
|-----------|-------|------------|
| Tilt angle | ___° | User specified |
| Front height | ___ mm | User specified |
| Back height | ___ mm | front_height + depth × tan(tilt) |
| Stand width | ___ mm | device_width + clearance×2 + wall×2 |
| Stand depth | ___ mm | device_depth + clearance×2 + wall×2 |
## Open Frame Structure (if Architecture = Open Frame)
| Parameter | Value |
|-----------|-------|
| Leg style | Side Rails / Corner Posts / A-Frame / Perimeter Frame |
| Leg/rail thickness | ___ mm |
| Crossbars | Y/N (if side rails) |
| Post shape | Straight / Tapered / Splayed (if corner posts) |
## Side Configuration
| Side | Shelf | Lip | Shelf Width | Lip Height |
|------|-------|-----|-------------|------------|
| Front | Y/N | Y/N | ___ mm | ___ mm |
| Back | Y/N | Y/N | ___ mm | ___ mm |
| Left | Y/N | Y/N | ___ mm | ___ mm |
| Right | Y/N | Y/N | ___ mm | ___ mm |
## Interior
| Parameter | Value |
|-----------|-------|
| Hollow | Y/N |
| Shape | [Description] |
| Contents | [What goes inside, with dimensions] |
## Features
| Feature | Enabled | Specification |
|---------|---------|---------------|
| Cable hole | Y/N | ___×___mm, location, corner radius |
| Ventilation | Y/N | [Description] |
| Mounting holes | Y/N | [Description] |
| Other | Y/N | [Description] |
## Construction
| Parameter | Value |
|-----------|-------|
| Wall thickness | ___ mm |
| Floor thickness | ___ mm |
| Corner radius | ___ mm |
| Bottom chamfer | 0.5 mm (elephant foot) |
| Pocket fillet | 3 mm (stress relief) |
## Printer
| Parameter | Value |
|-----------|-------|
| Target printer | [Name] |
| Bed size | ___ × ___ × ___ mm |
| Model footprint | ___ × ___ mm |
| Fit check | ✓/✗ |After presenting the spec, ask: "Does this specification match what you want? Please review each section."
Phase 3: Validate Spec Completeness
Before implementation, verify the spec is complete:
Checklist
- [ ] All dimensions specified (no "TBD" or blanks)
- [ ] Clearances defined for moving/fitted parts
- [ ] Wall thickness appropriate for load
- [ ] Corner radii specified
- [ ] All features listed with dimensions
- [ ] Printer fit verified
- [ ] Interior contents fit verified (if hollow)
Common Spec Gaps
| Missing | Impact | Resolution |
|---|---|---|
| Clearance not specified | Parts won't fit | Ask: "How tight should the fit be?" |
| No corner radius | Sharp edges uncomfortable | Default to 3-5mm |
| Wall thickness unclear | Strength unknown | Ask about load requirements |
| Cable hole unspecified | Cables can't route | Ask about cable access |
Manufacturing Constraints
Minimum Wall Thickness
| Application | Minimum | Recommended |
|---|---|---|
| Decorative | 0.8 mm | 1.2 mm |
| Functional | 1.2 mm | 2.0 mm |
| Structural | 1.6 mm | 2.4 mm |
| Load-bearing | 2.4 mm | 3.2 mm |
Tolerances
| Fit Type | Clearance | Use Case |
|---|---|---|
| Loose | 0.4-0.6 mm | Easy insertion, rattles OK |
| Free | 0.2-0.3 mm | Smooth sliding fit |
| Close | 0.1-0.15 mm | Snug fit, slight friction |
| Press | -0.05 mm | Interference fit |
Overhang Limits
- Maximum overhang without supports: 45°
- Bridging limit: ~50mm (printer dependent)
- Minimum hole diameter: 2mm (horizontal), 1mm (vertical)
Chamfers and Fillets
| Location | Type | Size | Purpose |
|---|---|---|---|
| Bottom edges | Chamfer | 0.5 mm | Elephant foot prevention |
| Top edges | Chamfer | 0.3-0.8 mm | Chip prevention |
| Inside corners | Fillet | 2-3 mm | Stress relief |
| Outside corners | Fillet | 3-8 mm | Grip comfort, aesthetics |
Phase 4: Test Plan (MANDATORY)
Before implementation, create a test plan that will validate the final model. Include this in the spec file.
Test Plan Template
## Test Plan
### Geometry Validation (run in code)
1. Overall dimensions match spec (width, depth, height ±0.1mm)
2. Device pocket dimensions correct
3. All specified features present (shelves, lips, holes, etc.)
4. Model is watertight (valid solid)
### Fit Tests (visual/measurement)
1. Device fits in pocket with specified clearance
2. Ghost object shows correct placement
3. No interference between device and stand geometry
### Printability Tests (in slicer)
1. Each part fits on print bed
2. No unsupported overhangs > 45°
3. No bridging spans > 50mm
4. Layer orientation appropriate for load direction
### Assembly Tests (if multi-part)
1. Parts align correctly when joined
2. Snap-fits / tabs engage properly
3. Seam is flush (no step or gap)
### Functional Tests (post-print)
1. Device sits at correct angle
2. Device doesn't slide or tip
3. Cables can route as designed
4. Stand is stable on desk (doesn't rock)Test Categories by Stand Type
Tray/Enclosure stands:
- Interior hollow space dimensions
- Contents fit inside without interference
- Shelf supports device at correct height
- Cable holes accessible
Open Frame stands:
- Rails/legs provide stable support
- No flex under device weight
- Open areas don't compromise rigidity
- Joints between parts are strong
Multi-piece designs:
- Each piece prints flat without supports
- Assembly method works (snap-fit, bolts, etc.)
- Assembled stand is rigid (no wobble at seams)
Handoff to Implementation
Once spec AND test plan are approved, hand off to implementation:
✅ Spec approved + Test plan defined → Use `cadquery` skill (PREFERRED)
or `openscad` skill (if explicitly requested)The implementation skill will receive the spec and generate code with validation functions that check the test plan items.