Geobase skills

Agent skills for Geobase: GeoEmbeddings, worker jobs, tileserver, titiler, project database import, and (when it ships) platform CLI workflows.

Private beta — Geobase and this skills repo require beta access. npx skills add decision-labs/geobase-skills only works if your GitHub account can read the repository.

geobase-cli is not shipped yet. Skills document the intended CLI workflow for later; during beta, use Geobase Studio for project URL, ref, and anon key (@geobase → Private beta (CLI not shipped)).

Compatible with the Agent Skills CLI (npx skills).

Install

All skills at once

Non-interactive (recommended) — installs every skill under skills/ without the picker:

# All skills → Cursor, project scope
npx skills add decision-labs/geobase-skills --skill '*' -a cursor -y

# All skills → Cursor, global (user-wide)
npx skills add decision-labs/geobase-skills --skill '*' -a cursor -g -y

# All skills → every supported agent
npx skills add decision-labs/geobase-skills --all

-y alone only skips confirmations; use --skill '*' or --all to select every skill.

Interactive — multi-select in the wizard:

npx skills add decision-labs/geobase-skills
# or
npx skills add git@github.com:decision-labs/geobase-skills.git

Install one skill

npx skills add decision-labs/geobase-skills --skill geobase-tileserver --yes

Replace geobase-tileserver with any skill name from the catalog below.

Discover skills (no separate registration)

Skills appear on skills.sh after people run npx skills add (install telemetry). There is no extra signup for the Vercel skills ecosystem.

Use these during private beta — npx skills find often returns nothing until install counts grow:

# List all skills in this repo (most reliable)
npx skills add decision-labs/geobase-skills --list

Bundle page: https://skills.sh/decision-labs/geobase-skills

npx skills find geobase searches the public skills.sh search index only; low-install bundles may not appear yet. That is normal — use --list or the bundle URL above.

Skill catalog

Area	Skill	Install
Platform	Geobase (umbrella)	npx skills add decision-labs/geobase-skills@geobase
GeoEmbeddings	Index	@geobase-embeddings
	Operations hierarchy	@geobase-embeddings-management
	Create via workers	@geobase-embeddings-create-via-workers
	Catalogue metadata (RUD)	@geobase-embeddings-catalogue-management
	RPC applications	@geobase-embeddings-rpc-applications
	Troubleshooting	@geobase-embeddings-troubleshooting
Workers	SRAI GeoEmbeddings (OSM + H3)	@geobase-worker-srai-embeddings
	GeoAI embeddings (raster / GeoTIFF)	@geobase-worker-geoai-embeddings
	OSM import	@geobase-worker-osm-import
	Overture Maps import	@geobase-worker-overture-import
	PostGIS → PMTiles archive	@geobase-worker-archive-to-pmtiles
Maps	Vector tiles / MapLibre	@geobase-tileserver
	Raster COG / Titiler	@geobase-titiler
Data	Project DB import	@geobase-project-db-data-import

Skills cross-reference each other with @skill-name (for example @geobase → @geobase-worker-srai-embeddings).

Authoritative catalog (area, dependencies, routing descriptions): skills/catalog.json. See ARCHITECTURE.md and docs/skill-authoring.md.

Layout

Each skill is a directory with a SKILL.md file (YAML frontmatter + markdown):

skills/
  catalog.json
  geobase/SKILL.md
  geobase-tileserver/SKILL.md
  geobase-titiler/SKILL.md
  ...
ARCHITECTURE.md
docs/skill-authoring.md
plugin.json

Source of truth

Edit skills in this repository only. Install via npx skills add decision-labs/geobase-skills.

Requirements

• Beta: Geobase Studio access and a Geobase project (URL, ref, anon key from project settings). No public geobase-cli install yet.
• Later: geobase-cli for platform login and projects env (documented in skills; not required during private beta).
• Do not commit platform or project secrets into skill files.
• DATABASE_URI and SERVICE_ROLE_KEY are not available to agents without a human in the loop. Users must set real values in their local environment (for example gitignored .env.db / .env.secrets, direnv, or shell exports). See @geobase → Secrets (human in the loop).

Smoke tests

bash scripts/smoke-test.sh

Checks: valid plugin.json, catalog/frontmatter/cross-refs (scripts/validate_catalog.py), and agentskills skills-ref per skill. CI runs bash scripts/smoke-test.sh on pull requests (.github/workflows/smoke.yml).

License

Apache License 2.0 — see LICENSE.