PMSM Control Claude Skills (for MATLAB / Simulink)

A methodology and skill library for AI-augmented MATLAB/Simulink modeling of
Permanent Magnet Synchronous Motor (PMSM) control, built for use with
Claude Code.

The repository is itself a Claude Code workspace: clone it, install the
prerequisites, open Claude Code in the folder, and follow CLAUDE.md.

Layout

Skills

• motor-pmsm-base — PMSM plant modeling, dq conventions, building-blocks SOP, broken-FOC diagnostics. The method skills layer on this.
• motor-fcs-mpc — single-vector Finite-Control-Set Model Predictive Control (inner current loop).
• motor-dtc-pmsm — Direct Torque Control (αβ frame, Sutikno 6-state switching table).
• motor-smc-pmsm — Sliding Mode Control speed loop (PD-type sliding surface + super-twisting) over a dq PI current loop.

Prerequisites

• MATLAB R2024b or later, with Simulink, Simscape, Simscape Electrical, Control System Toolbox.
• Claude Code.
• matlab-mcp-core-server (MathWorks, MIT) — lets Claude Code run MATLAB directly. Install per its README.
• MathWorks' official MATLAB skills for Claude Code — install per MathWorks' instructions.

Getting started

1. Clone this repository.
2. Install the prerequisites above.
3. Open Claude Code in the repository folder. It loads CLAUDE.md and registers .claude/skills/.
4. Follow CLAUDE.md and workflow/.

Reproducibility & Evidence

This repository ships skills (instructions) and shared assets (formulas/,
building_blocks/). It does not include end-to-end build scripts that generate
complete models, simulation results (.mat, waveforms, logs), or a CI harness —
those live in the author's private development repository. The only runnable
artifacts here are the pi_design.m scripts under .claude/skills/*/scripts/.

The case studies in workflow/
(Appendix C) are anonymized narrative descriptions of engineering experience
(problem / diagnosis / resolution), not artifact-backed reproducible benchmarks.
Phrases like "validated case" refer to the author's private testing — treat them as
documented experience, not published, data-backed benchmarks.

To reproduce: install the prerequisites, then drive the skills with your own build
script and your own PMSM parameters.

Attribution and license compatibility

This repository indexes — it does not redistribute — the following MathWorks
open-source references, used by workflow phases that need official ecosystem
reference models. Clone them separately if needed:

• mathworks/pmsm-drive-optimization — BSD-3-Clause
• mathworks/FOC-of-PMSM — BSD-3-Clause

This repository's original content (skills, workflow, scripts) is under
Apache-2.0. BSD-3-Clause (the indexed references above) is compatible
with Apache-2.0 for downstream use.

shared/building_blocks/pmsm_blocks.slx is a user-authored Simulink model that
references MathWorks Simscape Electrical library blocks (PMSM, Universal Bridge,
powergui, SVPWM, etc.) by reference — it does not embed or redistribute MathWorks
block implementations. Opening it requires your own licensed MATLAB + Simulink +
Simscape Electrical installation, the same way models are shared on MathWorks File
Exchange.

Trademark notice: MATLAB® and Simulink® are registered trademarks of The
MathWorks, Inc. This is an independent project, not affiliated with, endorsed by,
or sponsored by MathWorks.

The "skill" format follows the Claude Code skill specification.

Citation

See CITATION.cff.

Author

Zong Chuhang — School of Electrical and Electronic Engineering, Nanyang
Technological University, Singapore. [email protected]

License

Apache License 2.0.