# 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`