Skip to content

v0v1kkk/freecad-engineering

v0.1.0MIT

Editable, evidence-backed FreeCAD modeling and small-part engineering workflows for AI agents.

cad

Create, modify, inspect, and validate STEP-first parametric CAD parts and assemblies. Use for natural-language CAD specs, reference images, 2D technical drawings, STEP/STP generation or direct inspection, Python CAD source, source-level joints, selector references, geometry facts, measurements, mating deltas, snapshots, and secondary STL/3MF/native GLB outputs from CAD geometry.

cad-viewer

Start CAD Viewer and return review links for explicit CAD, implicit CAD, robot-description, and G-code files. Use when visually reviewing .step, .stp, .implicit.js, .implicit.mjs, .glb, .stl, .3mf, .gcode, .dxf, .urdf, .srdf, or .sdf files, especially when handed off from CAD, implicit-cad, G-code, URDF, SRDF, or SDF generation skills.

fdm-structural-review

Review load-bearing FDM/material-extrusion parts using process-specific evidence, printed orientation, walls and infill, anisotropy, creep, fatigue, environmental exposure, and coupon planning. Use when sizing a functional printed bracket, enclosure, boss, insert, snap-fit, beam, or lattice; when choosing walls versus sparse or solid infill; when interpreting PLA, PETG, ABS, ASA, nylon, or composite data; or when deciding whether effective properties, explicit lattice FEM, coupons, proof tests, or an engineer are required.

freecad-engineering

Orchestrate editable, evidence-backed FreeCAD parts and small mechanical systems from requirements through native parametric modeling, interface and retention analysis, preliminary strength/FDM/FEM review, artifact validation, and physical-test feedback. Use when designing or revising functional FreeCAD models, enclosures, brackets, fixtures, snap fits, printed mechanisms, or small assemblies that a human must be able to inspect and modify.

freecad-engineering-bootstrap

Set up, diagnose, or migrate a portable FreeCAD plus MCP environment for AI-assisted CAD on Linux, macOS, or Windows. Use when an agent needs to discover an existing FreeCAD/MCP installation, compare upstream package versus source-build options, install an MCP bridge with informed user approval, register it with an agent host, or troubleshoot the resulting connection without assuming Codex, Claude, or any single vendor.

freecad-fem-check

Build or audit reproducible preliminary FreeCAD FEM checks with explicit solver capability detection, analytical baselines, boundary-condition review, reaction equilibrium, mesh sensitivity, singularity handling, and evidence-limited conclusions. Use for FreeCAD plus CalculiX or Gmsh linear-static studies, for diagnosing suspicious stress or displacement fields, or for deciding whether a proposed contact, nonlinear, FDM, creep, fatigue, or snap-fit analysis is outside the validated workflow.

freecad-imported-geometry-audit

Audit imported STL meshes and foreign STEP/BRep geometry in FreeCAD to recover useful datums, support levels, interface candidates, units, orientation, and explicit assembly placements. Use when imported parts overlap or float in arbitrary coordinates, dense mesh booleans time out, a mating surface must be inferred from facets, or an agent needs reliable assembled and exploded views without modifying the printable source geometry.

freecad-model-validation

Validate FreeCAD documents, generated solids, assemblies, and exported STEP or STL artifacts with explicit expectations and machine-readable evidence. Use after creating or editing CAD geometry, before accepting an agent-generated model, when an export must be round-tripped, or when a visually plausible model may still have invalid topology, wrong dimensions, hidden intersections, unusable access, or unsaved inspection state.

freecad-scripts

Expert skill for writing FreeCAD Python scripts, macros, and automation. Use when asked to create FreeCAD models, parametric objects, Part/Mesh/Sketcher scripts, workbench tools, GUI dialogs with PySide, Coin3D scenegraph manipulation, or any FreeCAD Python API task. Covers FreeCAD scripting basics, geometry creation, FeaturePython objects, interface tools, and macro development.

gcode

Generate, inspect, dry-run, and statically validate plain FDM .gcode from 3D mesh files by orchestrating real slicer CLIs. Use when Codex needs to slice .stl, .obj, unsliced .3mf, .ply, .glb, or .gltf into printer-profiled G-code, discover local slicer backends, inspect whether a mesh is slice-ready, or validate generated G-code before any printer-specific handoff.

mechanical-constraint-analysis

Analyze six rigid-body degrees of freedom, unilateral contact directions, candidate escape motions, collision sweeps, and the evidence needed for form-closure or force-closure claims. Use when auditing whether pins, shoulders, lips, snap tabs, screws, friction, or preload physically retain a part; when a CAD assembly reports fully constrained but real hardware may still move; or when testing slide, lift, rotate, tilt, and pull scenarios before export.

mechanical-strength-review

Perform preliminary, vendor-neutral strength and stiffness screening for small mechanical parts using explicit load cases, free-body diagrams, first-order mechanics, applicability checks, and evidence-aware margins. Use when asking whether a bracket, beam, shaft, pin, boss, snap arm, or similar part may carry a stated load; when estimating stress, strain, deflection, bearing, torsion, thermal expansion, or Euler buckling; or when deciding whether hand calculations, FEM, coupons, or a qualified engineer are required.

step-parts

Find, evaluate, and download common purchasable CAD parts from step.parts, including named off-the-shelf actuators, servos, motors, electronics boards, connectors, screws, bolts, nuts, washers, bearings, standoffs, and other catalog components. Use when Codex needs to search the hosted step.parts catalog before creating simplified placeholder geometry, resolve fuzzy part names, standards, aliases, or dimensions, choose a matching part, fetch a canonical .step file, verify checksums, or use the step.parts API/OpenAPI/catalog endpoints for standard part discovery.