portaljs-add-dataset

1# PortalJS — Add Dataset
2 
3## Overview
4 
5Register a dataset in a PortalJS (`portaljs-catalog`) portal. The skill appends one entry to
6`datasets.json` — the single source of truth for the catalog — and routes the underlying
7bytes by **source first, then size**: a local file defaults to R2 via Git LFS, a remote URL
8defaults to passthrough (no copy). No per-dataset page is created; the catalog at `/search`
9lists the new entry and the dynamic showcase route `pages/[owner]/[slug].tsx` renders it
10automatically at `/@<namespace>/<slug>`. Supported formats for the showcase preview: CSV,
11TSV, JSON (array), and GeoJSON.
12 
13## Prerequisites
14 
15- A scaffolded PortalJS portal (see `portaljs-new-portal`) with `datasets.json`,
16  `package.json`, and `pages/[owner]/[slug].tsx` present.
17- The source data: a local file path or a publicly reachable URL.
18- For the R2/Git LFS default route: `git` and `git-lfs` installed, and an Arc account token
19  (or an OSS Giftless key) to mint a push-scoped LFS credential.
20- Node 18+ and npm available in the portal directory.
21 
22## Instructions
23 
24The canonical, full step-by-step workflow is
25[`.claude/commands/portaljs-add-dataset.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-dataset.md) —
26the single source of truth. Read and follow it when executing. Summary:
27 
281. Gather input from `$ARGUMENTS` — source (file path or URL), portal directory (default
29…