ionworks-skills

Build a comprehensive multi-section data analysis report for battery cells whose measurements live on the Ionworks platform. Use when the user asks to "build a report", "summarize the data", "characterize cells", "create a data overview", "make an analysis PDF" for one or more cell designs — or when they hand over a dataset and ask "what's in it / what do we have / what does the BOL performance look like / how does it age". Produces a markdown + PDF with rate capability, DCIR, OCV, GITT/entropic, aging, and gap-analysis sections. Strongly prefer this skill whenever there is platform-resident measurement data and the user wants either a full report or any subset of these characterization sections.

Query the Ionworks API /discovery endpoints before any API operation. Use when the user asks to interact with the Ionworks API, battery data, cell specifications, measurements, simulations, pipelines, or UCP protocols. Triggers: "ionworks", "battery data", "cell spec", "measurement", "simulation", "pipeline", "UCP", "cycler", "SDK", "Python client".

Fit Equivalent Circuit Models (ECM) to battery cycling data and save the result as a Parameterized Model. Use when the user wants to parameterize an ECM, fit R0/RC pairs, fit OCV from cycling data, or turn measurements/files into a parameterized model. Triggers: "ECM", "equivalent circuit", "RC pair", "R0", "fit OCV", "ECM parameterization".

Build concentration-dependent electrolyte transport parameters (conductivity, diffusivity, cation transference number) from a material property dataset and feed them to a pipeline DirectEntry. Use when the user wants concentration-dependent electrolyte properties in a fit or simulation, fit a Landesfeind diffusivity curve to electrolyte data, or convert an electrolyte transport dataset into pybamm parameters. Triggers: "electrolyte conductivity", "electrolyte diffusivity", "transference number", "concentration-dependent", "Landesfeind", "electrolyte transport".

Install and configure the Ionworks Python SDK: pick the right package, set the API key, verify the install, and keep it up to date. Use when the user wants to install ionworks, set up the SDK for the first time, configure API credentials, check the installed version, or upgrade. Triggers: "install ionworks", "set up SDK", "API key", "IONWORKS_API_KEY", "upgrade ionworks", "pip install ionworks", "uv add ionworks", "getting started".

Work with battery cell data: specifications, instances, and measurements. Use when creating, reading, updating, or deleting cell specs, instances, or measurements, or when fetching time series, steps, or cycles data. Triggers: "cell spec", "cell instance", "measurement", "time series", "steps", "cycles", "battery data", "cell data".

Manage projects, studies, models, parameterized models, and optimizations. Use when the user wants to create or manage projects, organize simulations into studies, work with custom or parameterized models, or run optimizations. Triggers: "project", "study", "model", "parameterized model", "optimization", "custom model".

Process raw battery cycling data into the ionworks standardized format (parquet + JSON) or BDF. Use when the user wants to convert data from cyclers (Arbin, Maccor, Basytec, Neware, etc.), MATLAB files, CSVs, JSON, or any other raw format; adds a new open-source dataset; or mentions ionworksdata transforms, step summaries, the time_series/steps parquet format, or the BDF (.bdf) format.

Run a single-datafit, single-array-datafit, or single-validation pipeline via SimplePipeline. Use when the user wants to submit a pipeline config, run a fit (including per-temperature or per-SOC array fits) or validation as a single job, poll for results, or manage SimplePipeline runs. Triggers: "simple pipeline", "SimplePipeline", "single datafit", "array data fit", "fire and forget pipeline", "submit config".

Run electrochemical simulations with UCP protocols, and convert UCP protocols to vendor-native files (Maccor, Arbin, Neware, BioLogic, Novonix). Use when the user wants to simulate battery behavior, run protocol-based simulations, batch simulations with DOE, validate UCP protocols, retrieve simulation results, or export a UCP to a cycler's protocol format. Triggers: "simulation", "simulate", "protocol", "UCP", "DOE", "batch simulation", "design of experiments", "convert protocol", "Maccor", "Arbin", "Neware", "BioLogic", "Novonix".

Work with Ionworks simulation results: fetch time series and step data, understand the response shape, plot signals. Use when the user wants to analyse, plot, or extract numbers from a simulation result. Triggers: "simulation result", "sim output", "plot simulation", "time series", "simulation data".

Upload battery measurement data: time series, files, and properties. Use when the user wants to upload cycling data, parquet files, images, CSV data, or measurement properties to the Ionworks API. Triggers: "upload", "import data", "upload measurement", "upload time series", "upload file", "upload parquet", "create measurement".

Validate battery measurement data against the Ionworks platform's authoritative schemas and strict measurement checks — schema/metadata validation via the discovery API, column/dtype/monotonicity checks on parquet files, and the platform's strict `validate_measurement_data` validators on time series + steps. Use whenever the user wants to check data before uploading, audit data already on the platform, debug an upload that failed validation, or verify that processed parquet/JSON files conform to the canonical format. Triggers on "validate data", "check before upload", "validate parquet", "validate metadata", "schema check", "header audit", "strict validation", "validation errors", "MeasurementValidationError", or whenever a user is about to run `cell_measurement.create_or_get` and wants to be sure it'll succeed.