Agent skill

Spatial Operations

by VectorSpaceLab in VectorSpaceLab/AREX-Skill

A skill your agent uses when running GeoPandas spatial joins, nearest joins, overlays, clips, dissolves, spatial indexes, and Shapely-backed geometry analysis operations.

BSD-3-ClauseAuto-check passedData & Analytics

Install Spatial Operations

skills CLI
$ npx skills add VectorSpaceLab/AREX-Skill --skill spatial-operations -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install VectorSpaceLab/AREX-Skill spatial-operations --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/VectorSpaceLab/AREX-Skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/repositories/repo-skills/geopandas/sub-skills/spatial-operations .claude/skills/spatial-operations && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
spatial-operations
GitHub stars
328
Token cost
~884 tokens
SKILL.md length
353 words
Files
5 (incl. scripts, references)
Skills in repo
157
Repo updated
First seen
Licence
BSD-3-Clause

At a glance

A skill your agent uses when running GeoPandas spatial joins, nearest joins, overlays, clips, dissolves, spatial indexes, and Shapely-backed geometry analysis operations.

  • Works in 6 steps: Inspect .crs on every input before… → For metric operations (buffer, distance,… → Validate polygon inputs before overlay… → …
  • Running GeoPandas spatial joins
  • SKILL.md covers Read First, Route Here When, Route Elsewhere and Default Operating Rules, plus 2 more sections
  • Runs Python scripts from its folder; calls python

What it does

Spatial Operations is an agent skill from VectorSpaceLab/AREX-Skill. Use when running GeoPandas spatial joins, nearest joins, overlays, clips, dissolves, spatial indexes, and Shapely-backed geometry analysis operations.

Its SKILL.md is about 880 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `references/operations-reference.md`, `references/troubleshooting.md` and `references/workflows.md`).

It sits in Data & Analytics, covering Geospatial analysis. The repository describes itself as: A Skill Library for Automated Machine Learning. The licence is BSD-3-Clause.

When your agent uses it

  • Running GeoPandas spatial joins
  • Spatial indexes
  • Shapely-backed geometry analysis operations

Example prompts

  • “/spatial-operations”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Inspect .crs on every input before combining layers. Reproject, do not override, when coordinates need transformation.
  2. For metric operations (buffer, distance, dwithin, nearest thresholds), use a projected CRS with linear units.
  3. Validate polygon inputs before overlay or union. Use make_valid() when invalid geometry is an expected data-quality issue.
  4. Choose the predicate intentionally: intersects is broad; within/contains are directional; boundary-only relationships may surprise users.
  5. Expect join and overlay outputs to change row counts and add suffixes/index columns. Document cardinality and column naming.
  6. Use .sindex.valid_query_predicates to discover available spatial index predicates in the current environment.

What it can do on your machine

Read from SKILL.md and the folder at commit ac3fe1a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Spatial Operations loads about 884 tokens when it runs, and up to ~3.2k if it reads all its reference files. Until then it costs about 42 tokens; SKILL.md has 353 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~42
When it runs · the whole SKILL.md, loaded when a task matches
~884
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from VectorSpaceLab/AREX-Skill at commit ac3fe1a, republished under its BSD-3-Clause licence (© VectorSpaceLab). 353 words, ~884 tokens.

Download SKILL.mdSave it as .claude/skills/spatial-operations/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
spatial-operations
description
Use when running GeoPandas spatial joins, nearest joins, overlays, clips, dissolves, spatial indexes, and Shapely-backed geometry analysis operations.
disable-model-invocation
true
metadata.disco-role
operating
license
BSD 3-Clause

Spatial Operations

Use this sub-skill when the task combines, filters, aggregates, or transforms geometries with GeoPandas analysis APIs.

Read First

  • Operations reference: verified signatures and parameter notes for joins, overlay, clip, dissolve, spatial index, and common geometry methods.
  • Workflows: recipes for CRS-safe joins, nearest analysis, overlay/clip, dissolve, invalid-geometry repair, and metric operations.
  • Troubleshooting: fixes for CRS mismatch, unexpected join cardinality, invalid geometries, empty overlays, distance warnings, and spatial-index confusion.
  • spatial_operations_smoke.py: tiny deterministic check covering sjoin, overlay, clip, dissolve, and .sindex.

Route Here When

  • The task mentions sjoin, GeoDataFrame.sjoin, sjoin_nearest, predicate, lsuffix, rsuffix, distance_col, or spatial predicates.
  • The task asks for overlay, set operations (intersection, union, identity, symmetric_difference, difference), keep_geom_type, make_valid, or polygon validity repair.
  • The task uses clip, dissolve, explode, union_all, intersection_all, buffer, distance, dwithin, contains, within, intersects, nearest, or spatial index queries.
  • The user needs to choose a projected CRS for metric analysis, use a spatial index explicitly, or reason about output row/cardinality behavior.

