brentvatne/design-3d-prints

3d-print-design

Use BEFORE cadquery or openscad skills.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. 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-design

Before 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.
Original skill document

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 to cadquery (preferred) or openscad for 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 4

Round 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 individually

Round 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 ▓▓▓▓▓▓▓/
════════════════════════════════════════════  ← desk

Example - 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

markdown
# [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

MissingImpactResolution
Clearance not specifiedParts won't fitAsk: "How tight should the fit be?"
No corner radiusSharp edges uncomfortableDefault to 3-5mm
Wall thickness unclearStrength unknownAsk about load requirements
Cable hole unspecifiedCables can't routeAsk about cable access

Manufacturing Constraints

Minimum Wall Thickness

ApplicationMinimumRecommended
Decorative0.8 mm1.2 mm
Functional1.2 mm2.0 mm
Structural1.6 mm2.4 mm
Load-bearing2.4 mm3.2 mm

Tolerances

Fit TypeClearanceUse Case
Loose0.4-0.6 mmEasy insertion, rattles OK
Free0.2-0.3 mmSmooth sliding fit
Close0.1-0.15 mmSnug fit, slight friction
Press-0.05 mmInterference fit

Overhang Limits

  • Maximum overhang without supports: 45°
  • Bridging limit: ~50mm (printer dependent)
  • Minimum hole diameter: 2mm (horizontal), 1mm (vertical)

Chamfers and Fillets

LocationTypeSizePurpose
Bottom edgesChamfer0.5 mmElephant foot prevention
Top edgesChamfer0.3-0.8 mmChip prevention
Inside cornersFillet2-3 mmStress relief
Outside cornersFillet3-8 mmGrip 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

markdown
## 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.