Skip to content

fredrocks/geoscience-skills

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

5 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: Clone Repository

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/

Option 2: OpenSkills

npx openskills install geoscience-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.


🧠 29 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
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 29
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

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

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 100.0%