🌍 Geoscience Skills

Portable geoscience skills for Codex, Claude Code, GitHub Copilot, Gemini CLI, Windsurf, OpenCode, Cline, Roo Code, OpenClaw, and other coding agents using the Agent Skills format.

30 domain skills + 5 workflows + 1 discovery skill. The same skill files are shared across agents; platform commands, hooks, and subagents are optional. See the verification results and compatibility matrix.

🎯 Capabilities at a Glance

⚡ Quick Examples

"Read this SEG-Y file and show the first 10 traces"
"Calculate water saturation from these well logs using Archie equation"
"Build a 3D geological model with two faulted horizons"
"Invert this ERT survey and plot the resistivity section"
"Compute variogram and run kriging on this spatial data"
"Load this NetCDF climate file and compute monthly anomalies"
"Create a chondrite-normalized REE spider diagram"

📦 Installation

Upstream skills CLI (recommended)

Run from the project where you want to use the skills. The installer supports
multiple coding agents and manages their destination directories.

# Inspect all domain, workflow, and routing skills
npx skills add SteadfastAsArt/geoscience-skills --full-depth --list

# Select skills and target agents interactively
npx skills add SteadfastAsArt/geoscience-skills --full-depth

# Install a starting set for multiple agents
npx skills add SteadfastAsArt/geoscience-skills --full-depth \
  --skill using-geoscience-skills lasio segyio --agent codex claude-code

# Install the whole collection for one agent
npx skills add SteadfastAsArt/geoscience-skills --full-depth \
  --skill '*' --agent gemini-cli

# Install a workflow and the domain skills needed for it
npx skills add SteadfastAsArt/geoscience-skills --full-depth \
  --skill well-log-evaluation lasio dlisio welly petropy striplog pyvista \
  --agent github-copilot

Keep --full-depth to include workflows nested under workflows/. Add --global
for user scope; use --copy if you prefer copies to symlinks. Choosing a workflow
does not automatically install its complementary skills or Python dependencies.
Other targets include windsurf, opencode, cline, roo, and openclaw;
consult the upstream supported-agent list.

npx skills list
# Explicitly update installed skills when desired
npx skills update

From a local checkout

git clone https://github.com/SteadfastAsArt/geoscience-skills.git
# Run this in your target project; replace the path with your checkout location.
npx skills add /path/to/geoscience-skills --full-depth --agent codex

For manual installation, copy each selected skill directory to a directory
supported by your agent. Preserve its SKILL.md, references/, and scripts/.
For a workflow, copy workflows/<name>/ as <name>/ alongside the domain skills.
Do not copy the whole repository into an agent's skill directory. Platform
configuration and optional role guides are separate from skill installation.
See platform notes and the manual reading fallback.

Python dependencies

Install the packages needed for your task in its Python environment. For example:

# LAS inspection and conversion
python -m pip install lasio pandas

# SEG-Y inspection and subsetting
python -m pip install segyio numpy

Skill metadata.dependencies records library requirements; installing a skill
does not install or validate those packages. See SKILLS.md for
additional domain-specific package lists.

🧠 30 Domain Skills

By Popularity (GitHub Stars)

By Domain

Seismic & Seismology     → obspy, segyio, disba
Well Logs & Petrophysics → lasio, welly, dlisio, striplog, petropy
3D Geological Modelling  → gempy, loopstructural, gemgis
Geophysical Inversion    → simpeg, devito, pylops, pygimli
Potential Fields         → harmonica
Rock Physics             → bruges
Geostatistics            → verde, geostatspy, scikit-gstat, gnnwr
Hydrology                → pastas
Surface Processes        → landlab
Structural Geology       → mplstereonet
Geochemistry             → pyrolite
Near-surface Geophysics  → gprpy, mtpy
Data Formats             → xarray (NetCDF/HDF5/Zarr)
Visualization            → pyvista

📋 Full details: SKILLS.md

🔧 Usage

Describe the task naturally, or select an installed skill using your agent's
skill interface:

• "Use lasio to inspect the headers and curves in this LAS file."
• "Use well-log-evaluation to evaluate these logs."
• "Use using-geoscience-skills to choose the tools for this task."

The router selects domain and workflow skills by name. Workflows can run within
one agent session and do not require a particular delegation tool. Only the
references and workflow stages needed for the task should be loaded.

Claude Code users working in this checkout can also use the optional aliases
in .claude/commands/: /seismic-workflow, /well-analysis, /model-3d,
/inversion-workflow, and /spatial-gridding. These aliases and the local
SessionStart hook are not installed by the generic skills CLI.

📊 Coverage

Verification results

Recorded on 2026-09-14 for implementation
db5156c.

The Codex tasks explicitly select skills from a catalog; native automatic
discovery and activation remain untested. Claude Code retains format and
installation support, with runtime evaluation excluded from this round.
Scientific tests currently run on Linux. See the next priorities
for remaining domain audits, agent checks and field-data coverage.

🔄 Workflow Skills

Multi-step workflows that chain domain skills together:

The audited examples have separate scientific regression checks
using generated LAS/SEG-Y files, elastic logs, geological/inversion models, and
published GNSS station data. These check numerical
outputs, coordinates and uncertainty assumptions. Recorded Codex task evaluations
separately check skill selection and produced files.

🤖 Optional Role Guides

The files in agents/ provide optional role guidance. A generic skill installation
does not register them as subagents; use them explicitly when available.

🤝 Contributing

PRs welcome! See CONTRIBUTING.md for the full guide, including:

• Step-by-step instructions for adding a new skill
• Portable frontmatter and project metadata conventions
• Task boundaries, resource loading, and scientific validation guidance
• Recursive skill validation, generated platform manifests, and installation smoke tests

See docs/ROADMAP.md for planned skills and infrastructure improvements.

Dependency maintenance describes the weekly
registry report and the checks required before adopting new library or installer versions.

📚 Resources

• Source: awesome-open-geoscience
• Skills Spec: Agent Skills specification
• Community: Software Underground

📄 License

MIT © 2024

The bundled Alps GNSS data retain
their original CC BY 3.0 and curated-data CC BY 4.0 licenses and attribution.