agentleFS
randomonkey05randomonkey05/SolidCraft-Agent-Skills/skills/solidcraft-hole-fastener-rules/SKILL.md

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.

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
  1. Distinctive:

    Ask for module, number of teeth, pressure angle, face width and bore.

    line 50
  2. Distinctive:

    Check undercut risk when the root circle falls below the base circle.

    line 60
  3. Distinctive:

    Not covered without a specialist route or an engineer: helical, bevel, internal, rack, worm, profile-shifted gears, backlash, tolerance …

    line 62

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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:

ThreadM3M4M5M6M8M10M12
Clearance hole, ISO 273 medium3.44.55.56.691113.5
Tap drill, coarse pitch2.53.34.25.06.88.510.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_commands with a filter such as thread). 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 typeMin wall or thicknessHole edge to part edgeWeb between holes
Machined bracket1.50.75 x diameter, at least 23
Machined drilled paneln/a1 x diameter, at least 33
Sheet-metal panel0.81 x diameter, at least 22
Injection-moulded shell1.0 (smallest feature 0.8)0.5 x diametern/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) and solidcraft-delivery-gate (before delivering).

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.