frankxai Simulation Lab Builder
A learning goal → a runnable interactive simulation with guided experiments.
Purpose
Some concepts only click when you can play with them (orbits, gravity, wave interference, scale). This skill produces a self-contained interactive simulation — parameters the learner can tune, plus a short set of guided experiments that lead to the intended insight — runnable from a single HTML file.
When it fires
- Keyword triggers:
simulation,interactive lab,sandbox,interactive demo,visualize this - File triggers:
sims/**,*.sim.html - Command triggers:
/simulation-lab-builder
Inputs
| Input | Required | Notes |
|---|---|---|
goal |
yes | The insight the sim should produce. |
params |
no | Variables to expose as sliders/inputs. |
stack |
no | p5js (default) or vanilla HTML/Canvas. |
Workflow
- State the insight — the one thing a learner should walk away understanding. ✅ Check: the sim can actually demonstrate it.
- Model — the minimal correct model (equations/rules) that produces the behavior. Keep physics honest within stated simplifications.
- Build the sim — single-file HTML/JS (or p5.js sketch) with tunable controls and clear rendering.
- Guided experiments — 2–4 prompts ("set gravity to 0 — what happens?") that surface the insight.
- Self-check — the sim runs without errors; controls visibly affect behavior.
Output contract
{
"goal": "string",
"model_notes": "string — equations/rules + simplifications",
"code": "string — single-file HTML/JS or p5.js sketch",
"experiments": ["string — guided prompts"],
"stack": "p5js | vanilla"
}
Tools & MCP
- Tools:
Write,Bash/browser to smoke-test. MCP: none required.
Quality bar
- Runs from a single file without external build steps.
- Model is physically honest within its stated simplifications.
- Controls measurably change the simulation.
- Experiments lead to the stated insight.
Example
Input: goal "show how orbital speed changes with distance" → a p5.js two-body sim with a distance slider and three guided experiments.
Built on SIP — Starlight Intelligence Protocol Substrate: starlightintelligence.org/protocol v1.1.0 Layers used: [file-contract, attestation, sovereignty] Vertical: starlight-agent-skills · portable capability layer