🌍 Geoscience Skills

AI-powered geoscience assistant capabilities for Claude Code, Cursor, Windsurf, GitHub Copilot, and any agent supporting the Agent Skills spec.

🎯 Capabilities at a Glance

Domain	What You Can Do
🔬 Seismic	Read SEG-Y files, process waveforms, fetch earthquake data, compute dispersion curves
🛢️ Well Logs	Parse LAS/DLIS files, calculate porosity & saturation, create striplogs
🏔️ 3D Modelling	Build implicit geological models with faults and folds
📡 Inversion	Run ERT, seismic, gravity, magnetic inversions
🗺️ Geostatistics	Variograms, kriging, spatial interpolation, gridding
🌊 Climate/Ocean	NetCDF analysis, multi-dimensional arrays, time series
💧 Hydrology	Groundwater modelling, landscape evolution
🧪 Geochemistry	REE patterns, spider diagrams, classification plots
📊 Visualization	3D mesh rendering, stereonets, publication figures

⚡ 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

Option 1: npx skills (recommended)

# Install all skills to all detected agents
npx skills add SteadfastAsArt/geoscience-skills

# Install specific skills only
npx skills add SteadfastAsArt/geoscience-skills -s obspy -s gnnwr -s verde

# Install globally (all projects)
npx skills add SteadfastAsArt/geoscience-skills -g

# Target a specific agent
npx skills add SteadfastAsArt/geoscience-skills -a claude-code
npx skills add SteadfastAsArt/geoscience-skills -a cursor

Manage installed skills:

npx skills list       # List installed skills
npx skills check      # Check for updates
npx skills update     # Update to latest versions

Option 2: Manual install

git clone https://github.com/SteadfastAsArt/geoscience-skills.git

# For Claude Code
cp -r geoscience-skills/* ~/.claude/skills/

# For VS Code / GitHub Copilot
cp -r geoscience-skills/* .github/skills/

Python Dependencies

# Core (most common)
pip install obspy lasio xarray netcdf4 pyvista

# Full installation
pip install obspy segyio lasio welly gempy simpeg verde xarray pyvista pooch

📋 See SKILLS.md for domain-specific installation commands.

🧠 30 Integrated Skills

By Popularity (GitHub Stars)

Top Skills	Stars	Use Case
xarray	4.1k	NetCDF, climate data, multi-dimensional arrays
pyvista	3.5k	3D visualization, mesh analysis
obspy	1.3k	Seismology, waveforms, earthquake catalogs
gempy	1.2k	3D implicit geological modelling
devito	658	Finite-difference wave simulation
verde	648	Spatial gridding, ML-style interpolation
simpeg	607	Geophysical inversion framework

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

Slash Commands

/seismic-workflow   → Seismic data analysis pipeline
/well-analysis      → Well log evaluation pipeline
/model-3d           → 3D geological modelling pipeline
/inversion-workflow → Geophysical inversion pipeline
/spatial-gridding   → Spatial data gridding pipeline

Domain Skills

/obspy      → Seismology workflows
/lasio      → LAS file operations
/gempy      → 3D geological modelling
/xarray     → NetCDF and climate data
/pyvista    → 3D visualization

Natural Language

Just describe what you need:

"Process this miniseed file and remove instrument response"
"Create a Bouguer gravity anomaly map"
"Run ordinary kriging with a spherical variogram"

📊 Coverage

Metric	Value
Total Skills	30
Domains Covered	17
Combined GitHub Stars	18,000+
File Formats Supported	SEG-Y, LAS, DLIS, NetCDF, HDF5, Zarr, GRIB, VTK

🔄 Workflow Skills

Multi-step workflows that chain domain skills together:

Workflow	Skills Used	Use Case
Seismic Interpretation	segyio → obspy → bruges → pyvista	Seismic data analysis
Well Log Evaluation	lasio/dlisio → welly → petropy → striplog	Formation evaluation
Geological Modelling	gemgis → gempy/loopstructural → pyvista	3D model building
Geophysical Inversion	simpeg/pygimli → verde → pyvista	ERT, magnetics, gravity
Rock Physics & AVO	lasio/welly → bruges → segyio	AVO feasibility studies

🤖 Agents

Agent	Role
data-qc-reviewer	Check well log, seismic, and spatial data quality
geoscience-mentor	Guide skill and workflow selection

🤝 Contributing

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

Step-by-step instructions for adding a new skill
YAML frontmatter requirements (all 7 fields)
Quality checklist and tag conventions
Automated validation with python3 scripts/validate_skills.py

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

📚 Resources

Source: awesome-open-geoscience
Skills Spec: anthropics/skills
Community: Software Underground