portaljs-add-resource

1# PortalJS — Add Resource
2 
3## Overview
4 
5Add a resource — an additional file — to a dataset that already exists in a
6`portaljs-catalog` portal. Where `/portaljs-add-dataset` creates a **new** dataset
7(one file), this skill adds a file to an **existing** one: a data dictionary, a
8methodology document, or another data file (e.g. a second year's figures).
9 
10Mirrors the Frictionless Data Package model: a dataset holds a `resources[]` array,
11and the showcase at `/@<namespace>/<slug>` renders one section per resource (preview,
12schema, download). A single-file dataset migrates to `resources[]` automatically the
13first time a second file is added — no data is lost.
14 
15## Prerequisites
16 
17- An existing PortalJS portal (`portaljs-catalog` template) with `datasets.json`,
18  `package.json`, and `pages/[owner]/[slug].tsx` present.
19- The target dataset already registered in `datasets.json`.
20- The new resource's source: a local file path or a public URL, in CSV, TSV, JSON
21  (array), or GeoJSON format.
22- Node 18+ installed to run `npx next build` for verification.
23 
24## Instructions
25 
26The canonical, full step-by-step workflow lives in
27[`.claude/commands/portaljs-add-resource.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-resource.md)
28in this repository — that file is the single source of truth. Read and follow it. Summary:
29 
301. Gather input (interview if thin): `DATASET` (slug or `namespace/slug`), `SOURCE`
31…