cdsl-cad/backend/agent/skills/cad-engine/references/part-skills/source/atomic/through-hole-cut.atomic.md

Through Hole Cut Atomic Skill

When to use

• A part needs a clean circular hole or bore that passes fully through a plate, block, bracket wall, flange, washer, spacer, or boss.
• The request mentions through hole, clearance hole, central hole, circular opening, bore through, or cut through all.

Do not use when

• The hole is threaded, counterbored, countersunk, or a bearing seat requiring special geometry.
• The circular feature is a blind pocket, groove, decorative recess, or non-through relief.
• The hole is part of a patterned bolt circle; combine with the pattern skill for repeated holes.

Recognition features

• Circular sketch on a planar face followed by Cut-Extrude or HoleWzd through all.
• Cylindrical internal face runs through the full thickness.
• Used for clearance, alignment, lightening, shaft passage, or central opening.

Core invariants

• Hole axis should be normal to the face or coaxial with the main part axis.
• Use through-all end condition when the hole must pass through the entire body.
• Keep hole diameter and placement explicit.
• For central holes, use the part axis or centerline as the placement reference.
• For repeated holes, make one seed through hole and pattern it.

Parameter roles

• hole_diameter defines opening size.
• placement_point defines center on the start face.
• axis defines coaxial central placement when needed.
• end_condition is usually through all.
• face defines the start plane.

Construction sequence

1. Select the face or reference plane where the hole starts.
2. Place a circle center from datums, centerlines, or the main axis.
3. Sketch the circle with the required diameter.
4. Cut through all material in the intended direction.
5. Pattern or mirror the through-hole cut if repeated.
6. Add hole edge chamfers only after the cut exists.

Common failures

• Creating a shallow blind pocket when a through hole is required.
• Leaving a sketch circle without cutting material.
• Placing a central hole off-axis.
• Treating threaded/counterbored/bearing holes as plain through holes.
• Cutting through unintended bodies in an assembly-like model.

Evidence summary

• Latest run evidence: 49 accepted atomic insights matched through-hole and circular-cut creation.
• Strong repeated names include create_through_hole, cut_circular_hole, cut_circle, cut_central_bore_through_plate, and create_through_holes_with_cut.
• Frequent operations in the latest run: Cut, HoleWzd, CircularPattern, LinearPattern, Chamfer.
• Source model examples: 001563, 001942, 046907, 054633, 059866, 080145, 086131, 096474, 142955, 148675, 153729, 160077, 222192, 230562, 241179.
• Source: CAD-SkillX offline review of SCAD58 descriptions, STEP summaries, and SolidWorks feature evidence.

Retrieval metadata

Triggers:

• through hole
• clearance hole
• central hole
• circular opening
• cut through
• bore through

Secondary triggers:

• shaft passage
• alignment hole
• lightening hole
• hole through plate
• hole through boss

Operation triggers:

• cut extrude through all
• cut circle
• hole wizard through hole
• pattern through hole

Exclusions:

• threaded hole
• counterbored hole
• countersink
• bearing seat
• blind pocket