Concept reference

Templates & Skills

Templates accelerate common cases; skills capture method. Both are signed, both are optional — neither replaces the kernel.

2 min read

Templates

A template is a pre-populated CaseSpec — solver, mesh intent, BCs, controls, validation plan — with declared parameters you can override. It compiles through the same typed state and solver-pack contract as a hand-authored case. The current public starters include:

  • OpenFOAM Backward-Facing Step Benchmark Starter (OpenFOAM) — 4 parameters
  • OpenFOAM Lid-Driven Cavity Benchmark Starter (OpenFOAM) — 9 parameters
  • OpenFOAM Heated Cavity Starter (OpenFOAM) — 9 parameters
  • OpenFOAM Buoyant Room HVAC Starter (OpenFOAM) — 9 parameters
  • OpenFOAM rhoCentralFoam Nozzle Starter (OpenFOAM) — 7 parameters
  • OpenFOAM interFoam Dam Break Starter (OpenFOAM) — 7 parameters

Skills are guides, not templates

Skills are signed workflow guides loaded into the agent's context when a task calls for them. They route the agent toward the right files, resources, and tools — they never embed hidden one-case shortcuts. Current platform skills include:

  • CadQuery 2.7.0 — Use when the workflow needs programmatic CAD generation, geometry edits, or format handoff through the local CadQuery corpus.
  • CalculiX / CCX 2.23 — Use when the workflow is building, adapting, debugging, or validating a CalculiX CCX 2.23 analysis or a CGX-assisted preprocessing flow.
  • FreeCAD 1.1.0 — Use when the workflow needs FreeCAD scripting, GUI or headless automation, FeaturePython objects, FEM preprocessing, or FreeCAD-driven handoff into other simulation phases.
  • Geometry & Meshing — Use when the geometry, export, or mesh contract is unresolved before or across software-specific phases, or when the workflow needs mesh-quality and convergence-study reasoning rather than one tool’s exact syntax.
  • Gmsh 4.15.2 — Use when the active workflow phase is Gmsh geometry handling, meshing, physical-group definition, export, or mesh-debugging.
  • OpenFOAM v2512 — Use when the active workflow is setting up, adapting, debugging, validating, or post-checking an OpenFOAM v2512 case.
  • Optimization — Use for single- or multi-objective design optimization, method selection, surrogate strategy, convergence criteria, and Pareto decision framing after loading the study skill.
  • Physics Setup — Use only when the main gap is CFD physics-model choice, BC reasoning, or numerics strategy before or across exact OpenFOAM or SU2 syntax. Do not use this skill for structural or thermal FEA deck semantics.
  • Python Analysis — Use when a custom Python script is the clearest way to extract, compare, smooth, aggregate, or plot results after checking whether PyVista or createVisualization already covers the need.
  • PyVista 0.47.3 — Use when results already exist and the active phase is reading, sampling, visualizing, exporting, or reporting with PyVista.

Signing

Templates and skills are cryptographically signed by their publisher. The platform refuses to load unsigned artifacts in tenant-scoped flows. Org-internal skills go through a separate review channel.

Writing your own

Start in the templates browser (or skills authoring view), declare typed parameters or guidance text, and publish through your tenant's signed registry. The platform validates schema, scopes, and citations before signing.

Was this page helpful?

Edit this page on GitHub

Search docs

Find pages across the SimPilot docs.