Primeros pasos

  1. Paso 1 Instala las skills

    Ejecuta estos comandos en tu terminal para añadir las skills a Claude Code. El repositorio de las skills tiene instrucciones para otros agentes.

    claude plugin marketplace add portolan-sdi/portolan-skills
    claude plugin install portolan@portolan-skills
  2. Paso 2 Pide a tu agente que empiece

    Dale la URL de tus datos y el bucket de almacenamiento en la nube donde quieres publicar el catálogo.

    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/>
Creando un catálogo de Portolan de principio a fin a partir de datos de vivienda de Filadelfia.

Una grabación solo de terminal muestra a un agente crear y publicar un catálogo Portolan con diez conjuntos de datos de Open Data Philly. La solicitud nombra parcelas, uso del suelo, distritos base y superposiciones de zonificación, descripciones de zonificación, indicadores de propiedades vacantes, distritos del Ayuntamiento, huellas de edificios y producción de viviendas asequibles. El agente carga la habilidad de arranque de Portolan, investiga y descarga las fuentes, mejora los metadatos, crea miniaturas y estilos de mapa, valida el catálogo y lo publica. La terminal informa de unos 1,78 millones de entidades y confirma que todas las comprobaciones del catálogo pasan. También registra campos de origen sin resolver, detalles de licencia y problemas de herramientas antes de sincronizar los archivos y las guías de agentes publicados.

  1. 01

    Convertir

    El agente usa la CLI de Portolan para extraer los datos de sus servidores de origen y convertirlos a formatos optimizados para la nube. Los datos vectoriales terminan como GeoParquet y PMTiles, y los datos ráster como COG.

  2. 02

    Catalogar

    La CLI organiza los datos como un catálogo STAC y los enriquece con metadatos de la fuente original. El agente añade documentación, miniaturas y estilos de mapa, y después valida el catálogo con rashid, el validador de Portolan.

  3. 03

    Publicar

    El agente publica el catálogo, en este caso en Source Cooperative. Sirve cualquier almacenamiento compatible con S3, sin servidores ni API que configurar. El agente también puede añadir el catálogo al registro de Portolan, que es siempre opcional.

  4. 04

    Usar

    Abre el catálogo en el navegador de Portolan, lleva los datos directamente a herramientas como QGIS, ArcGIS, Python o DuckDB, o pasa la URL del catálogo a un agente y deja que se ponga a trabajar.

Próximos pasos

Para profundizar, sigue la construcción de un catálogo real. La guía lleva los datos abiertos de East Hampton, Nueva York, desde su servidor de Esri hasta un catálogo de Portolan publicado.