simulink-use-c-function-block
Use when integrating legacy code, custom code, or C/C++ code into Simulink via C Function blocks. Configure Simulink C Function blocks programmatically using the SymbolSpec API.
Install / Use
npx skills add matlab/simulink-agentic-toolkit --skill simulink-use-c-function-blockInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of simulink-use-c-function-block
simulink-use-c-function-block scores 92/100 on our quality scale, 938th of 4,702 Development & Engineering skills we index (top 20%).
Its SKILL.md is 8.7 KB long, well organised into 15 sections with 4 code examples: a thorough specification that gives an agent plenty to work with.
With 1,148 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so simulink-use-c-function-block is actively maintained.
- Our last check on 2026-10-28 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
simulink-use-c-function-block compared with similar skills
All 4 of these similar skills score higher than simulink-use-c-function-block; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| simulink-use-c-function-block (this skill)by matlab | 92 | 1.1k | 2mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 117.6k | 9d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.7k | 9d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.9k | today | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.3k | today | CLAUDE.md |
Frequently asked questions
- How do I install simulink-use-c-function-block?
- Run
npx skills add matlab/simulink-agentic-toolkit --skill simulink-use-c-function-block. The install tabs above show the steps for each supported agent. - Which AI agents does simulink-use-c-function-block work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is simulink-use-c-function-block safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is simulink-use-c-function-block still maintained?
- The repository was last updated about 2 months ago, so simulink-use-c-function-block is actively maintained.
Skill content
View source on GitHubname: simulink-use-c-function-block description: | Use when integrating legacy code, custom code, or C/C++ code into Simulink via C Function blocks. Configure Simulink C Function blocks programmatically using the SymbolSpec API. TRIGGER when the user:
- Asks about calling or wrapping C/C++ code or libraries in Simulink
- Wants to create, configure, or use a C Function block
- Mentions integrating custom code, legacy code, or external C/C++ into a model
- Asks to integrate a C++ class into a Simulink model or test bench
- Mentions inputs/outputs/parameters for a C++ algorithm block license: https://www.mathworks.com/content/dam/mathworks/license/pmrl/license.md metadata: author: MathWorks version: "1.0"
C Function Block Configuration
When to Use
- Calling or wrapping C/C++ code or libraries in Simulink
- Creating, configuring, or using a C Function block
- Integrating custom code, legacy code, or external C/C++ into a model
- Integrating a C++ class into a Simulink model or test bench
- Configuring inputs, outputs, or parameters for a C++ algorithm in a block
When NOT to Use
- Building general Simulink models without C/C++ integration
- MATLAB Function blocks (Embedded MATLAB) — those use MATLAB syntax, not C/C++
- Code generation workflows (Embedded Coder, Simulink Coder) — this skill is for simulation-time configuration only
Rules
- Derive each symbol's Simulink type from the corresponding C/C++ function parameter/return type (e.g.
float→single,bool→boolean,char*/char[]→string(R2024b+)). However, when replacing an existing block (e.g. an S-Function), use the types already on that block first — for example, what looks likeint32from C may actually befixdt(1,32,3)or another fixed-point type in the existing model. - MANDATORY for C++ classes: When the user's code defines a C++ class, you MUST first attempt to declare a Persistent symbol of
Class: ClassNameand call class methods directly in the code sections (e.g.obj.Method(args)). If the class has an init method (not a constructor), call it inStartCode. Only fall back to wrapper/handler functions or opaque pointer patterns if the class approach fails to compile. - Prefer relative paths for custom code files (sources, headers, libraries, search directories). Use paths relative to the model file location (e.g.
'myFunctions.h','./src/myLib.cpp') rather than absolute paths. This ensures portability across machines and users.
Workflow Overview
- Add the C Function block — use
model_editwith type"C Function"and setCustomCodeSettingLocation(default:"BlockSettings") - Configure custom code settings — point to headers/sources either on the block or model config (see
references/custom-code-config.md) - Set code sections — configure
OutputCode,StartCode, etc. on the block - Configure symbols via SymbolSpec — use
model_query_paramsto get the SymbolSpec, thenevaluate_matlab_codefor object operations
SymbolSpec API (Port & Symbol Specification)
The SymbolSpec object defines the block's inputs, outputs, persistent state, constants, and parameters.
Getting the object
Query with model_query_params, then operate via evaluate_matlab_code:
obj = get_param('myModel/MyCFunction', 'SymbolSpec');
Adding, getting, deleting symbols
symObj = obj.addSymbol('varName'); % adds with default: Input, double, size '1'
symObj = obj.getSymbol('varName'); % get one by name
allSyms = obj.Symbols; % get all symbols
obj.deleteSymbol('varName');
Note: addSymbol always creates with defaults (double, Input, size '1'). When re-adding a deleted symbol, explicitly set all non-default properties (Type, Scope, Size) — prior properties are not retained.
Symbol Properties
| Property | Values | Default | Notes |
|----------|--------|---------|-------|
| Name | identifier string | (from addSymbol) | Variable name in code; for class types includes constructor args |
| Scope | 'Input', 'Output', 'InputOutput', 'Persistent', 'Constant', 'Parameter' | 'Input' | See Scope Details below |
| Type | 'double', 'single', 'int8'...'uint64', 'Boolean', 'string', 'Bus: BusName', 'Enum: EnumName', 'Class: ClassName', 'AliasTypeName', or fixedpoint | 'double' | |
| Size | dimension string | '1' | e.g. '1', '3', '[2,3]', 'size(u1)' |
| Label | port label / value | same as Name | For Constant: the literal value |
| PortNumber | uint32 | auto-assigned | Port ordering |
Scope Details
| Scope | Description | Port? |
|-------|-------------|-------|
| Input | Block input port | Yes (inport) |
| Output | Block output port | Yes (outport) |
| InputOutput | Read-write pass-through (always first in port numbering) | Yes (both) |
| Persistent | State that persists across time steps (also used for class instances) | No |
| Constant | Compile-time constant (scalar only) | No |
| Parameter | Tunable parameter from workspace/mask | No |
Setting Parameter values
After setting Scope to 'Parameter', set the value by configuring the block with the parameter name as the key.
C++ Class Types
Class instances are declared as Persistent scope symbols with Type = 'Class: ClassName'.
Constructor arguments are specified in the Name property:
obj = get_param('myModel/CFunction', 'SymbolSpec');
% Default constructor (no args)
sym = obj.addSymbol('myObj');
sym.Scope = 'Persistent';
sym.Type = 'Class: MyClass';
% Constructor with arguments (args must be Parameter or Constant scope symbols)
sym = obj.addSymbol('myObj(p)');
sym.Scope = 'Persistent';
sym.Type = 'Class: MyClass';
Rules for class types:
- Class must be defined in an external header (included via custom code settings) — NOT inside code sections
- Cannot create class instances as local variables in code sections — applies when
CustomCodeSettingLocation='ModelConfigurationParameters'(always parsed), or'BlockSettings'withParseBlockCode='on' - Constructor arguments must be Parameter or Constant scoped symbols only
- Function calls in constructor arguments are not allowed
newoperator is not allowed when block code is parsed- Private/protected members cannot be accessed from code sections
- Class type does not support save/restore (SimSnapshot)
Access class methods in code sections: y = myObj.compute(u1);
Size Expressions
- Scalar:
'1' - Vector:
'3'or'[3,1]' - Matrix:
'[2,3]' - Dynamic from input:
'size(u1)','size(u1,1)','size(u1) + 1'
Rules:
size()IS allowed in output dimensions (compute output size from inputs)size()is NOT allowed in input dimensions- Output size CANNOT be
'-1'(inherited) — must be explicit or usesize()expression - Input size CAN be
'-1'(inherited) - Size must evaluate to integer values
- Nested
size(size(...))is NOT supported
Restrictions
#includedirectives NOT allowed inside code sections (Start/Output/Terminate) — use custom code settings- Start/Terminate code CANNOT access Input or Output scoped symbols
- Constant scope must be scalar
- Library functions (e.g.
isalnum) not supported inside code sections whenParseBlockCode='on'orCustomCodeSettingLocation='ModelConfigurationParameters'— use external calls via header. No restriction under default R2026a+ settings (BlockSettings+ParseBlockCode='off') - When using a
Simulink.NumericTypewithDataScope='Exported'in symbols, or anySimulink.NumericTypein code sections, itsIsAliasproperty must betrue - When
CustomCodeSettingLocation='UpdateBuildInfo',GenerateCodeAsIsis forced'on' - Class definitions NOT allowed inside code sections — define in external header
- Variable-size signals are not supported
Full Example: Block-Level Custom Code with C++ Function
% 1. Add C Function block with block-level custom code
% Use model_edit: add_block type "C Function", set CustomCodeSettingLocation,
% SimCustomHeaderFile, SimCustomSourceFile, and OutputCode on the block.
% 2. Configure symbols
obj = get_param('mMyTest/C Function', 'SymbolSpec');
obj.addSymbol('u1');
obj.addSymbol('u2');
u2obj = obj.getSymbol('u2');
u2obj.Type = 'int32';
u2obj.Size = '3';
obj.addSymbol('y');
yobj = obj.getSymbol('y');
yobj.Scope = 'Output';
yobj.Size = 'size(u2)';
obj.addSymbol('state');
stateobj = obj.getSymbol('state');
stateobj.Scope = 'Persistent';
save_system('mMyTest');
close_system('mMyTest', 0);
See references/examples.md for additional patterns (model-level custom code, C++ class with constructor args).
See references/custom-code-config.md for detailed parameter tables and custom code location settings.
Copyright 2026 The MathWorks, Inc.
Related Skills
taste-skill
117.6kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.7kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
79.9kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
ai-job-search
72.3kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
