portaljs-add-dcat

1# PortalJS — Add DCAT
2 
3## Overview
4 
5Turn an existing PortalJS (`portaljs-catalog`) portal into a harvestable data catalog.
6PortalJS is Frictionless-native — a dataset is a Data Package (see
7`portaljs-define-schema`) — and DCAT is the serialization + harvest layer on top
8(`lib/metadata/dcat.ts` + `lib/metadata/dcat-profiles.ts`). This skill selects one or
9more DCAT application profiles, maps every dataset's metadata to them, and writes
10static feed files at build time — JSON-LD, Turtle, and RDF/XML — so external catalogs
11(data.europa.eu, data.gov, national portals) can harvest the datasets automatically,
12on any static host, with no runtime.
13 
14## Prerequisites
15 
16- A scaffolded PortalJS portal with `datasets.json`, `package.json`, and
17  `lib/metadata/` (the metadata-profile contract) present.
18- `lib/metadata/dcat.ts` (the DCAT-3 core) already in place — profiles augment it.
19- Node 18+ and npm available in the portal directory.
20- For DCAT-AP / DCAT-US: a publishing organization (name + homepage) and a contact
21  (name + email) — both profiles require `dct:publisher` and `dcat:contactPoint`.
22- Optional but recommended: network access to run SHACL conformance checks against the
23  official EU ITB validator or `pyshacl`.
24 
25## Instructions
26 
27The canonical, full step-by-step workflow is
28[`.claude/commands/portaljs-add-dcat.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-dcat.md) —
29the single source of truth. Read and follow it when executing. Summary:
30…