RoadRunner Core

Foundation skill for all RoadRunner agent workflows. Manages the RoadRunner connection, project/scene/scenario lifecycle, and handle management from MATLAB. Produces the rrApp handle used by all downstream RoadRunner skills.

Execution: all MATLAB code runs via evaluate_matlab_code MCP tool. Never matlab -batch.

When to Use

• Connecting to or launching RoadRunner from MATLAB
• Creating, opening, or saving projects, scenes, or scenarios
• Setting world origin or scene extents
• Checking RoadRunner status
• Closing RoadRunner safely
• Any downstream RoadRunner skill needs rrApp initialization

When NOT to Use

• RoadRunner is not installed, this skill requires a working RoadRunner installation; it cannot install the product
• MATLAB version below R2022a, the roadrunner class and related APIs are not available in earlier releases
• rrApp already exists and is valid, re-running rrCoreInitialize is safe (it's idempotent) but unnecessary; prefer checking exist('rrApp','var') first to avoid the overhead
• User has not provided installation or project paths when first-time setup is needed, ask the user first, do not guess paths
• RoadRunner is intentionally closed, do not reconnect or relaunch without explicit user permission

---

1. How the Agent Uses This Skill

First-time setup (once per machine, two-tier resolution)

rrCoreInitialize handles setup automatically using a two-tier approach:

Tier	Condition	What happens
1	Settings valid + roadrunner class on path	Setup skipped, already configured
2	Agent has installFolder and projectPath variables	Programmatic setup: addpath, savepath, writes MATLAB settings. No GUI.