Route Elsewhere

  • Use ../core-data-model/SKILL.md to create GeoDataFrames, repair active geometry columns, or understand CRS assignment versus reprojection basics.
  • Use ../io-formats/SKILL.md to read/write layers before or after operations.
  • Use ../mapping-geocoding/SKILL.md to visualize operation results.
  • Use ../validation-testing/SKILL.md for equality assertions or focused native tests.
Show full SKILL.md (156 more words)Show less

Default Operating Rules

  1. Inspect .crs on every input before combining layers. Reproject, do not override, when coordinates need transformation.
  2. For metric operations (buffer, distance, dwithin, nearest thresholds), use a projected CRS with linear units.
  3. Validate polygon inputs before overlay or union. Use make_valid() when invalid geometry is an expected data-quality issue.
  4. Choose the predicate intentionally: intersects is broad; within/contains are directional; boundary-only relationships may surprise users.
  5. Expect join and overlay outputs to change row counts and add suffixes/index columns. Document cardinality and column naming.
  6. Use .sindex.valid_query_predicates to discover available spatial index predicates in the current environment.

Minimal Check

bash
python scripts/spatial_operations_smoke.py

Expected high-level signal: the script reports successful spatial join, overlay, clip, dissolve, and spatial-index assertions on tiny in-memory geometries.

Handoff

  • Validate objects and CRS with core-data-model first when inputs are uncertain.
  • Persist operation outputs with io-formats only after verifying CRS and geometry validity.
  • Use mapping-geocoding for visualization and validation-testing for assertion-backed comparisons.

© VectorSpaceLab, BSD-3-Clause. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (scripts, references) in skills/repositories/repo-skills/geopandas/sub-skills/spatial-operations of VectorSpaceLab/AREX-Skill.

  • SKILL.md
  • references/operations-reference.md
  • references/troubleshooting.md
  • references/workflows.md
  • scripts/spatial_operations_smoke.py

Open the folder on GitHubat commit ac3fe1a

Compare with similar skills

Spatial Operations next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Spatial Operations compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Spatial Operations this skillVectorSpaceLab/AREX-Skill328—~884Automated safety check: PassBSD-3-Clause
Antv L7antvis/L74.1k—~1.4kAutomated safety check: PassMIT
Geo SleuthOldcircle/geo-sleuth1.3k—~6.1kAutomated safety check: PassMIT
Portaljs Add Geodatopian/portaljs2.4k1 repos~1.7kAutomated safety check: PassMIT
Thematic Mapzzhonglei/GeoCode-Release187—~3.1kAutomated safety check: PassMIT
Rs Paper Pipelinethinson/RS-PaperClaw227—~319Automated safety check: PassMIT

Similar skills

  • Antv L7

    antvis/L7

    Comprehensive guide for AntV L7 geospatial visualization library.

    4.1k GitHub stars~1.4k tokensUpdated 29 days ago
    Data & AnalyticsAuto-check passed
  • Geo Sleuth

    Oldcircle/geo-sleuth

    Geolocate or chronolocate a photo with tool-verified reasoning (where was this taken / when was it taken / photo geolocation / geo-guessing).

    1.3k GitHub stars~6.1k tokensUpdated today
    Data & AnalyticsAuto-check passed
  • Portaljs Add Geo

    datopian/portaljs

    Auto-ingest a geospatial file (GeoJSON, Shapefile, GeoPackage, KML/KMZ, FlatGeobuf, CSV-with-geometry) into a PortalJS portal on the user's own machine, with no server.

    2.4k GitHub starsUsed in 1 repo~1.7k tokens
    Data & AnalyticsAuto-check passed
  • Thematic Map

    zzhonglei/GeoCode-Release

    Create well-designed maps that follow standard cartographic conventions.

    187 GitHub stars~3.1k tokensUpdated 4 days ago
    Data & AnalyticsAuto-check passed
  • Rs Paper Pipeline

    thinson/RS-PaperClaw

    A skill your agent uses when operating or maintaining the RS-PaperClaw pipeline that fetches remote-sensing arXiv papers, creates per-paper issues, builds daily digests, reconciles issue sets, and…

    227 GitHub stars~319 tokensUpdated today
    Data & AnalyticsAuto-check passed
  • Remote Sensing Research Radar

    limi124/remote-sensing-research-radar

    Track, retrieve, screen, and synthesize research frontiers for geospatial AI, remote sensing big data, and transferable computer vision methods.

    142 GitHub stars~1.3k tokensUpdated 5 mo ago
    Data & AnalyticsAuto-check passed

