Agent skill

Marine Carbonate Chemistry

by K-Dense-AI in K-Dense-AI/scientific-agent-skills

Solves seawater carbonate chemistry with PyCO2SYS for chemical oceanography, ocean acidification, and marine carbon-cycle research.

MITAuto-check passedResearch & Science

Install Marine Carbonate Chemistry

skills CLI
$ npx skills add K-Dense-AI/scientific-agent-skills --skill marine-carbonate-chemistry -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install K-Dense-AI/scientific-agent-skills marine-carbonate-chemistry --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/K-Dense-AI/scientific-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/marine-carbonate-chemistry .claude/skills/marine-carbonate-chemistry && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
marine-carbonate-chemistry
GitHub stars
48k
Used in
1 other repo
Token cost
~2.4k tokens
SKILL.md length
1,000 words
Files
4 (incl. scripts, references)
Skills in repo
153
Repo updated
First seen
Licence
MIT

At a glance

Solves seawater carbonate chemistry with PyCO2SYS for chemical oceanography, ocean acidification, and marine carbon-cycle research.

  • Works in 5 steps: Prepare paired measurements. Use the… → Choose equilibrium constants. Read → Solve with scripts/solve_carbonate.py.… → …
  • Paired total alkalinity
  • SKILL.md covers When to use, Establish the measurement…, Install and Workflow, plus 3 more sections
  • Runs Python scripts from its folder; calls uv and python

What it does

Marine Carbonate Chemistry is an agent skill from K-Dense-AI/scientific-agent-skills. Solves seawater carbonate chemistry with PyCO2SYS for chemical oceanography, ocean acidification, and marine carbon-cycle research. Use for paired total alkalinity, dissolved inorganic carbon, pH, or seawater pCO2/fCO2 measurements; carbonate speciation; aragonite and calcite saturation; Revelle factors; lab-to-in-situ temperature and pressure corrections; and measurement uncertainty propagation. Applies to carbonate-system calculations, not general aqueous speciation or air-sea gas-flux estimation.

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts and reference files (for example `references/chemistry-decisions.md`, `references/input-and-results.md` and `scripts/solve_carbonate.py`). Compatibility notes: Requires Python 3.13 with PyCO2SYS 1.8.3.4 and NumPy. Network access is needed only to install packages or obtain external data; bundled calculations run…

It sits in Research & Science, covering Physical and earth sciences and Drug discovery and cheminformatics. The repository describes itself as: Turn any AI agent into an AI Scientist. The 1 Agent Skills library for science, used by 250,000+ scientists worldwide. 177 ready-to-use validated skills plus 100+ scientific… The licence is MIT.

When your agent uses it

  • Paired total alkalinity
  • Dissolved inorganic carbon
  • Seawater pCO2/fCO2 measurements
  • Carbonate speciation

Example prompts

  • “Use the marine-carbonate-chemistry skill to solve seawater carbonate chemistry with PyCO2SYS for chemical oceanography, ocean acidification, and…”
  • “/marine-carbonate-chemistry”

Requirements

  • Python 3
  • Compatibility (from SKILL.md): Requires Python 3.13 with PyCO2SYS 1.8.3.4 and NumPy. Network access is needed only to install packages or obtain external data; bundled calculations run locally without credentials.

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Prepare paired measurements. Use the schema in
  2. Choose equilibrium constants. Read
  3. Solve with scripts/solve_carbonate.py. It validates the full input table, solves
  4. Review flags and consistency. Inspect calibration-range and gas-pressure flags,
  5. Report at the intended conditions. Results ending _out describe the supplied

What it can do on your machine

Read from SKILL.md and the folder at commit 92ace75. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • uv
    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • pyco2sys.readthedocs.io
    • mvdh.xyz
    • github.com
    • doi.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires Python 3.13 with PyCO2SYS 1.8.3.4 and NumPy. Network access is needed only to install packages or obtain external data; bundled calculations run locally without credentials.

    From compatibility in the SKILL.md frontmatter.

Context cost

Marine Carbonate Chemistry loads about 2.4k tokens when it runs, and up to ~5.2k if it reads all its reference files. Until then it costs about 133 tokens; SKILL.md has 1,000 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~133
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from K-Dense-AI/scientific-agent-skills at commit 92ace75, republished under its MIT licence (© K-Dense-AI). 1,000 words, ~2,387 tokens.

Download SKILL.mdSave it as .claude/skills/marine-carbonate-chemistry/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
marine-carbonate-chemistry
description
Solves seawater carbonate chemistry with PyCO2SYS for chemical oceanography, ocean acidification, and marine carbon-cycle research. Use for paired total alkalinity, dissolved inorganic carbon, pH, or seawater pCO2/fCO2 measurements; carbonate speciation; aragonite and calcite saturation; Revelle factors; lab-to-in-situ temperature and pressure corrections; and measurement uncertainty propagation. Applies to carbonate-system calculations, not general aqueous speciation or air-sea gas-flux estimation.
compatibility
Requires Python 3.13 with PyCO2SYS 1.8.3.4 and NumPy. Network access is needed only to install packages or obtain external data; bundled calculations run locally without credentials.
license
MIT
metadata.version
1.1
metadata.skill-author
K-Dense Inc.
metadata.upstream-version
PyCO2SYS 1.8.3.4
metadata.last-reviewed
2026-10-01

Marine Carbonate Chemistry

Turn two independent seawater carbonate measurements into a reproducible speciation table, mineral saturation estimates, and a record of the calculation assumptions. Targets PyCO2SYS 1.8.3.4, tested with Python 3.13 and NumPy 2.5.3. As reviewed on 2026-10-01, this remains the stable PyPI release. The v2 documentation is for a beta with breaking changes; use the v1 documentation for this pin.

When to use

  • Analyze bottle samples, shipboard carbonate measurements, or acidification experiments.
  • Calculate total-scale pH, seawater pCO2/fCO2, carbonate ion, aragonite/calcite saturation state, or the Revelle factor from a valid measured pair.
  • Convert a system determined at laboratory conditions to specified ocean conditions.
  • Quantify how stated measurement uncertainties affect the calculated results.

This workflow concerns seawater carbonate equilibria. Freshwater, porewaters with substantial uncharacterized alkalinity, brines outside the selected calibration range, and reaction/transport models require additional chemistry and validation. Do not infer an air-sea flux or atmospheric carbon removal from a carbonate equilibrium alone.

Establish the measurement contract

Before running a solver, identify the two measured variables, their units, quality flags, and their temperature/pressure basis. Retain a separate source table containing station, depth, timestamps, methods, reference materials, and original QC codes, joined by sample ID. Do not turn missing values or rejected measurements into zero.

QuantityRequired convention
Total alkalinity (TA), DIC, nutrientsmicromol per kg seawater, not per litre or kg water
SalinityPractical Salinity, not Absolute Salinity in g/kg
TemperatureIn-situ/measurement temperature in degrees Celsius, not potential or Conservative Temperature
PressureSea pressure in dbar; surface sample is 0, not 1 atmosphere
pHDeclared total, seawater, free, or NBS scale, at the declared measurement conditions
pCO2 / fCO2Seawater partial pressure / fugacity in microatm; these are distinct quantities

TA and DIC remain constant during the solver's temperature/pressure conversion for a closed sample. pH and gas parameters change. Two inputs measured at different conditions cannot simply share one temperature value. Establish a consistent measurement basis first. Temperature correction does not repair sample changes caused by gas exchange, biology, evaporation, or mineral dissolution/precipitation.

Use two independent carbonate parameters. pCO2 plus fCO2 is not an independent pair. Three or more measurements enable an overdetermination check: solve independent pairs and compare predicted versus measured third parameters, including their uncertainty. Do not average inconsistent solutions to hide a calibration or scale mismatch.

Install

Create a dedicated environment in the user's working directory:

bash
uv venv --python 3.13 .venv
uv pip install --python .venv/bin/python "PyCO2SYS==1.8.3.4" "numpy==2.5.3"

On Windows the environment's interpreter is .venv/Scripts/python.exe. The commands below use the POSIX interpreter path. Set the shell variable SKILL_DIR to this installed skill's directory. Keep inputs and generated outputs in the working directory.

Workflow

  1. Prepare paired measurements. Use the schema in references/input-and-results.md. Resolve units and quality flags before creating the input file. Supply phosphate and silicate explicitly; zero is an assumption to justify, not a missing-data code.
  2. Choose equilibrium constants. Read references/chemistry-decisions.md for pH scales, carbonic-acid constants, borate, saturation interpretation, and uncertainty limits. Match the study's validated convention and report it. The helper supports carbonic-acid options 10 and 15; other systems require a separately verified direct PyCO2SYS call.
  3. Solve with scripts/solve_carbonate.py. It validates the full input table, solves the pair, checks finite outputs and DIC species balance, then writes carbonate.csv and provenance.json into a new output directory.
  4. Review flags and consistency. Inspect calibration-range and gas-pressure flags, carbonate balance, measured-third-parameter residuals when available, and controls. A successful solve does not validate the sample, constants, or measurement method.
  5. Report at the intended conditions. Results ending _out describe the supplied output temperature/pressure. Unsuffixed results describe input conditions. Gas results retain the helper's uncorrected hydrostatic gas convention (see below). Include parameter pair, pH scale, units, constants, nutrient assumptions, uncertainty scope, software versions, and excluded/flagged samples with the result table.
Show full SKILL.md (392 more words)Show less

Worked example: closed-sample condition correction

The following values are synthetic, not field observations. Save this as samples.csv in a working directory. The two samples differ only in DIC; the second represents a fixed-alkalinity CO2-addition comparison. Their measurements are at 25 C and 0 dbar; results are also requested at 10 C and 1000 dbar.

csv
sample_id,par1,par2,salinity,temperature,pressure,total_phosphate,total_silicate,temperature_out,pressure_out,u_par1,u_par2
baseline,2300,2000,35,25,0,0,0,10,1000,2,2
added_co2,2300,2100,35,25,0,0,0,10,1000,2,2

Run from that working directory:

bash
.venv/bin/python "$SKILL_DIR/scripts/solve_carbonate.py" samples.csv \
  --par1-type alkalinity --par2-type dic --k-carbonic 10 \
  --output-dir carbonate-results

For the baseline, the tested version gives input-condition total pH 8.045886, pCO2 396.958 microatm, and aragonite saturation 3.386201. At the specified output conditions, total pH is 8.241241 and aragonite saturation 2.605691. These rounded values are regression checks for this exact setup, not universal seawater benchmarks. With independent 2 micromol/kg uncertainties in TA and DIC only, u_pH_total is about 0.004580. This excludes equilibrium-constant and other input uncertainty. Both rows carry gas_pressure_correction_disabled_output: the output pH and mineral saturation include pressure effects, but the reported pCO2/fCO2 do not include the hydrostatic corrections to CO2 solubility and fugacity. Do not compare those gas values directly with a pressure-corrected subsurface sensor measurement.

For TA + measured pH, use --par2-type ph --ph-scale total only if the source explicitly identifies total-scale pH; replace par2 and u_par2 with the measured pH and its absolute standard uncertainty. A column named merely pH is insufficient to establish its scale.

Uncertainty and interpretation

Optional u_ input columns contain absolute one-standard-deviation uncertainties. They propagate to total pH, pCO2, and aragonite saturation at each requested condition. The helper assumes independent errors and treats unlisted inputs/constants as exact. For covariance, constants uncertainty, or strongly nonlinear uncertainty, follow the decision guide and validate a tailored propagation instead of calling these outputs a complete uncertainty budget.

Omega < 1 indicates thermodynamic undersaturation with respect to the named mineral. It does not establish a dissolution rate or an organism's response. A lower pH across unmatched samples is not by itself evidence of an anthropogenic acidification trend.

Sources and validation boundary

Repository tests exercise the pinned solver, independent-pair round trips, carbon balance, pH-scale equivalence, condition correction, Revelle-factor derivatives, gas-pressure conventions, uncertainty quadrature, CSV errors, and the worked example. The helper calls the local pyco2.sys Python API; it has no HTTP endpoints or authentication. Tests establish software behavior, not independent field-data validation; upstream's validation page also contains historical examples, including a removed pyco2.test interface.

© K-Dense-AI, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts, references) in skills/marine-carbonate-chemistry of K-Dense-AI/scientific-agent-skills.

  • SKILL.md
  • references/chemistry-decisions.md
  • references/input-and-results.md
  • scripts/solve_carbonate.py

Open the folder on GitHubat commit 92ace75

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in K-Dense-AI/scientific-agent-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Marine Carbonate Chemistry next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Marine Carbonate Chemistry compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Marine Carbonate Chemistry this skillK-Dense-AI/scientific-agent-skills48k1 repos~2.4kAutomated safety check: PassMIT
Antechamberjinzhezenggroup/computational-chemistry-agent-skills148—~3.2kAutomated safety check: PassLGPL-3.0-or-later
Chem Solution Mdlearningmatter-mit/AtomisticSkills176—~1.9kAutomated safety check: PassMIT
Chemgraphargonne-lcf/ChemGraph162—~2.7kAutomated safety check: PassApache-2.0
AstropyzLanqing/codex-claude-academic-skills4.7k13 repos~2.9kAutomated safety check: PassBSD-3-Clause
MolecodeAtomFlow-AI/MoleCode306—~1.9kAutomated safety check: PassMIT

Similar skills

  • Antechamber

    jinzhezenggroup/computational-chemistry-agent-skills

    A command-line tool in AmberTools for preparing small molecules or non-standard residues within GAFF/AMBER-compatible chemical space for molecular mechanics simulations, by automating atom/bond…

    148 GitHub stars~3.2k tokensUpdated 2 days ago
    Research & ScienceAuto-check passed
  • Chem Solution Md

    learningmatter-mit/AtomisticSkills

    Set up and run molecular dynamics simulations of molecules in explicit solvent boxes using Packmol for box construction and MLIPs for dynamics.

    176 GitHub stars~1.9k tokensUpdated 3 days ago
    Research & ScienceAuto-check passed
  • Chemgraph

    argonne-lcf/ChemGraph

    Develop, test, and extend ChemGraph -- an agentic framework for automated molecular simulations using LLMs, LangGraph, ASE, and MCP servers

    162 GitHub stars~2.7k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Astropy

    zLanqing/codex-claude-academic-skills

    Comprehensive Python library for astronomy and astrophysics.

    4.7k GitHub starsUsed in 13 repos~2.9k tokens
    Research & ScienceAuto-check passed
  • Molecode

    AtomFlow-AI/MoleCode

    A skill your agent uses for deterministic molecule understanding, graph-level editing, generation, and validation with MoleCode — an explicit Mermaid graph in which every atom and bond is a typed…

    306 GitHub stars~1.9k tokensUpdated 4 mo ago
    Research & ScienceAuto-check passed
  • Pymatgen

    zLanqing/codex-claude-academic-skills

    Materials science toolkit. An agent skill from zLanqing/codex-claude-academic-skills.

    4.7k GitHub starsUsed in 11 repos~5k tokens
    Research & ScienceAuto-check passed

More from K-Dense-AI/scientific-agent-skills

All 153 skills in this repo
  • 13C Metabolic Flux Analysis

    K-Dense-AI/scientific-agent-skills

    Estimates reaction fluxes inside cells from steady-state carbon-13 labeling data with a bundled mfapy-based solver, and reports which fluxes the data pin down.

    48k GitHub starsUsed in 1 repo~3.2k tokens
    Auto-check passed
  • Analytical Method Validation Planner

    K-Dense-AI/scientific-agent-skills

    Plans, runs, and documents analytical method validation, verification, or transfer studies under ICH Q2(R2)/Q14, USP, ICH M10, CLSI EP, or ISO/IEC 17025.

    48k GitHub starsUsed in 1 repo~4.9k tokens
    Auto-check: notes
  • Cantera Ignition Delay

    K-Dense-AI/scientific-agent-skills

    Runs Cantera constant-volume or constant-pressure ignition simulations and reports temperature-based ignition delay with mechanism provenance and checks.

    48k GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed
  • DiffDock Molecular Docking

    K-Dense-AI/scientific-agent-skills

    Predicts how small molecules bind to a protein with DiffDock, covering batch docking, pose ranking by confidence and checks on the results; not for binding affinity.

    48k GitHub starsUsed in 1 repo~3k tokens
    Auto-check: notes
  • HypoGeniC Hypothesis Generation

    K-Dense-AI/scientific-agent-skills

    Plans and audits runs of the HypoGeniC and HypoRefine packages, which propose hypotheses from labeled text datasets, with local checks before any model call.

    48k GitHub starsUsed in 1 repo~3.6k tokens
    Auto-check: notes
  • ISO Standards Readiness Evidence

    K-Dense-AI/scientific-agent-skills

    Organizes scope, controlled documents, risk files and traceability into draft evidence for human review against ISO 13485, 14971, 17025 and 15189.

    48k GitHub starsUsed in 1 repo~4.6k tokens
    Auto-check: notes

