geoscience-skills
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/steadfastasart--geoscience-skills)HTML
<a href="/listings/steadfastasart--geoscience-skills"><img src="/api/listings/steadfastasart--geoscience-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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](https://github.com/vercel-labs/skills#supported-agents).
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](docs/COMPATIBILITY.md).
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](SKILLS.md) for additional domain-specific package lists.
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 492 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "name": "geoscience-skills",
- "owner": {
- "name": "Geoscience Skills"
- },
- "metadata": {
- "description": "48 geoscience skills for AI coding assistants covering seismic, well logs, geological modelling, geophysical inversion, geostatistics, spatial regression, and related workflows.",
- "version": "2.5.0"
- },
- "plugins": [
- {
- "name": "boule",
- "source": "./",
- "strict": false,
- "skills": [
- "./boule"
- ],
- "description": "Calculate reference-ellipsoid geometry, normal gravity and geodetic/geocentric coordinate conversions with Boule. Use for gravity reference corrections and planetary ellipsoids; this does not transform between geodetic datums or compute terrain corrections.",
- "version": "1.0.0"
- },
- {
- "name": "bruges",
- "source": "./",
- "strict": false,
- "skills": [
- "./bruges"
- ],
- "description": "Geophysical equations and rock physics calculations for seismic analysis. Use when the agent needs to: (1) Calculate AVO responses (Zoeppritz, Shuey, Aki-Richards), (2) Perform Gassmann fluid substitution, (3) Generate seismic wavelets (Ricker, Ormsby), (4) Compute reflectivity and synthetic seismograms, (5) Calculate elastic moduli from velocities, (6) Apply Gardner/Castagna empirical relations, (7) Model rock physics effects.",
- "version": "1.0.2"
- },
- {
- "name": "climate-analysis",
- "source": "./",
- "strict": false,
- "skills": [
- "./workflows/climate-analysis"
- ],
- "description": "Analyse labelled climate time series and gridded or station observations with checked calendars, aggregation, climatological baselines and spatial validation. Use for climate anomalies, regional summaries or station-to-grid analysis; distinguish descriptive analysis from future-time prediction.",
- "version": "1.0.1"
- },
- {
- "name": "devito",
- "source": "./",
- "strict": false,
- "skills": [
- "./devito"
- ],
- "description": "Symbolic PDE solver with automatic code generation for finite-difference computations. Use when the agent needs to: (1) Perform seismic wave propagation modeling, (2) Implement acoustic or elastic wave equations, (3) Run forward modeling for shot gathers, (4) Set up Full Waveform Inversion (FWI) workflows, (5) Implement Reverse Time Migration (RTM), (6) Create absorbing boundary conditions, (7) Generate optimized stencil code for CPUs/GPUs, (8) Solve custom PDEs with finite differences.",
- "version": "1.0.1"
- },
- {
- "name": "disba",
- "source": "./",
- "strict": false,
- "skills": [
- "./disba"
- ],
- "description": "Compute Rayleigh and Love wave phase/group dispersion and sensitivity kernels for one-dimensional isotropic layered Earth models. Use when forward modelling velocity profiles, comparing layered models, or preparing numerical derivatives for a separately defined inversion. Does not extract observed dispersion from waveforms or perform tomography.",
- "version": "1.0.2"
- },
- {
- "name": "discretize",
- "source": "./",
- "strict": false,
- "skills": [
- "./discretize"
- ],
- "description": "Create finite-volume meshes and discrete differential operators with discretize. Use for TensorMesh or TreeMesh geometry, cell/face/edge ordering, divergence, interpolation and meshes supporting SimPEG; use a physics solver for inversion itself.",
- "version": "1.0.0"
- },
- {
- "name": "dlisio",
- "source": "./",
- "strict": false,
- "skills": [
- "./dlisio"
- ],
- "description": "Read and parse DLIS (Digital Log Interchange Standard) and LIS (Log Information Standard) well log files. Use when the agent needs to: (1) Read/parse DLIS or LIS files, (2) Extract well log curves as numpy arrays, (3) Access file metadata and origin information, (4) Handle multi-frame or multi-file DLIS, (5) Convert DLIS to LAS or DataFrame, (6) Work with RP66 format well logs, (7) Process array or image log data.",
- "version": "1.0.2"
- },
- {
- "name": "ensaio",
- "source": "./",
- "strict": false,
- "skills": [
- "./ensaio"
- ],
- "description": "Fetch versioned Fatiando geoscience datasets with Ensaio and preserve their hashes, citations and data conventions. Use for reproducible sample-data acquisition and replacing supported RockHound datasets; the fetchers return paths for format-specific readers.",
- "version": "1.0.0"
- },
- {
- "name": "flopy",
- "source": "./",
- "strict": false,
- "skills": [
- "./flopy"
- ],
- "description": "Build, run, inspect and diagnose MODFLOW groundwater flow models with FloPy. Use for aquifer discretization, recharge and boundary conditions, hydraulic heads, groundwater budgets and MODFLOW 6 output; use Pastas for statistical head time series.",
- "version": "1.0.0"
- },
- {
- "name": "gemgis",
- "source": "./",
- "strict": false,
- "skills": [
- "./gemgis"
- ],
- "description": "Spatial data processing for geological modelling with GemPy. Use when the agent needs to: (1) Prepare spatial data for GemPy models, (2) Extract interface points from geological maps, (3) Process orientations/dip measurements, (4) Sample DEMs along profiles or cross-sections, (5) Convert between GIS formats and GemPy inputs, (6) Clip/transform vector/raster data for modeling, (7) Create model extents from geospatial bounds.",
- "version": "1.0.2"
- },
- {
- "name": "gempy",
- "source": "./",
- "strict": false,
- "skills": [
- "./gempy"
- ],
- "description": "3D structural geological modeling using implicit methods. Create geological models with faults, folds, and unconformities from surface points and orientations. Use when the agent needs to: (1) Build 3D geological models from surface contacts and orientations, (2) Model faults, unconformities, or intrusions, (3) Compute and visualize subsurface geology, (4) Export models to VTK or numpy arrays, (5) Generate gravity forward models, (6) Create cross-sections or 3D visualizations.",
- "version": "1.0.1"
- },
- {
- "name": "geolime",
- "source": "./",
- "strict": false,
- "skills": [
- "./geolime"
- ],
- "description": "Assess and maintain licensed GeoLime geological or mining-model workflows, checking the installed vendor API, drillhole conventions and model validation. Use when a project explicitly uses GeoLime; the public PyPI placeholder does not provide a working modelling API.",
- "version": "1.0.0"
- },
- {
- "name": "geological-modelling",
- "source": "./",
- "strict": false,
- "skills": [
- "./workflows/geological-modelling"
- ],
- "description": "3D geological modelling workflow from spatial data preparation through implicit surface modelling and 3D visualization. Use when building geological models from surface data, boreholes, or GIS inputs.",
- "version": "1.0.2"
- },
- {
- "name": "geophysical-inversion",
- "source": "./",
- "strict": false,
- "skills": [
- "./workflows/geophysical-inversion"
- ],
- "description": "Geophysical data inversion workflow from data loading through mesh creation, forward modelling, inversion, and result visualization. Use when inverting ERT, magnetics, gravity, or EM survey data.",
- "version": "1.0.2"
- },
- {
- "name": "geostatspy",
- "source": "./",
- "strict": false,
- "skills": [
- "./geostatspy"
- ],
- "description": "GSLIB-inspired geostatistics library for variogram analysis, kriging, and simulation. Use when the agent needs to: (1) Calculate experimental variograms, (2) Fit variogram models, (3) Perform simple/ordinary kriging, (4) Run sequential Gaussian simulation (SGSIM), (5) Apply normal score transforms, (6) Decluster spatial data, (7) Generate multiple realizations for uncertainty.",
- "version": "1.0.1"
- },
- {
- "name": "gnnwr",
- "source": "./",
- "strict": false,
- "skills": [
- "./gnnwr"
- ],
- "description": "Spatial and spatiotemporal regression with GNNWR (Geographically Neural Network Weighted Regression). Use when the agent needs to: (1) Build spatially varying coefficient regression models, (2) Analyze geographic non-stationarity in spatial data, (3) Generate spatial coefficient maps for publication, (4) Run spatiotemporal regression with GTNNWR, (5) Scale geographically weighted regression to large datasets (N > 10k) with KNN mode, (6) Diagnose spatial model performance with F-tests, AIC, and residual maps.",
- "version": "1.0.1"
- },
- {
- "name": "gprpy",
- "source": "./",
- "strict": false,
- "skills": [
- "./gprpy"
- ],
- "description": "Read and process ground-penetrating radar profiles using GPRPy. Use for sample-based dewow/background removal, auditable gain, time/depth scenarios, and radargram export with explicit acquisition units. SEG-Y input uses a separate segyio adapter; native GPRPy files are serialized sessions.",
- "version": "1.0.2"
- },
- {
- "name": "harmonica",
- "source": "./",
- "strict": false,
- "skills": [
- "./harmonica"
- ],
- "description": "Gravity and magnetic data processing and forward modelling using Fatiando a Terra. Use when the agent needs to: (1) Compute gravity forward models (point masses, prisms, tesseroids), (2) Apply terrain/Bouguer corrections, (3) Grid scattered potential field data with equivalent sources, (4) Perform upward/downward continuation, (5) Calculate magnetic anomalies from magnetized bodies, (6) Apply derivative filters (gradients, tilt angle), (7) Process regional or local gravity surveys.",
- "version": "1.0.1"
- },
- {
- "name": "hydrogeological-analysis",
- "source": "./",
- "strict": false,
- "skills": [
- "./workflows/hydrogeological-analysis"
- ],
- "description": "Combine groundwater observations, well logs, and meteorological stresses into a checked hydrogeological interpretation or groundwater-level model. Use for aquifer monitoring and recharge/pumping response analysis, with spatial flow modelling only when its geometry and boundary data are available.",
- "version": "1.0.1"
- },
- {
- "name": "landlab",
- "source": "./",
- "strict": false,
- "skills": [
- "./landlab"
- ],
- "description": "Landscape evolution and surface process modelling in Python. Build 2D numerical models for erosion, hydrology, soil transport, and geomorphology. Use when the agent needs to: (1) Model landscape evolution over time, (2) Simulate river/stream erosion, (3) Route water flow across terrain, (4) Model hillslope diffusion processes, (5) Simulate weathering and soil production, (6) Analyze drainage networks, (7) Combine multiple geomorphic processes, (8) Load/save DEM data for modeling.",
- "version": "1.0.1"
- },
- {
- "name": "lasio",
- "source": "./",
- "strict": false,
- "skills": [
- "./lasio"
- ],
- "description": "Read, write, and manipulate LAS (Log ASCII Standard) well log files for borehole geophysical and petrophysical data. Use when the agent needs to: (1) Read/parse LAS 1.2 or 2.0 files, (2) Extract well headers or curve data, (3) Convert LAS to DataFrame/CSV/Excel, (4) Create new LAS files from arrays, (5) Modify existing LAS files, (6) Handle problematic or malformed LAS files, (7) Batch process multiple well files.",
- "version": "1.0.2"
- },
- {
- "name": "loopstructural",
- "source": "./",
- "strict": false,
- "skills": [
- "./loopstructural"
- ],
- "description": "Build 3D geological models with implicit surfaces, faults, folds, and stratigraphic constraints from structural geology data. Use when the agent needs to: (1) Build 3D geological models from structural data, (2) Model fault networks and displacements, (3) Create folded geology representations, (4) Interpolate geological surfaces, (5) Export models to VTK for visualization, (6) Perform uncertainty analysis on geological models, (7) Evaluate model values on grids.",
- "version": "1.0.2"
- },
- {
- "name": "mplstereonet",
- "source": "./",
- "strict": false,
- "skills": [
- "./mplstereonet"
- ],
- "description": "Stereonet plots for structural geology using matplotlib. Create lower-hemisphere stereographic projections for orientation data. Use when the agent needs to: (1) Create stereonet plots for structural data, (2) Plot planes as great circles or poles, (3) Plot lineations with trend/plunge, (4) Generate density contours for orientations, (5) Calculate mean orientations and statistics, (6) Analyze fold axes with pi-diagrams, (7) Convert between strike/dip and trend/plunge formats.",
- "version": "1.0.1"
- },
- {
- "name": "mtpy",
- "source": "./",
- "strict": false,
- "skills": [
- "./mtpy"
- ],
- "description": "Read and validate magnetotelluric transfer functions with MTpy-v2. Use for EDI import, impedance uncertainty, apparent resistivity/phase, documented tensor rotations, response plots and preparation for modelling. External inversion solvers and raw time-series processing require separate tools and validation.",
- "version": "1.0.2"
- },
- {
- "name": "near-surface-geophysics",
- "source": "./",
- "strict": false,
- "skills": [
- "./workflows/near-surface-geophysics"
- ],
- "description": "Plan and validate near-surface interpretation from GPR, electrical resistivity tomography, or magnetotelluric data. Use when selecting acquisition-dependent processing and inversion branches, comparing survey results, or relating geophysical anomalies to independently supported geological hypotheses.",
- "version": "1.0.1"
- },
- {
- "name": "obspy",
- "source": "./",
- "strict": false,
- "skills": [
- "./obspy"
- ],
- "description": "Seismology data processing with ObsPy. Helps with reading seismic waveforms, filtering/processing time series, fetching data from FDSN services, and earthquake analysis. Use when the agent needs to: (1) Read seismic data formats (MiniSEED, SAC, GSE2, SEGY), (2) Filter or process waveforms, (3) Fetch data from IRIS/USGS/FDSN services, (4) Search for earthquakes by magnitude/location, (5) Plot seismograms or spectrograms, (6) Remove instrument response, (7) Analyze station metadata.",
- "version": "1.0.1"
- },
- {
- "name": "pastas",
- "source": "./",
- "strict": false,
- "skills": [
- "./pastas"
- ],
- "description": "Groundwater time series analysis and modelling using transfer function noise models. Use when the agent needs to: (1) Analyze groundwater level time series, (2) Model well responses to precipitation/pumping, (3) Calibrate aquifer parameters from head data, (4) Forecast or hindcast groundwater levels, (5) Decompose hydrological signals into components, (6) Compare response functions, (7) Perform model diagnostics and uncertainty analysis.",
- "version": "1.0.2"
- },
- {
- "name": "petropy",
- "source": "./",
- "strict": false,
- "skills": [
- "./petropy"
- ],
- "description": "Configure PetroPy fluid-property and multimineral formation evaluation from normalized LAS well logs. Use for calibrated porosity, water saturation, mineral and pore-volume estimation, missing-sample handling, and explicitly defined pay intervals. Requires documented log units, fluid parameters and mineral endpoints; standalone permeability correlations need separate methods.",
- "version": "1.0.2"
- },
- {
- "name": "pooch",
- "source": "./",
- "strict": false,
- "skills": [
- "./pooch"
- ],
- "description": "Data file fetching and caching for geoscience applications. Download sample datasets with automatic caching, checksum verification, and multiple download sources. Use when the agent needs to: (1) Download datasets from URLs or DOIs, (2) Cache files locally with automatic verification, (3) Verify file integrity with SHA256/MD5 hashes, (4) Extract compressed archives (ZIP, TAR, GZIP), (5) Create data registries for reproducible workflows, (6) Fetch from Zenodo or other repositories.",
- "version": "1.0.1"
- },
- {
- "name": "pygimli",
- "source": "./",
- "strict": false,
- "skills": [
- "./pygimli"
- ],
- "description": "Multi-method geophysical modelling and inversion framework. Use when the agent needs to: (1) Perform electrical resistivity tomography (ERT) inversion, (2) Run seismic refraction tomography (SRT), (3) Model induced polarization (IP) data, (4) Simulate ground penetrating radar (GPR), (5) Create finite element meshes for geophysical problems, (6) Perform joint inversions of multiple datasets, (7) Forward model geophysical responses, (8) Analyze time-lapse monitoring data.",
- "version": "1.0.1"
- },
- {
- "name": "pygmt",
- "source": "./",
- "strict": false,
- "skills": [
- "./pygmt"
- ],
- "description": "Make geographic maps and process geospatial grids with PyGMT and GMT, including projection, regions, grid registration and vector/raster export. Use for GMT cartography and map-ready scientific data; check the separate GMT shared library before plotting.",
- "version": "1.0.0"
- },
- {
- "name": "pyleoclim",
- "source": "./",
- "strict": false,
- "skills": [
- "./pyleoclim"
- ],
- "description": "Analyse paleoclimate proxy time series with Pyleoclim, including irregular sampling, spectra and comparisons across uncertain chronologies. Use for proxy Series and EnsembleSeries analysis, spectral peaks and age-model sensitivity; use xarray for gridded climate fields.",
- "version": "1.0.0"
- },
- {
- "name": "pylops",
- "source": "./",
- "strict": false,
- "skills": [
- "./pylops"
- ],
- "description": "Linear operators for large-scale inverse problems with matrix-free representations. Use when the agent needs to: (1) Define linear operators for forward/adjoint operations, (2) Solve inverse problems (deconvolution, imaging, tomography), (3) Apply signal processing transforms (FFT, convolution, derivatives), (4) Compose operators for complex workflows, (5) Perform regularized inversion with smoothness or sparsity constraints, (6) Process seismic or image data at scale.",
- "version": "1.0.1"
- },
- {
- "name": "pyrolite",
- "source": "./",
- "strict": false,
- "skills": [
- "./pyrolite"
- ],
- "description": "Geochemistry data analysis and visualization for igneous, metamorphic, and sedimentary rocks. Use when the agent needs to: (1) Create ternary diagrams for compositional data, (2) Plot REE spider diagrams with normalization, (3) Build TAS or other classification diagrams, (4) Apply log-ratio transforms to compositional data, (5) Calculate CIPW norms, (6) Generate Harker variation diagrams, (7) Compute element ratios and anomalies.",
- "version": "1.0.1"
- },
- {
- "name": "pyvista",
- "source": "./",
- "strict": false,
- "skills": [
- "./pyvista"
- ],
- "description": "3D visualization and mesh analysis for geoscience data using PyVista/VTK. Use when the agent needs to: (1) Create 3D visualizations of geological models, (2) Render seismic volumes or voxel data, (3) Visualize point clouds or well paths, (4) Plot surfaces and meshes in 3D, (5) Read/write VTK, STL, OBJ files, (6) Create cross-sections through 3D models, (7) Export publication-quality figures or interactive HTML.",
- "version": "1.0.1"
- },
- {
- "name": "rock-physics-avo",
- "source": "./",
- "strict": false,
- "skills": [
- "./workflows/rock-physics-avo"
- ],
- "description": "Rock physics and AVO analysis workflow from well log preparation through elastic property calculation, fluid substitution, AVO modelling, and synthetic seismogram generation. Use when performing rock physics studies or AVO feasibility analysis.",
- "version": "1.0.2"
- },
- {
- "name": "rockhound",
- "source": "./",
- "strict": false,
- "skills": [
- "./rockhound"
- ],
- "description": "Maintain or migrate legacy RockHound geoscience dataset downloads, caches and loaders such as PREM. Use when an existing project imports RockHound; prefer maintained Ensaio fetchers for supported new dataset workflows.",
- "version": "1.0.0"
- },
- {
- "name": "scikit-gstat",
- "source": "./",
- "strict": false,
- "skills": [
- "./scikit-gstat"
- ],
- "description": "Estimate and diagnose variograms, perform ordinary kriging, and validate spatial interpolation with SciKit-GStat. Use for empirical or directional variograms, covariance-model comparison and kriging prediction/variance; use PyKrige or GSTools when the task requires universal kriging or external drift.",
- "version": "1.0.2"
- },
- {
- "name": "segyio",
- "source": "./",
- "strict": false,
- "skills": [
- "./segyio"
- ],
- "description": "Read, write, and manipulate SEG-Y seismic data files. Fast C library with Python bindings for trace, header, inline, and crossline access. Use when the agent needs to: (1) Read/inspect SEG-Y files, (2) Extract trace data or headers, (3) Access 3D survey data by inline/crossline, (4) Create new SEG-Y files from arrays, (5) Modify existing SEG-Y files, (6) Extract subsets of seismic data, (7) Read/write Seismic Unix format.",
- "version": "1.0.2"
- },
- {
- "name": "segysak",
- "source": "./",
- "strict": false,
- "skills": [
- "./segysak"
- ],
- "description": "Read SEG-Y as labelled xarray datasets with SEGY-SAK, inspect header-defined survey dimensions and process seismic volumes lazily. Use for SEG-Y/xarray/Dask workflows; use segyio for exact low-level trace and header editing.",
- "version": "1.0.0"
- },
- {
- "name": "seismic-interpretation",
- "source": "./",
- "strict": false,
- "skills": [
- "./workflows/seismic-interpretation"
- ],
- "description": "End-to-end seismic interpretation workflow from SEG-Y loading through signal processing, rock physics, and visualization. Use when working with seismic data analysis pipelines.",
- "version": "1.0.2"
- },
- {
- "name": "simpeg",
- "source": "./",
- "strict": false,
- "skills": [
- "./simpeg"
- ],
- "description": "Simulation and Parameter Estimation in Geophysics. Framework for geophysical forward modeling and inversion. Use when the agent needs to: (1) Run geophysical inversions (DC resistivity, magnetics, gravity, EM), (2) Create forward models for potential fields or electromagnetic methods, (3) Build survey geometries and receiver configurations, (4) Design mesh discretizations for simulations, (5) Apply regularization and optimization to inverse problems, (6) Model subsurface physical properties from geophysical data.",
- "version": "1.0.1"
- },
- {
- "name": "striplog",
- "source": "./",
- "strict": false,
- "skills": [
- "./striplog"
- ],
- "description": "Create, visualize, and analyze lithological and stratigraphic logs for well data. Use when the agent needs to: (1) Create lithology columns from depth intervals, (2) Parse geological descriptions into structured logs, (3) Visualize stratigraphic columns with patterns and colors, (4) Perform well-to-well correlations, (5) Extract statistics like net-to-gross ratios, (6) Define rock type lexicons and legends, (7) Export lithology data to CSV/LAS/JSON.",
- "version": "1.0.1"
- },
- {
- "name": "using-geoscience-skills",
- "source": "./",
- "strict": false,
- "skills": [
- "./using-geoscience-skills"
- ],
- "description": "Discover and compose geoscience skills for Python coding tasks. Use when choosing a geoscience library, finding a skill for a data format or method, or planning work across seismic, well logs, geological modelling, inversion, and other geoscience domains.",
- "version": "1.0.2"
- },
- {
- "name": "verde",
- "source": "./",
- "strict": false,
- "skills": [
- "./verde"
- ],
- "description": "Spatial data gridding and interpolation with a machine-learning style API. Process geographic and Cartesian point data onto regular grids. Use when the agent needs to: (1) Grid scattered spatial data onto regular grids, (2) Interpolate point data using splines, linear, or cubic methods, (3) Process geographic coordinates with projections, (4) Reduce large datasets using block averaging, (5) Remove polynomial trends from spatial data, (6) Cross-validate gridding parameters, (7) Create processing pipelines with Chain, (8) Grid vector data like GPS velocities.",
- "version": "1.0.1"
- },
- {
- "name": "well-log-evaluation",
- "source": "./",
- "strict": false,
- "skills": [
- "./workflows/well-log-evaluation"
- ],
- "description": "Complete well log evaluation workflow from LAS/DLIS loading through QC, petrophysical analysis, lithology classification, and visualization. Use when performing formation evaluation from well log data.",
- "version": "1.0.2"
- },
- {
- "name": "welly",
- "source": "./",
- "strict": false,
- "skills": [
- "./welly"
- ],
- "description": "Subsurface well data analysis toolkit for loading, processing, and analyzing well logs, projects, and formation tops. Built on lasio with enhanced curve processing. Use when the agent needs to: (1) Load wells from LAS files with metadata, (2) Work with multi-well Projects, (3) Process curves (despike, smooth, resample, normalize), (4) Manage formation tops, (5) Export well data to DataFrame/LAS/CSV, (6) Perform cross-well analysis and QC.",
- "version": "1.0.2"
- },
- {
- "name": "xarray",
- "source": "./",
- "strict": false,
- "skills": [
- "./xarray"
- ],
- "description": "N-dimensional labeled arrays for geoscience data. Read/write NetCDF, work with climate and oceanographic datasets, perform multi-dimensional analysis with labeled coordinates. Use when the agent needs to: (1) Read/write NetCDF or Zarr files, (2) Work with multidimensional arrays with labeled dimensions, (3) Analyze climate, ocean, or atmosphere data, (4) Compute temporal aggregations (daily/monthly/annual means), (5) Perform area-weighted statistics, (6) Process large datasets with Dask, (7) Apply CF conventions to scientific data.",
- "version": "1.0.1"
- }
- ]
- }
README.md · README · 273 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # 🌍 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](https://agentskills.io/specification).**
- 39 domain skills + 8 workflows + 1 discovery skill. The same skill files are shared across agents; platform commands, hooks, and subagents are optional. See the [verification results](#verification-results) and [compatibility matrix](docs/COMPATIBILITY.md).
- [](SKILLS.md)
- [](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
- ### 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.
- ```bash
- # 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](https://github.com/vercel-labs/skills#supported-agents).
- ```bash
- npx skills list
- # Explicitly update installed skills when desired
- npx skills update
- ```
- ### From a local checkout
- ```bash
- 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](docs/COMPATIBILITY.md).
- ### Python dependencies
- Install the packages needed for your task in its Python environment. For example:
- ```bash
- # 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](SKILLS.md) for
- additional domain-specific package lists.
- ---
- ## 🧠 39 Domain Skills
- ### By Domain
- ```
- Seismic & Seismology → obspy, segyio, segysak, disba
- Well Logs & Petrophysics → lasio, welly, dlisio, striplog, petropy
- 3D Geological Modelling → gempy, loopstructural, gemgis, geolime (licensed)
- Geophysical Inversion → simpeg, devito, pylops, pygimli, discretize
- Potential Fields → harmonica, boule
- Rock Physics → bruges
- Geostatistics → verde, geostatspy, scikit-gstat, gnnwr
- Hydrology → pastas, flopy
- Surface Processes → landlab
- Structural Geology → mplstereonet
- Geochemistry → pyrolite
- Near-surface Geophysics → gprpy, mtpy
- Data Formats → xarray (NetCDF/HDF5/Zarr), pyleoclim
- Visualization → pyvista, pygmt
- Datasets → pooch, ensaio, rockhound (legacy)
- ```
- > 📋 Full details: [SKILLS.md](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
- | Metric | Value |
- |--------|-------|
- | Installable Skills | 48 (39 domain + 8 workflow + 1 router) |
- | File Formats Supported | SEG-Y, LAS, DLIS, NetCDF, HDF5, Zarr, GRIB, VTK |
- The [per-skill validation matrix](docs/VALIDATION_MATRIX.md) records test scopes
- for all 48 skills. Of 39 bundled scripts, 16 have declared execution tests and
- 23 have explicit coverage gaps. A mapping does not establish a passing run or
- validate an entire library; native-task evidence is listed separately.
- ---
- ## Verification results
- Updated **2026-10-25**. [PR #3](https://github.com/SteadfastAsArt/geoscience-skills/pull/3)
- and the subsequent P1–P3 delivery in
- [PR #5](https://github.com/SteadfastAsArt/geoscience-skills/pull/5) are merged.
- The workflow follow-up extends their scientific evidence; native Agent runs
- retain their original recorded revisions.
- | Check | Recorded result |
- | --- | --- |
- | Native Codex tasks | **LAS QC, SEG-Y subsetting and formation evaluation passed** without task prompts naming skills or catalog paths. Each run discovered all 48 skills and retained successful native skill-read evidence. See [agent evaluations](docs/AGENT_EVALUATIONS.md). |
- | Installation | **48 skills × nine targets passed locally** with skills CLI 1.5.26, including bundled resources. Linux/Windows CI runs the same checks; see [compatibility evidence](docs/COMPATIBILITY.md#verification-scope). |
- | September automated baseline | **268 checks**: 204 scientific across ten isolated environments, 61 lightweight and 3 evaluation-fixture readbacks. See [dated results and reproduction](docs/SCIENTIFIC_TESTING.md). |
- | October local follow-up | **12 SciKit-GStat scientific tests and 74 lightweight tests passed**. Added an eleventh isolated environment, coverage inventory gate and scientific runner that fails skipped tests. Current inventory is 293 tests; the other scientific environments and native agent tasks were not rerun in this follow-up. [Scope and commands](docs/SCIENTIFIC_TESTING.md). |
- | Field data | Published well logs, earthquake waveform and ERT observations now join GNSS, with licenses, units, holdout checks and explicit uncertainty limits. See [field-data validation](docs/FIELD_DATA_VALIDATION.md). |
- | Workflow execution | Groundwater head/stress data → Pastas hindcast; GPR/ERT/MT → checked processing or model diagnostics; NOAA TMAX → labelled climate outputs. Independent numerical, holdout and output-readback checks are recorded in the [hydro](docs/HYDRO_WORKFLOW_VALIDATION.md), [near-surface](docs/NEAR_SURFACE_WORKFLOW_VALIDATION.md) and [climate](docs/CLIMATE_WORKFLOW_VALIDATION.md) reports. |
- | Dependencies | Candidate NumPy/SciPy updates passed; incompatible pandas/setuptools combinations were rejected. The [report workflow ran successfully on main](https://github.com/SteadfastAsArt/geoscience-skills/actions/runs/34854160260). See [decisions](docs/DEPENDENCY_MAINTENANCE.md). |
- Claude runtime testing is excluded from this round. Other client availability
- and optional-adapter decisions are in the [platform assessment](docs/PLATFORM_ADAPTER_ASSESSMENT.md).
- Scientific execution is verified on Linux. GeoLime requires a licensed vendor
- runtime; RockHound is maintained here for legacy migration, with its failed
- upstream PREM URL documented. The [new collection report](docs/COLLECTION_VALIDATION.md)
- distinguishes the executed workflow cases from remaining field-calibration,
- sampling-metadata, joint-inversion and forecasting limits.
- ---
- ## 🔄 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 |
- | Hydrogeological Analysis | well logs + pastas; optional flopy | Groundwater head and aquifer hypotheses |
- | Near-surface Geophysics | gprpy + pygimli/simpeg + mtpy | Compare GPR, ERT and MT evidence |
- | Climate Analysis | xarray + verde; optional pyleoclim | Time/space analysis without validation leakage |
- The audited examples have separate [scientific regression checks](docs/SCIENTIFIC_TESTING.md)
- using generated LAS/SEG-Y files, elastic logs, geological/inversion models, and
- [published field data](docs/FIELD_DATA_VALIDATION.md). These check numerical
- outputs, coordinates and uncertainty assumptions. Recorded [Codex task evaluations](docs/AGENT_EVALUATIONS.md)
- 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.
- | Guide | Role |
- |-------|------|
- | data-qc-reviewer | Check well log, seismic, and spatial data quality |
- | geoscience-mentor | Guide skill and workflow selection |
- | cross-validation-reviewer | Review independent holdouts, uncertainty and model comparison |
- ---
- ## 🤝 Contributing
- PRs welcome! See **[CONTRIBUTING.md](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](docs/ROADMAP.md)** for completed priorities and remaining validation boundaries.
- [Dependency maintenance](docs/DEPENDENCY_MAINTENANCE.md) describes the weekly
- registry report and the checks required before adopting new library or installer versions.
- ---
- ## 📚 Resources
- - **Source**: [awesome-open-geoscience](https://github.com/softwareunderground/awesome-open-geoscience)
- - **Skills Spec**: [Agent Skills specification](https://agentskills.io/specification)
- - **Community**: [Software Underground](https://softwareunderground.org/)
- ---
- ## 📄 License
- MIT © 2024
- Bundled data retain their own licenses and attribution:
- - [Alps GNSS](tests/fixtures/field/alps_gps/ATTRIBUTION.md): original CC BY 3.0 and curated CC BY 4.0.
- - [Published well logs](tests/fixtures/field/well_logs/ATTRIBUTION.md): CC BY 4.0.
- - [GEOFON waveform and response](tests/fixtures/field/seismic_waveform/ATTRIBUTION.md): CC BY 4.0.
- - [Crescentino ERT](tests/fixtures/field/ert_survey/ATTRIBUTION.md): CC BY 4.0.
- Project-generated audit fixtures are explicitly synthetic and do not represent
- field observations.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.