More from VectorSpaceLab/AREX-Skill

All 157 skills in this repo
  • Agent Lightning

    VectorSpaceLab/AREX-Skill

    Use this repo skill for Agent Lightning package tasks: authoring trainable agents, tracing rewards and spans, running LightningStore/Trainer loops, using agl CLI services, choosing examples, and…

    328 GitHub stars~1.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Agent Tools

    VectorSpaceLab/AREX-Skill

    A skill your agent uses when configuring LiteLLM for MCP tools, A2A agents, Claude Code/Cursor agent gateway traffic, MCP auth/OAuth, tool permissions, semantic filtering, or agent-specific proxy…

    328 GitHub stars~1.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Agents And Awel

    VectorSpaceLab/AREX-Skill

    Build and debug DB-GPT agents, tools, skills, teams, and AWEL workflows, including deterministic local DAG runs and HTTP-trigger topology without assuming an LLM, credential, or external service.

    328 GitHub stars~2.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Agents And Middleware

    VectorSpaceLab/AREX-Skill

    Work on the actively maintained LangChain v1 agent package: initchatmodel, createagent, structured output, tools, middleware, embeddings initialization, provider routing, and agent runtime…

    328 GitHub stars~1.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Agents Workflows

    VectorSpaceLab/AREX-Skill

    A skill your agent uses for giskard.agents async chat workflows, tools, prompt templates, structured outputs, retries, rate limiting, embeddings, and optional LiteLLM backend.

    328 GitHub stars~500 tokensUpdated 1 mo ago
    Auto-check passed
  • Alphafold3

    VectorSpaceLab/AREX-Skill

    A skill your agent uses for AlphaFold 3 input preparation, prediction command planning, output interpretation, and Python API inspection.

    328 GitHub stars~1.2k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Spatial Operations

What does Spatial Operations do?

A skill your agent uses when running GeoPandas spatial joins, nearest joins, overlays, clips, dissolves, spatial indexes, and Shapely-backed geometry analysis operations. Spatial Operations is an agent skill from VectorSpaceLab/AREX-Skill. Use when running GeoPandas spatial joins, nearest joins, overlays, clips, dissolves, spatial indexes, and Shapely-backed geometry analysis operations.

When should I use Spatial Operations?

Spatial Operations fits situations like: running GeoPandas spatial joins; spatial indexes; shapely-backed geometry analysis operations.

How do I install Spatial Operations in Claude Code?

Run `npx skills add VectorSpaceLab/AREX-Skill --skill spatial-operations -a claude-code`. Or copy the skill folder (skills/repositories/repo-skills/geopandas/sub-skills/spatial-operations in VectorSpaceLab/AREX-Skill) into .claude/skills/spatial-operations in your project. Claude Code loads it when a task matches its description.

How do I install Spatial Operations in Codex?

Run `npx skills add VectorSpaceLab/AREX-Skill --skill spatial-operations -a codex`. Or copy the skill folder (skills/repositories/repo-skills/geopandas/sub-skills/spatial-operations in VectorSpaceLab/AREX-Skill) into .agents/skills/spatial-operations in your project. Codex loads it when a task matches its description.

Can I use Spatial Operations in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add VectorSpaceLab/AREX-Skill --skill spatial-operations -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/spatial-operations, .gemini/skills/spatial-operations, .github/skills/spatial-operations and .opencode/skills/spatial-operations in your project.

What does Spatial Operations need to run?

Going by SKILL.md and its folder, Spatial Operations needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Spatial Operations access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Spatial Operations safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Spatial Operations use?

Spatial Operations is published under the BSD-3-Clause licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Spatial Operations use?

About 884 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.3k tokens, read only when the agent opens those files.

What are the alternatives to Spatial Operations?

Skills that share tags, products or a category with Spatial Operations: Antv L7 (antvis/L7, 4.1k stars), Geo Sleuth (Oldcircle/geo-sleuth, 1.3k stars), Portaljs Add Geo (datopian/portaljs, 2.4k stars) and Thematic Map (zzhonglei/GeoCode-Release, 187 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Spatial Operations?

VectorSpaceLab (a GitHub organization) maintains it in VectorSpaceLab/AREX-Skill, which has 328 GitHub stars. The repository holds 157 skills in this directory. The repository was last updated on September 3, 2026.

Source: VectorSpaceLab/AREX-Skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.