CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

geopandas

Python library for working with geospatial vector data including shapefiles, GeoJSON, and GeoPackage files. Use when working with geographic data for spatial analysis, geometric operations, coordinate transformations, spatial joins, overlay operations, choropleth mapping, or any task involving reading/writing/analyzing vector geographic data. Supports PostGIS databases, interactive maps, and integration with matplotlib/folium/cartopy. Use for tasks like buffer analysis, spatial joins between datasets, dissolving boundaries, clipping data, calculating areas/distances, reprojecting coordinate systems, creating maps, or converting between spatial file formats.

67

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

The canonical home for this skill is geopandas in K-Dense-AI/scientific-agent-skills

SKILL.md
Quality
Evals
Security

Quality

Content

72%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured overview with executable snippets and excellent progressive disclosure into six real reference files. Its weakness is workflow clarity: multi-step workflows that write batch output lack embedded validation checkpoints, and there is minor redundancy between the inline reference links and the 'Detailed Documentation' section.

Suggestions

Embed validation checkpoints directly in the workflows, e.g. after loading add 'assert gdf.geometry.is_valid.all()' (or a check-and-repair step with .make_valid()), and verify CRS matches before each sjoin/overlay rather than listing these only as best-practice bullets.

Remove the 'Detailed Documentation' section or the per-section 'See [x].md' links — one of the two navigation patterns is redundant and costs tokens.

Consolidate the three separate to_crs/reprojection demonstrations (Quick Start, CRS Management, workflow) into one canonical example and keep the others as one-line references to it.

DimensionReasoningScore

Conciseness

The body is efficient — short sections, minimal comments, and it assumes Claude knows geospatial basics ('GeoPandas extends pandas to enable spatial operations on geometric types' is one line, not a tutorial). Minor trimmable redundancy: the 'Detailed Documentation' section repeats the six reference links already given inline in each section, and reprojection is demonstrated three times (Quick Start, CRS section, workflow). Not 5 because of that duplicated content; not 3 because there is no padded explanation of concepts Claude already knows.

4 / 5

Actionability

Concrete, mostly executable code throughout — the Quick Start runs as-is, and operations show real calls ('gpd.sjoin(gdf1, gdf2, predicate=\"intersects\")', 'gdf.to_file(\"results.gpkg\", layer=\"original\")'). Minor gaps: several snippets use undefined placeholders ('bbox=(xmin, ymin, xmax, ymax)', 'points_gdf', 'con=engine'), so they are templates rather than copy-paste-ready. Not 5 per the 'copy-paste ready... covers the common cases' anchor; not 3 because the guidance is genuinely executable, not pseudocode.

4 / 5

Workflow Clarity

Workflows like 'Load, Transform, Analyze, Export' and 'Spatial Join and Aggregate' have a clear numbered sequence, but no validation checkpoints — geometry validity ('.is_valid') and CRS checks appear only as best-practice bullets, never as verification steps inside a workflow that writes batch output files. Per the rubric guideline, batch write workflows without embedded validation cap at 3. Not 4 because checkpoints are missing rather than a minor gap; not 2 because the sequences themselves are well defined.

3 / 5

Progressive Disclosure

The body is a concise overview with each section pointing to one real reference file ('See [data-structures.md](references/data-structures.md)'), all six referenced paths verified to exist in references/, one level deep, plus a 'Detailed Documentation' navigation index. This matches the top anchor: clear overview, well-signaled one-level-deep references, easy navigation.

5 / 5

Total

16

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with explicit what/when structure, third-person voice, and a comprehensive list of concrete capabilities and trigger phrases. The only weakness is that trigger terms stop short of file extensions (.shp, .gpkg) and a few common synonyms like 'GIS'.

DimensionReasoningScore

Specificity

Lists many concrete actions — 'buffer analysis, spatial joins between datasets, dissolving boundaries, clipping data, calculating areas/distances, reprojecting coordinate systems, creating maps, or converting between spatial file formats' — with comprehensive coverage matching the top anchor. Not 4 because coverage goes beyond 'minor gaps': formats, databases, mapping, and conversions are all enumerated.

5 / 5

Completeness

Explicitly answers both: what ('Python library for working with geospatial vector data including shapefiles, GeoJSON, and GeoPackage files') and when ('Use when working with geographic data for spatial analysis... or any task involving reading/writing/analyzing vector geographic data'). Concrete trigger phrases are present, matching the 5 anchor; the 4 anchor's 'when could be more explicit' does not apply here.

5 / 5

Trigger Term Quality

Good natural-term coverage ('spatial joins', 'choropleth mapping', 'buffer analysis', 'dissolving boundaries', 'reprojecting', 'PostGIS', 'shapefiles, GeoJSON, and GeoPackage files') but a few natural terms are missing — no file extensions like '.shp'/'.gpkg' and no common phrasings like 'GIS' or 'geodata'. Not 5 because the top anchor explicitly requires synonyms and file extensions; not 3 because the coverage clearly exceeds 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

A clear niche (geospatial vector data) with distinct triggers ('spatial joins', 'choropleth mapping', 'reprojecting coordinate systems') and named formats — minimal overlap risk with generic data or plotting skills. It is more targeted than the 4 anchor's 'minor overlap risk with closely related skills' example.

5 / 5

Total

19

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

synthetic-sciences/openscience

Path

backend/cli/skills/data-engineering/geopandas/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.