Skip to content

FluidSim Simulation Planner

Plans, checks and analyzes bounded FluidSim fluid-dynamics simulations with numerical-validity guardrails

Stars
55,780
Licence
MIT
Files
15 files

What it does

This skill teaches an AI agent to set up and review computational fluid dynamics (CFD) simulations using the FluidSim Python framework. Before running anything, the agent is steered to state the physical assumptions, pick a verified solver, write a strict resource plan (CPU, memory, disk, wall time, CFL and resolution limits), and run bundled checker scripts that validate configurations, estimate resources, summarize outputs and check restart compatibility. It also insists that a finished run is not proof of physical validity.

Great for

  • Researchers or engineers planning periodic Cartesian pseudospectral fluid simulations in Python
  • Computational scientists who need reproducible configs, lock files and output inventories
  • HPC users preparing a site-specific MPI job who want resource estimates reviewed first

Skip it if

  • Users wanting a quick GPU-accelerated simulation: the skill states no GPU backend is assumed and GPU use is experimental
  • Anyone expecting a guaranteed-correct answer: the skill warns that completed runs, stable time steps and smooth plots do not prove convergence
  • Non-technical users without a physics question or Python environment, since setup requires Python 3.11+ and FFT libraries

Try asking

  • “Set up a 2D Navier-Stokes FluidSim pilot run with a small grid and CFL control, then review the resource budget”
  • “Estimate CPU, RAM and disk needs for a 3D stratified simulation before asking for a cluster allocation”
  • “Summarize the spectra and scalar budget outputs from a finished FluidSim run”
  • “Check whether a restart from an earlier output is compatible with the current parameters”
Step-by-step guide: how to use FluidSim Simulation PlannerInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 15 original files, the MIT licence and an attribution note.

    fluidsim.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip fluidsim.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip fluidsim.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Give the agent the physical equations, boundary conditions, units and acceptance criteria up front; the skill stops if they are missing
  • Always run the tiny serial pilot and refine grid and time step before preparing any MPI job
  • Keep the generated uv.lock, config, logs and output checksums so the run can be reproduced

What's inside

  • references/advanced_features.md
  • references/installation.md
  • references/output_analysis.md
  • references/parameters.md
  • references/simulation_workflow.md
  • references/solvers.md
  • scripts/__init__.py
  • scripts/_common.py
  • scripts/_profiles.py
  • scripts/_schema.py
  • scripts/budget_summary.py
  • scripts/grid_resource_estimator.py
  • scripts/output_inventory.py
  • scripts/restart_compatibility.py
  • SKILL.md

Redistributed unmodified from K-Dense-AI/scientific-agent-skills under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.