cdsl-cad/backend/agent/skills/cad-engine/references/part-skills/source/functional/standard-hole-wizard.functional.md

Standard Hole Wizard Functional Skill

When to use

• A part needs standard clearance holes, threaded/tapped holes, counterbored holes, countersunk holes, dowel holes, or screw-seat holes.
• The request mentions screw size, metric thread, socket head screw, flat head screw, fastener clearance, tapping, counterbore, countersink, or Hole Wizard-like behavior.

Do not use when

• The circular feature is a bearing bore, shaft bore, decorative opening, large window, or non-standard milled pocket.
• The hole is part of a freeform surface where a standard hole feature cannot be cleanly placed.
• The user asks for detailed thread geometry and the CAD backend cannot represent it reliably.

Recognition features

• Feature evidence such as HoleWzd, threaded hole, counterbored hole, countersunk hole, through hole, or standard metric sizes like M3, M4, M5, M6, M8, M10.
• Holes are used for fastening, alignment, or assembly rather than decoration.
• Hole positions are points on a planar face, often patterned or mirrored.

Core invariants

• Select hole type before modeling: clearance, threaded, counterbore, countersink, or dowel.
• Keep hole axis normal to the placement face unless an angled hole is explicitly requested.
• Specify end condition: through all, blind depth, up to next, or thread depth.
• Preserve fastener seating geometry: counterbore/countersink is not a decorative ring.
• Pattern or mirror the completed hole feature when identical holes repeat.

Parameter roles

• hole_type selects clearance, threaded, counterbore, countersink, dowel, or simple through hole.
• standard and thread_size define metric/imperial thread family when available.
• hole_diameter, tap_drill_diameter, thread_depth, and hole_depth define cut size.
• counterbore_diameter, counterbore_depth, and countersink_angle define screw head seating.
• placement_points, edge_offsets, and pattern_count define layout.

Construction sequence

1. Identify the fastening or alignment function for each hole group.
2. Choose the matching standard hole type and size.
3. Place hole center points on the correct face using datums, centerlines, or coordinates.
4. Create the hole feature with diameter, depth, thread, and seating data.
5. Pattern or mirror the completed hole feature when the group repeats.
6. Add entrance chamfers only after the hole geometry is correct.

Common failures

• Modeling all holes as plain cylinders and losing thread/counterbore/countersink meaning.
• Adding visual thread helixes where a thread callout or standard threaded hole is enough.
• Forgetting counterbore depth for socket head screws.
• Patterning hole center sketches without patterning the hole cut.
• Using non-standard sizes when the prompt specifies standard fasteners.

Evidence summary

• Latest run evidence: 149 accepted functional insights matched standard hole creation and fastener-hole logic.
• Strong repeated names include use_hole_wizard_for_standard_holes, use_counterbored_holes_for_flat_head_screws, use_hole_wizard_for_threaded_holes, and use_hole_wizard_for_counterbore_holes.
• Frequent operations in the latest run: HoleWzd, Cut, LinearPattern, MirrorPattern, Chamfer.
• Source model examples: 001082, 001607, 003846, 011721, 014040, 029487, 041650, 061936, 074693, 094929, 102841, 145389, 160434, 211326, 227986.
• Source: CAD-SkillX offline review of SCAD58 descriptions, STEP summaries, and SolidWorks feature evidence.

Retrieval metadata

Triggers:

• hole wizard
• standard holes
• threaded holes
• counterbored holes
• countersunk holes
• tapped holes

Secondary triggers:

• M3
• M4
• M5
• M6
• M8
• socket head screw
• flat head screw

Operation triggers:

• create hole wizard feature
• create threaded hole
• create counterbore
• create countersink
• pattern hole feature

Exclusions:

• bearing bore
• shaft bore
• decorative hole
• large cutout
• freeform pocket