matlab/matlab-agentic-toolkit / skills-catalog/matlab-programming/matlab-validate-function-arguments
matlab-validate-function-arguments
VerifiedUse when writing MATLAB functions with arguments blocks — repeating arguments (arguments (Repeating)), .?ClassName property import in constructors, name-value forwarding with namedargs2cell, or migrating from inputParser or validateattributes. Also when reviewing signatures for implicit-conversion pitfalls (size reshaping, class coercion, computed defaults), or when restricting, constraining, or validating function inputs — scalar vs vector enforcement, type rejection, size checking. Also when asked to harden inputs, make a function more robust, tighten input checking, or rewrite for safer input acceptance — even without "validation" or "arguments block" wording. Triggers on: arguments block, mustBe validators, name-value arguments, varargin, inputParser, nargin/narginchk, restrict input, type checking, scalar constraint, harden inputs, defensive programming. Not for: App Designer callbacks, Simulink mask parameters, class inheritance, or runtime validation outside function or property declarations.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 22.0 KB |
| manifest.yaml | config | 388 B |
| references/examples/dot-question-syntax.md | markdown | 2.7 KB |
| references/examples/repeating-args.md | markdown | 3.8 KB |
| references/migration-guide.md | markdown | 6.0 KB |
| references/validators-reference.md | markdown | 7.0 KB |
references/examples/dot-question-syntax.md
View on GitHub# .?ClassName Syntax — Worked Examples
For the basic `SensorConfig` constructor, see the ".?ClassName — Import
Properties as Name-Value Args" section of `SKILL.md`. The patterns below
extend that example.
## Overriding Specific Properties
Add constraints beyond what the property definition provides:
```matlab
function obj = PlotConfig(nvArgs)
arguments
nvArgs.?PlotConfig
nvArgs.LineWidth (1,1) double {mustBeBetween(nvArgs.LineWidth, 0.5, 10, "closed")}
end
% Override lines can appear before or after the .? line
% They add tighter validation than the property definition
end
```
## Static Factory with Forwarding
For the body of `fromPreset` and the `namedargs2cell` forwarding pattern,
see the "namedargs2cell — Forward Name-Value Args" section of `SKILL.md`.
The same body works as a `methods (Static)` block on the class itself —
just hoist it into a `methods (Static) ... end` block and call as
`SensorConfig.fromPreset("audio", FilterOrder=8)`. The arguments block,
preset switch, override loop, and `namedargs2cell` call are unchanged.
## Wrapper Function Pattern
Wrap another function and forward its name-value args:
```matlab
function myBar(x, y, barArgs)
arguments
x (:,:) double
y (:,:) double
barArgs.?matlab.graphics.chart.primitive.Bar
end
nvCell = namedargs2cell(barArgs);
bar(x, y, nvCell{:});
end
```
Call: `myBar(x, y, FaceColor="magenta", BarLayout="grouped")`
This imports ALL public settable properties of the `Bar` class as valid name-value args — hundreds of properties, automatically validated.
## Key Rules
1. **Only one `.?ClassName` per arguments block**
2. **Override lines can appear before or after the `.?` line**
3. **Properties must be public and settable** — Dependent, Constant, and private properties are excluded
4. **Defaults come from property definitions** — no need to redeclare them
5. **The struct only contains fields the caller passed** — `fieldnames(nvArgs)` returns only what the user explicitly provided, not all properties. Unpassed properties retain their declared defaults on the object.
6. **Use `namedargs2cell`** to convert the struct back to a cell array for forwarding
7. **Tab completion works automatically** — users see all valid property names
## When NOT to Use .?ClassName
- The class has many properties but only a few should be constructor-settable → manually list the subset
- You need different defaults in the constructor vs the property definition → manually declare with custom defaults
- The class is not yours and you only want to expose a few of its properties → manually list what you want
----
Copyright 2026 The MathWorks, Inc.
----
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: 318k | 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: 196k | 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: 196k | 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: 196k | Updated | Claude CodeCodex | Verified | Install |