wzyn20051216/matlab-agent-skills / skills/matlab-control-optimization
matlab-control-optimization
VerifiedMATLAB workflow for control systems, system identification, robust control, MPC, Simulink Control Design, parameter tuning, constrained optimization, and numerical validation. Use whenever the user asks for controllers, transfer functions, state-space models, tuning, identification, optimal control, or solver-based engineering.
MATLAB Control Optimization
Use this skill for control design and optimization workflows.
Skill Root
The installed directory containing this SKILL.md is the resource root. Add its
helper folder for the current MATLAB session only — never through savepath,
startup.m, or a global path edit:
skillRoot = '<absolute path to the installed matlab-control-optimization Skill directory>';
addpath(fullfile(skillRoot, 'scripts'));
Resolve references/, tests/, and helper calls from that root, not from the
caller's working directory. If a shipped helper or reference is missing, report the
exact path and reinstall the Skill; do not scan the disk for a substitute.
Workflow
- Define plant model, units, sample time, constraints, and performance goals.
- Confirm required products: Control System Toolbox, System Identification Toolbox, Optimization Toolbox, Robust Control Toolbox, or MPC Toolbox.
- Build an executable baseline model.
- Tune or optimize with explicit objective and constraints.
- Validate time-domain, frequency-domain, and robustness behavior when applicable.
- Save plots, tuned parameters, and numerical metrics.
Preferred APIs
tf,ss,zpk,c2d,d2cstep,lsim,bode,margin,bandwidthpidtune,systune,hinfsyn,musynwhen licensediddata,tfest,ssest,compareoptimproblem,fmincon,lsqnonlin,ga,particleswarm
Validation Metrics
Use checks such as:
- Rise time, settling time, overshoot.
- Gain margin, phase margin, bandwidth.
- Constraint violation count.
- Objective value and solver exit flag.
- Identification fit percentage on held-out data.
Risk Checklist
Watch for:
- Continuous/discrete sample-time mismatch.
- Unscaled optimization variables.
- Local minima and solver sensitivity.
- Hidden actuator saturation.
- Controller instability outside nominal operating points.
Stability Is Three Answers, Not One
Use mas_stability_verdict before reporting any stability conclusion:
r = mas_ctrl_analyze(L); % every crossing, poles, notes
v = mas_stability_verdict(L); % or mas_stability_verdict(r)
v.math.stability % STABLE | UNSTABLE | UNDETERMINED
v.target.status % PASS | FAIL | UNDETERMINED
v.evidence.quality % VERIFIED | PARTIAL | NOT VERIFIED
v.notes % why a value is NaN / undetermined
r = mas_ctrl_pid_design(P, struct('pmTarget',50,'gmTarget',6));
r = mas_ctrl_aw_sim(P, cfg, opts); % saturation + 'none'|'clamp'|'backcalc'
Never turn "MATLAB ran", "poles are stable", "PM passed", or "the curve looks
smooth" into one of the other answers. A missing margin is UNDETERMINED, not
PASS. When the closed-loop poles and the frequency margins disagree, the verdict
is UNDETERMINED with an EVIDENCE_CONFLICT note.
Boundary rules this tool encodes (each one a paid-for defect):
margin()returnsGmas an absolute ratio, not dB;allmarginalso reports a ratio.c2d(10/(s+1),0.01)has ratio 20.0002 = 26.02 dB.- Phase is unwrapped and PM is wrapped into
(-180,180]. Without the wrap a negative-gain loop reports+275.7 deginstead of-84.26 deg. - DC unity gain has its PM at DC (
1/(s+1)-> 180 deg), not NaN. - Phase = -180 at DC with
|L|>1is a negative GM atw=0;-10/(s+1)is UNSTABLE although its 0 dB crossing looks healthy. - Discrete loops reach -180 at
pi/Ts; that Nyquist boundary must be checked. - Multiple crossings: the worst one binds, never the first.
- Delay: rational closed-loop poles exclude the delay, so evidence is
PARTIAL.
Units are explicit: every crossing carries f (Hz) and wRadPerSec (rad/s), and
opts.freqUnit selects how wmin/wmax are interpreted. Verify w = 2*pi*f.
Full definitions, boundary table, and independent reference values:
references/stability-contracts.md.
tests/test_ctrl_analyze.m covers the known-stable loop, known-unstable plant,
multi-crossing loop, discrete and delayed loops, PID design and anti-windup.
tests/test_stability_contract.m covers the negative-gain encirclement, DC unity,
double integrator, discrete Nyquist margin, no-crossing target, target-not-met,
Hz/rad-s equivalence, NaN/Inf/empty inputs, and margin return-order units.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |