skills.rest
isaaccorley
isaaccorleyCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

geoparquet-validation

Validate and optimize GeoParquet files with gpio commands and DuckDB transforms.

66|10|Updated Mar 19, 2026
Search Tags:#validation#optimization#gpio#duckdb#geoparquet#spatial indexing#stac
One-click install
npx skills add https://github.com/isaaccorley/geospatial-skills --skill geoparquet-validation
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: geoparquet-validation
Source: https://github.com/isaaccorley/geospatial-skills/tree/main/plugins/geoparquet-validation/skills/geoparquet-validation
Command: npx skills add https://github.com/isaaccorley/geospatial-skills --skill geoparquet-validation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

GeoParquet datasets often fail spec expectations or perform poorly in query engines unless they are validated and optimized with consistent metadata, spatial ordering, and compression settings.

Core Features & Use Cases

  • Inspect and audit GeoParquet metadata using a gpio-first workflow to quickly summarize dataset structure and characteristics.
  • Validate and auto-fix GeoParquet issues with gpio check all, producing corrected outputs when needed.
  • Optimize for distribution and query performance by applying zstd compression (level 15), Hilbert spatial sorting, bbox covering metadata, and appropriate row-group sizing, plus partitioning and STAC publishing for large datasets.
  • Use DuckDB for advanced SQL transforms when the workflow requires custom query logic before final GeoParquet validation.

Quick Start

Use the geoparquet-validation skill to validate and fix an output dataset by running: gpio check all input.parquet --fix --output fixed.parquet

Frequently Asked Questions about geoparquet-validation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate a GeoParquet file for spec compliance?▼

Validate GeoParquet spec compliance by running the gpio check all command on your input file. This inspects dataset metadata and structure, and adding the --fix flag with --output automatically corrects issues to produce a compliant file.

What's the best way to optimize GeoParquet for query performance?▼

Optimize GeoParquet by applying zstd level 15 compression, Hilbert spatial sorting, bbox covering metadata, and tuned row-group sizing. These settings enhance spatial indexing and distribution for significantly faster query performance.

Can I use DuckDB for custom transforms before GeoParquet validation?▼

Use DuckDB for advanced SQL transforms before final GeoParquet validation. This supports custom query logic and complex data manipulation within the gpio-centered workflow before applying spec compliance checks and optimization.

Does gpio support partitioning and STAC publishing for large datasets?▼

gpio supports partitioning and STAC publishing workflows for large GeoParquet datasets. Use the gpio publish command to distribute optimized data chunks and generate SpatioTemporal Asset Catalog items from validated outputs.

How do I inspect and audit GeoParquet metadata?▼

Inspect and audit GeoParquet metadata using the gpio inspect command to quickly summarize dataset structure and characteristics. This provides a detailed audit of spatial properties and configuration before running full validation checks.

Related Skills

Explore More Data & Analytics Skills→
spqwspqw

observable-framework-lib-shapefile

Convert ESRI shapefiles into GeoJSON FeatureCollection objects for Observable Framework projects.

Community
Basic
four43four43
4

stac

Design and validate STAC catalogs, collections, and items with JSON/GeoJSON compliance.

Community
Advanced
plurigridplurigrid
60

duckdb-spatial

Enable geospatial analysis in DuckDB with H3 indexing and spatial queries.

Official
Advanced
jasrajtulsijasrajtulsi

geopandas

Analyze geospatial vector data with GeoPandas for spatial workflows.

Community
Advanced