Portaljs Add Geo
Ingest a geo file into a serverless PortalJS portal as PMTiles + GeoParquet tiers
Test report
- Verdict
- Works with setup
- Score
- Tested
- Jul 20, 2026
- Environment
- Claude Code 2.x (agent harness)
- Upstream re-checked
- Aug 10, 2026 · ef05442
Fetched the repo tree (14 portaljs SKILL.md files), read SKILL.md, the referenced workflow .claude/commands/portaljs-add-geo.md, and references/reference.md in full — both referenced files exist. Frontmatter parses cleanly with name/description; grep for base64/curl|sh/exfil/webhooks came back clean (the Arc JWT + R2/Giftless push is legitimate Datopian infra). The workflow is detailed and honest — hard-stops on missing tools, documents a >2GB PMTiles-skip degradation and Windows-WSL limitation rather than hiding them. OUTPUT is NOT measured (not a measured loss): the skill shells out to native GDAL/tippecanoe/duckdb and needs a scaffolded portal plus R2 credentials, none installable under the safety rules, so I scored output 5 as unmeasured-neutral. Install docked one point because copied files are inert without those external CLIs.
Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works
- Installs cleanly 4/5
- Triggers reliably 5/5
- Output vs. baseline 5/10
- Docs & honesty 5/5
What Portaljs Add Geo does
Auto-ingests a vector geospatial file (GeoJSON, zipped Shapefile, GeoPackage, KML/KMZ, FlatGeobuf, CSV-with-geometry) into a PortalJS portal: normalizes CRS to EPSG:4326, derives a PMTiles render tier and a GeoParquet query tier, pushes all three artifacts to Cloudflare R2 via Git LFS, and appends one dual-tier datasets.json entry the showcase auto-renders. Triggers when the source is a vector geo format that needs a map or spatial-query view; it explicitly defers plain tabular data to portaljs-add-dataset and small-Leaflet views to portaljs-add-map.
How to install Portaljs Add Geo
Copy skills/portaljs-add-geo/ into your project's .claude/skills/ (and the workflow file .claude/commands/portaljs-add-geo.md), or use the PortalJS plugin. Requires a scaffolded portaljs-catalog portal (PR #1647+ with MapPreview.tsx/GeoQuery.tsx), native GDAL + tippecanoe + duckdb (macOS: brew install gdal tippecanoe duckdb; Debian/Ubuntu equivalent; Windows via WSL), and Arc credentials (or self-hosted Giftless) for the Git-LFS to R2 push.
Skills live in ~/.claude/skills/ (global) or .claude/skills/
(per-project). Restart Claude Code after installing.
Commands — how to trigger Portaljs Add Geo
-
/portaljs-add-geoIngest a geo file into a serverless PortalJS portal as PMTiles + GeoParquet tiers
It also activates on plain-language prompts like these:
-
Add this Shapefile as a map layer to the portal -
Ingest this GeoPackage and generate PMTiles -
Import this KML file with spatial query support
Frequently asked questions
- Is the Portaljs Add Geo skill free?
- Yes. The skill itself is free from datopian/portaljs. SkillProof publishes the install command and an independent test verdict at no cost.
- Does Portaljs Add Geo work with Claude Code?
- We tested it with Claude Code 2.x (agent harness) on Jul 20, 2026. Verdict: Works with setup. Fetched the repo tree (14 portaljs SKILL.md files), read SKILL.md, the referenced workflow .claude/commands/portaljs-add-geo.md, and references/reference.md in full — both referenced files exist. Frontmatter parses cleanly with name/description; grep for base64/curl|sh/exfil/webhooks came back clean (the Arc JWT + R2/Giftless push is legitimate Datopian infra). The workflow is detailed and honest — hard-stops on missing tools, documents a >2GB PMTiles-skip degradation and Windows-WSL limitation rather than hiding them. OUTPUT is NOT measured (not a measured loss): the skill shells out to native GDAL/tippecanoe/duckdb and needs a scaffolded portal plus R2 credentials, none installable under the safety rules, so I scored output 5 as unmeasured-neutral. Install docked one point because copied files are inert without those external CLIs.
- What is the Portaljs Add Geo SkillProof Score?
- 7.6/10 — installs cleanly 4/5, triggers reliably 5/5, output vs. baseline 5/10, docs & honesty 5/5.
- How do I install Portaljs Add Geo?
- Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
- Can I use Portaljs Add Geo with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
- The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.