Questions about Marine Carbonate Chemistry

What does Marine Carbonate Chemistry do?

Solves seawater carbonate chemistry with PyCO2SYS for chemical oceanography, ocean acidification, and marine carbon-cycle research. Marine Carbonate Chemistry is an agent skill from K-Dense-AI/scientific-agent-skills. Solves seawater carbonate chemistry with PyCO2SYS for chemical oceanography, ocean acidification, and marine carbon-cycle research.

When should I use Marine Carbonate Chemistry?

Marine Carbonate Chemistry fits situations like: paired total alkalinity; dissolved inorganic carbon; seawater pCO2/fCO2 measurements; carbonate speciation.

How do I install Marine Carbonate Chemistry in Claude Code?

Run `npx skills add K-Dense-AI/scientific-agent-skills --skill marine-carbonate-chemistry -a claude-code`. Or copy the skill folder (skills/marine-carbonate-chemistry in K-Dense-AI/scientific-agent-skills) into .claude/skills/marine-carbonate-chemistry in your project. Claude Code loads it when a task matches its description.

How do I install Marine Carbonate Chemistry in Codex?

Run `npx skills add K-Dense-AI/scientific-agent-skills --skill marine-carbonate-chemistry -a codex`. Or copy the skill folder (skills/marine-carbonate-chemistry in K-Dense-AI/scientific-agent-skills) into .agents/skills/marine-carbonate-chemistry in your project. Codex loads it when a task matches its description.

Can I use Marine Carbonate Chemistry in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add K-Dense-AI/scientific-agent-skills --skill marine-carbonate-chemistry -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/marine-carbonate-chemistry, .gemini/skills/marine-carbonate-chemistry, .github/skills/marine-carbonate-chemistry and .opencode/skills/marine-carbonate-chemistry in your project.

What does Marine Carbonate Chemistry need to run?

Going by SKILL.md and its folder, Marine Carbonate Chemistry needs Python for the scripts in its folder and the command-line tools its instructions call (uv and python). Our summary lists: Python 3. Compatibility (from SKILL.md): Requires Python 3.13 with PyCO2SYS 1.8.3.4 and NumPy. Network access is needed only to install packages or obtain external data; bundled calculations run locally without credentials..

Does Marine Carbonate Chemistry access the network?

SKILL.md names 4 domains. As links in the text: pyco2sys.readthedocs.io, mvdh.xyz, github.com and doi.org. This is read from the text; nothing was executed.

Is Marine Carbonate Chemistry safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Marine Carbonate Chemistry use?

Marine Carbonate Chemistry is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Marine Carbonate Chemistry use?

About 2.4k tokens (SKILL.md is roughly 9.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.8k tokens, read only when the agent opens those files.

What are the alternatives to Marine Carbonate Chemistry?

Skills that share tags, products or a category with Marine Carbonate Chemistry: Antechamber (jinzhezenggroup/computational-chemistry-agent-skills, 148 stars), Chem Solution Md (learningmatter-mit/AtomisticSkills, 176 stars), Chemgraph (argonne-lcf/ChemGraph, 162 stars) and Astropy (zLanqing/codex-claude-academic-skills, 4.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Marine Carbonate Chemistry?

K-Dense-AI (a GitHub organization) maintains it in K-Dense-AI/scientific-agent-skills, which has 48,215 GitHub stars. The repository holds 153 skills in this directory. The repository was last updated on October 5, 2026.

Source: K-Dense-AI/scientific-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.