Skip to content

SteadfastAsArt/geoscience-skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

9 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌍 Geoscience Skills

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

Skills License


🎯 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


πŸ“„ License

MIT Β© 2024

About

🌍 30 AI-powered geoscience skills for Claude Code, Cursor & GitHub Copilot. Seismic, well logs, 3D modelling, inversion, geostatistics, spatial regression, NetCDF, and more.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages