Agent Skills
› ghbalf/freecad-ai
› fastener-hole
fastener-hole
GitHub用于在CAD模型中创建标准紧固件孔（通孔、沉头孔或倒角孔），支持M2-M8规格及多种配合公差，自动计算尺寸并执行布尔运算。
Trigger Scenarios
需要创建螺栓孔
需要设计沉头或倒角孔
Install
npx skills add ghbalf/freecad-ai --skill fastener-hole -g -y
SKILL.md
Frontmatter
{
"name": "fastener-hole",
"description": "Create standard fastener holes: clearance, counterbore, or countersink."
}
Fastener Hole Patterns
Create standard fastener holes: clearance, counterbore, or countersink.
Hole types
Clearance holes (through-hole for bolt to pass through)
| Size | Close fit | Normal fit |
|---|---|---|
| M2 | 2.2mm | 2.4mm |
| M2.5 | 2.7mm | 2.9mm |
| M3 | 3.2mm | 3.4mm |
| M4 | 4.3mm | 4.5mm |
| M5 | 5.3mm | 5.5mm |
| M6 | 6.4mm | 6.6mm |
| M8 | 8.4mm | 9.0mm |
Counterbore (socket head cap screw)
| Size | CB diameter | CB depth |
|---|---|---|
| M3 | 6.5mm | 3.0mm |
| M4 | 8.0mm | 4.0mm |
| M5 | 10.0mm | 5.0mm |
| M6 | 11.5mm | 6.0mm |
| M8 | 15.0mm | 8.0mm |
Countersink (flat head screw, 90 degree)
| Size | CS diameter |
|---|---|
| M3 | 6.3mm |
| M4 | 8.4mm |
| M5 | 10.4mm |
| M6 | 12.6mm |
Parameters to ask (if not provided)
- Screw size: M2 through M8
- Hole type: clearance / counterbore / countersink
- Fit: close / normal (for clearance holes)
- Target object: body or feature to cut into
- Positions: list of XY coordinates, or pattern (linear/circular)
- Pattern: if applicable — count, spacing, or bolt circle diameter + count
Construction
- Create a sketch on the specified face
- For each hole position, add a circle (clearance diameter)
- Pocket through-all for the clearance hole
- For counterbore: add a second larger circle, pocket to CB depth
- For countersink: use a cone (Part.makeCone) to create the 90-degree chamfer
Cleanup
After construction, hide all sketches for a clean viewport:
for obj in App.ActiveDocument.Objects:
if obj.TypeId == "Sketcher::SketchObject":
obj.Visibility = False
Version History
- 08d637d Current 2026-10-18 20:51
