solidcraft-hole-fastener-rules
Skill12 starsChanged 17 days agoApache-2.0View on GitHub
Use when a SolidCraft part needs screw holes, tapped holes, counterbores, slots, pockets or spur gears and you need starting values: clearance and tap-drill sizes, hole edge distance, web and wall minimums by process, and spur gear formulas. Reference data for the requirements, sanity and delivery checks; confirm per process before relying on it.
In this repository19 other files it gives its agents.
- solidcraft-3d-print-dfmSkill
- solidcraft-assembliesSkill
- solidcraft-checkingSkill
- solidcraft-delivery-gateSkill
- solidcraft-dfm-reviewSkill
- solidcraft-drawing-and-tutorial-readingSkill
- solidcraft-editingSkill
- solidcraft-engineering-drawingSkill
- solidcraft-mechanismsSkill
- solidcraft-modelingSkill
- solidcraft-requirements-and-sanitySkill
- solidcraft-robust-build-orderSkill
- solidcraft-sheet-metal-flatpackSkill
- solidcraft-sheet-metalSkill
- solidcraft-shell-and-tangent-arcsSkill
- solidcraft-speed-modeling-lessonsSkill
- solidcraft-step-partsSkill
- solidcraft-sweep-and-boolean-hangsSkill
- solidcraft-tutorial-recipesSkill
The file
We split this skill into the rules it gives an agent
3 rules. About 0 are common, 3 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 50
Ask for module, number of teeth, pressure angle, face width and bore.
- Distinctive: line 60
Check undercut risk when the root circle falls below the base circle.
- Distinctive: line 62
Not covered without a specialist route or an engineer: helical, bevel, internal, rack, worm, profile-shifted gears, backlash, tolerance …
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Holes, fasteners, pockets and spur gears: reference values
This skill holds data, not a procedure. The checks that use it live in solidcraft-requirements-and-sanity (before building) and solidcraft-delivery-gate (before delivering).
(Idea source: wzyn20051216/solidworks-automation-skill, MIT. Process values there are initial suggestions for CNC, sheet metal and plastic parts; restated here, not copied. Confirm against the real process, supplier and load.)
1. Decide the hole type before modelling
"An M5 screw hole" is ambiguous. State or ask which one it is, and never default it to a tapped hole:
- Clearance (through, screw passes freely)
- Counterbore or countersink (head sits below the surface)
- Tapped (the thread is cut in the part)
Starting diameters, mm:
| Thread | M3 | M4 | M5 | M6 | M8 | M10 | M12 |
| Clearance hole, ISO 273 medium | 3.4 | 4.5 | 5.5 | 6.6 | 9 | 11 | 13.5 |
| Tap drill, coarse pitch | 2.5 | 3.3 | 4.2 | 5.0 | 6.8 | 8.5 | 10.2 |
Other pitches, plastics or soft metals need the tap chart for that case; do not assume the table holds.
Tapped holes:
- The drilled hole must be smaller than the nominal thread; a counterbore must be wider than its through hole.
- Starting thread depth about 2 x the nominal diameter; check that thread engagement is at least 1.5 x the nominal diameter. A blind drill must be deeper than the thread depth.
- A small mouth chamfer (about 0.3 mm for M3 up to 1.2 mm for M12) helps the tap start.
- Find out how SolidCraft represents threads (
list_commandswith a filter such asthread). If only the tap-drill hole is modelled, write that in the notes: the model carries the tap drill, not the thread. - A flat-bottom blind hole has no drill point, no incomplete thread zone and no tap run-out or chip room. It is a good model of the hole, not a finished tapping design.
2. Starting values to confirm per process
Hole edge distance is measured from the hole edge to the part edge. State whether a ratio multiplies the hole diameter or its radius.
| Part type | Min wall or thickness | Hole edge to part edge | Web between holes |
| Machined bracket | 1.5 | 0.75 x diameter, at least 2 | 3 |
| Machined drilled panel | n/a | 1 x diameter, at least 3 | 3 |
| Sheet-metal panel | 0.8 | 1 x diameter, at least 2 | 2 |
| Injection-moulded shell | 1.0 (smallest feature 0.8) | 0.5 x diameter | n/a |
Other starting values:
- Machined mounting plate: at least 4 thick (8 as a default), pocket side wall at least 3, pocket floor at least 2, slot end radius at least 1.5.
- Holes under 3 mm in machined parts: warn (drill stiffness, chips). Holes under 1.5 mm in moulded parts: warn (fragile core pin).
- Where a sibling skill gives its own numbers (
solidcraft-3d-print-dfm,solidcraft-sheet-metal,solidcraft-sheet-metal-flatpack), use the stricter value and say which one you used.
3. Spur gears
Ask for module, number of teeth, pressure angle, face width and bore. For a part that will be made, do not invent them; for a visual demo, defaults are fine if the reply says so.
Standard full-depth external spur gear:
- pitch diameter d = m x z
- base diameter db = d x cos(alpha)
- tip diameter da = d + 2m
- root diameter df = d - 2.5m
- tooth thickness on the pitch circle = pi x m / 2
- centre distance of a mating pair = m x (z1 + z2) / 2
Check undercut risk when the root circle falls below the base circle; at 20 degrees that starts at roughly 17 teeth or fewer.
Not covered without a specialist route or an engineer: helical, bevel, internal, rack, worm, profile-shifted gears, backlash, tolerance grades, strength, and a true hobbed root shape. A gear that measures right (single solid, tip diameter, bore, face width, volume) is not production ready.
4. Report
List the hole types chosen and which values are starting values still to confirm.
5. Related skills (fill gaps, do not duplicate)
- FDM walls, overhang, bridges, clearances:
solidcraft-3d-print-dfm(this skill has no printed-part row). - Bend radius, relief, flat size:
solidcraft-sheet-metal; tabs, slits, perforation:solidcraft-sheet-metal-flatpack. - Manufacturability of holes in sheet-metal or CNC parts, and shop limits:
solidcraft-dfm-review. Where its numbers differ from the table above, use the stricter one and name both. - Real screw, nut and insert geometry instead of the nominal sizes:
solidcraft-step-parts. - Clearance across moving or mating parts:
solidcraft-assemblies. - The checks that read this data:
solidcraft-requirements-and-sanity(before building) andsolidcraft-delivery-gate(before delivering).
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

