geojson

Inspect, validate, summarize, and troubleshoot GeoJSON files and payloads, including FeatureCollection checks, geometry counting, bbox generation, coordinate...

Security Scan

The skill is internally consistent: it only requires Python, its instructions match the included script, and it performs read-only GeoJSON inspection with no network access or credential requests.

Purpose & Capability

The name/description (GeoJSON inspection, validation, bbox, coordinate checks) matches the provided script and SKILL.md. The only declared requirement is python3, which is proportionate to running the included Python helper.

Instruction Scope

Runtime instructions and examples are limited to parsing a file or inline JSON and running local validation/summary commands. The script reads only the provided file or JSON string, performs coordinate analysis, and prints JSON results. It does not attempt to read other system files, environment variables, or send data externally.

Install Mechanism

Install spec is a single Homebrew formula (python) to provide python3. This is a standard, proportional install for a Python-based helper; no untrusted downloads or archive extraction are used.

Credentials

The skill declares no environment variables, credentials, or config paths and the code does not access any secrets or env vars. No disproportionate or unrelated credentials are requested.

Persistence & Privilege

always is false and the skill does not request permanent/global agent changes. agents/openai.yaml allows implicit invocation (normal for skills) but there is no additional privilege escalation or cross-skill config modification.

Assessment

This skill appears safe for read-only GeoJSON inspection: it runs a local Python script that reads a path or JSON string and prints validation/summary results, with no network calls or secret access. If you will run it on untrusted GeoJSON files, consider executing in a sandbox or isolated environment (to avoid processing very large or maliciously crafted files). If you need reprojection, editing, or measurements, follow the SKILL.md advice to use a dedicated GIS tool (qgis) rather than this validator. If you require additional assurance, review the included scripts/geojson_tool.py source before installing.

Use this skill for practical GeoJSON inspection and validation.

This skill focuses on safe read-only analysis of GeoJSON structure and coordinates. For deterministic GIS conversion, reprojection, clipping, or raster/vector processing on files, hand off to qgis.

What This Skill Does

• Validate whether a JSON file or payload is plausible GeoJSON.
• Summarize top-level type, feature count, geometry types, and bbox.
• Flag obvious coordinate-range issues for longitude/latitude style data.
• Explain common GeoJSON mistakes such as malformed FeatureCollection, missing geometry, or wrong coordinate nesting.
• Recommend when EPSG:4326 assumptions are safe and when CRS clarification is required.

Standard Workflow

1. Confirm whether the input is a file path or inline JSON.
2. Parse the JSON and identify the top-level GeoJSON type.
3. Count features and geometry types.
4. Compute bbox from coordinates when possible.
5. Flag likely coordinate problems:
   • out-of-range longitude/latitude
   • swapped lat,lon vs lon,lat
   • mixed geometry structures
6. If the user needs file transformation, reprojection, or editing, switch to qgis.

Practical Commands

Summarize a GeoJSON file

python3 {baseDir}/scripts/geojson_tool.py summary --file ./data/sample.geojson

Validate a GeoJSON file

python3 {baseDir}/scripts/geojson_tool.py validate --file ./data/sample.geojson

Summarize inline GeoJSON

python3 {baseDir}/scripts/geojson_tool.py summary --json '{"type":"Point","coordinates":[116.4074,39.9042]}'

Decision Rules

• Assume GeoJSON coordinates are lon,lat when they represent geographic positions unless the source clearly says otherwise.
• Do not assume every GeoJSON file is WGS84 just because it is GeoJSON; verify source context if precision matters.
• GeoJSON CRS metadata is effectively absent in modern practice; prefer explicit prose in the answer when CRS is uncertain.
• If distance or area analysis is needed, recommend reprojection to a projected CRS before measurement.
• Treat malformed but parseable data as suspect; report the issue instead of silently guessing.

What To Return

• Top-level GeoJSON type.
• Feature count when applicable.
• Geometry type counts.
• Bounding box when coordinates are present.
• A short note about likely CRS/coordinate-order assumptions.
• Specific validation errors or suspicious patterns when found.

When Not To Use

• Reverse geocoding or coordinates-to-address lookup: use geocode.
• WGS84-specific CRS reasoning: use wgs84.
• Deterministic GIS processing, conversion, reprojection, or clipping: use qgis.
• CesiumJS rendering logic: use cesium.

OpenClaw + ClawHub Notes

• Keep examples generic and portable.
• Do not hardcode private datasets, machine paths, or secrets.
• For clawhub.ai publication, keep examples standards-based and version/changelog updates semver-driven.

Reference Docs In This Skill

• Read {baseDir}/references/geojson-notes.md for common structures, nesting rules, and failure cases.