portaljs-add-dataset
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.
npx skills add datopian/portaljs --skill portaljs-add-dataset --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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`](https://github.com/datopian/portaljs/blob/main/.cla
- Overview
- Prerequisites
- Instructions
- Output
- Error Handling
- Examples
- Example 1 — Local CSV, default R2 route
- Example 2 — Remote URL, passthrough (no download)
- Example 3 — GeoJSON adopted into R2
- Example 4 — Bundled sample data, inline exception
- Resources
What does the portaljs-add-dataset skill do?
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.
How do I install it?
Run `npx skills add datopian/portaljs --skill portaljs-add-dataset --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From datopian/portaljs, a repository with 2,337 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.