Skills

Portaljs Add Dataset

Add a dataset (CSV, TSV, JSON, or GeoJSON) to an existing PortalJS portal.

Install

npx skills add datopian/portaljs --skill portaljs-add-dataset -g -a claude-code -y
Repository
datopian/portaljs2.4k
Category
Data and ML
Updated
7d ago
License
MIT
Context cost
Lightabout 1,381 tokens
Runs scripts
No, instructions only

What it does

Add a dataset (CSV, TSV, JSON, or GeoJSON) to an existing PortalJS portal. Appends an entry to datasets.json so the catalog and showcase render it automatically; routes the data by source (local file vs remote URL), R2 via Git LFS by default, remote URLs by passthrough. Use when registering a new dataset in a scaffolded portal.

PortalJS, Add Dataset

Overview

Register a dataset in a PortalJS (portaljs-catalog) portal. The skill appends one entry to datasets.json, the single source of truth for the catalog, and routes the underlying bytes by source first, then size: a local file defaults to R2 via Git LFS, a remote URL defaults to passthrough (no copy). No per-dataset page is created; the catalog at /search lists the new entry and the dynamic showcase route pages/[owner]/[slug].tsx renders it automatically at /@<namespace>/<slug>. Supported formats for the showcase preview: CSV, TSV, JSON (array), and GeoJSON.

Prerequisites

  • A scaffolded PortalJS portal (see portaljs-new-portal) with datasets.json, package.json, and pages/[owner]/[slug].tsx present.
  • The source data: a local file path or a publicly reachable URL.
  • For the R2/Git LFS default route: git and git-lfs installed, and an Arc account token (or an OSS Giftless key) to mint a push-scoped LFS credential.
  • Node 18+ and npm available in the portal directory.

Instructions

The canonical, full step-by-step workflow is .claude/commands/portaljs-add-dataset.md, the single source of truth. Read and follow it when executing. Summary:

Read the whole SKILL.md on GitHub

More in Data and ML