almightyshui/mechanical-ai-skill

AI Mechanical Engineering Review Skill

Upload a STEP assembly. Understand the design. Review engineering risks. Generate reports.

Not another CAD copilot. Mechanical AI Skill focuses on engineering understanding and review — not geometry generation. It’s a structured engineering-review layer that lets an AI agent (Claude Code, Codex, Cursor) reason about a mechanical assembly.

Put differently: it’s the first AI-native engineering review layer for mechanical assemblies — not a CAD tool, not a simulation tool, not a DFM tool, but the reasoning layer that sits between an AI agent and all of those.

Upload assembly → Understand assembly → Engineering review → Engineering report

Why

Mechanical assemblies are hard for AI agents to reason about. A large STEP assembly can contain:

• Hundreds of components
• Complex mating relationships
• Hidden mechanisms
• Manufacturing risks
• Assembly complexity

Mechanical AI Skill provides a structured engineering review layer so an AI agent can go from a raw CAD file to an understanding of the design and a real engineering review — with the honest assumptions and caveats an engineer would attach. This is the open Community Edition, fully functional on its own.

What it is — and is not

Mechanical AI Skill is not:

• ❌ A CAD modeling copilot
• ❌ A generative / geometry-creation tool
• ❌ A drawing or feature-modeling assistant

Mechanical AI Skill is:

• ✅ Assembly understanding (structure, BOM, mechanisms)
• ✅ Engineering review (interference, DFM/DFA, risk)
• ✅ Mechanical diagnostics (clashes, clearances, complexity)
• ✅ Engineering reporting (PDF / HTML)

Example — one STEP in, a full review out

Input: a real 39 MB SolidWorks-exported STEP of a dual-station robotic welding cell. No SolidWorks, no geometry kernel — just the Community Edition reading the STEP. Every figure is the actual output; nothing is invented.

Output (review_summary, written to mech_review/review_summary.md next to the STEP)

EXECUTIVE SUMMARY