Getting started

  1. Step 1 Install the skills

    Run these commands in your terminal to add the skills to Claude Code. The skills repository has instructions for other agents.

    claude plugin marketplace add portolan-sdi/portolan-skills
    claude plugin install portolan@portolan-skills
  2. Step 2 Tell your agent to start

    Give it the URL of your data and the cloud storage bucket where you want the catalog to be published.

    Use the Portolan bootstrap skill to make a catalog of these data:
    <the URL of your data>
    
    Publish it to this bucket:
    <s3://your-bucket/>
Making a Portolan catalog start to finish from Philadelphia housing data.

A terminal-only recording shows an agent create and publish a Portolan catalog from ten Open Data Philly datasets. The request names property parcels, land use, zoning base districts and overlays, zoning descriptions, vacant-property indicators, City Council districts, building footprints, and affordable housing production. The agent loads the Portolan bootstrap skill, researches and downloads the sources, enriches metadata, creates thumbnails and map styles, validates the catalog, and publishes it. The terminal reports about 1.78 million features and that all catalog gates pass. It also records unresolved source fields, license details, and upstream tool issues before it syncs the published catalog files and agent guides.

  1. 01

    Convert

    The agent uses the Portolan CLI to extract the data from its upstream servers and convert it to cloud-optimized formats. Vector data end up as GeoParquet and PMTiles, and raster data as COG.

  2. 02

    Catalog

    The CLI organizes the data as a STAC catalog and enriches it with metadata from the original source. The agent adds docs, thumbnails, and map styles, then validates the catalog with rashid, the Portolan validator.

  3. 03

    Publish

    The agent publishes the catalog, here to Source Cooperative. Any S3-compatible storage works, with no servers or APIs to set up. The agent can also add the catalog to the Portolan registry, which is always opt-in.

  4. 04

    Use

    Open the catalog in the Portolan browser, drop the data directly into tools like QGIS, ArcGIS, Python, or DuckDB, or pass the catalog URL to an agent and let it get to work.

Next steps

For a deeper dive, follow the build of a real catalog. The guide takes the open data of East Hampton, New York, from its Esri server to a published Portolan catalog.