The MotorXP AI Skills add MotorXP-aware assistance to two coding agents — Codex and Claude Code. Each skill teaches the agent how to create, review, validate and troubleshoot MotorXP-PM and MotorXP-AFM workflows: the MATLAB scripting API, JavaScript geometry templates, JSON parameter maps, magnetostatic FEA, TSEMO optimization, Pareto analysis, safe resume logic and design export.
Note. A skill is a single SKILL.md file that the agent loads on demand. It does not run MATLAB or FEA by itself and never starts a long calculation without your explicit request.
Package contents #
- MotorXP_Claude_Code_SKILL.md — the skill for Claude Code.
- MotorXP_Codex_SKILL.md — the skill for Codex.
- MotorXP_AI_Skills_Installation_Guide_eng.pdf — the full installation guide (PDF edition).
Warning. The skills are sanitized to remove project operating points, dimensions, personal names and customer names. Preserve this rule when extending them.
Download the skill files #
Download the file for your agent. After downloading, copy it into the skill folder and rename the installed copy to SKILL.md (see the installation guide below).
Claude Code skill (SKILL.md) Codex skill (SKILL.md)
Which one should I use? #
Both skills share the same MotorXP engineering rules and differ only in the working-style section that matches each agent:
- Claude Code — use inside Claude Desktop (Code tab) or the Claude Code CLI. Discovery is by /motorxp-engineering or natural-language prompts.
- Codex — use inside the Codex CLI or the Codex app. Discovery is by /skills or $motorxp-engineering.
Install only the file that matches the agent you actually use — you do not need both.
Installation guide #
The guide below covers project and personal installation for both agents, folder locations, updating, uninstalling and the quick acceptance test. Use the viewer to read it inline, or open/download the PDF.
Open the guide (PDF) Download the guide (PDF)
Install in short #
Your MotorXP-AFM/PM installation may already ship the skill under .claude/skills/motorxp-engineering (Claude Code) or .agents/skills/motorxp-engineering (Codex). If so, no copy is needed. Otherwise:
- Download the file for your agent from the buttons above.
- Create the skill folder — per project (.claude\skills\motorxp-engineering or .agents\skills\motorxp-engineering inside the project), or personal for all projects (%USERPROFILE%\.claude\skills\motorxp-engineering or %USERPROFILE%\.agents\skills\motorxp-engineering).
- Copy the downloaded file into that folder and rename it to SKILL.md.
- Start a new agent session. If the skill is not listed, fully restart the app or CLI.
Tip. Cowork and cloud sessions use account-enabled skills, not your local personal skills folder. Configure those separately through Customize, and verify discovery in a local Code session with /motorxp-engineering.
Quick acceptance test #
After installation, run one safe test (no MATLAB, no FEA). Send this prompt inside Codex or Claude Code:
Use the motorxp-engineering skill. Prepare a design contract for a new MotorXP optimization. I have not supplied the base design, operating point, variables, or objectives. Do not create files and do not run MATLAB.
The agent should behave as follows:
- It does not invent an operating point, geometry or API parameter names.
- It requests the base design, mode, targets, variables, objectives, constraints, result contract and permission to run.
- It distinguishes the MotorXP-PM and MotorXP-AFM APIs and proposes checking names against manual.pdf and the installed JSON maps.
- It does not disclose confidential information from neighboring projects.
Project-data security #
Warning. The skill includes disclosure-minimization rules, but you must still control the agent’s access to project folders and review any shared document before publishing it.
