portaljs-migrate

by datopian2.4k

Install

The skill file stays in the publisher's repository.

Paste the copied command in a terminal. It installs this SKILL.md into that agent.

npx skills add datopian/portaljs --skill portaljs-migrate -a cursor -y

Download skill skills/portaljs-migrate/SKILL.md on GitHub

Related skills

View all

Migrate (harvest) datasets between open-data platforms. Reads CKAN, a DCAT-US /data.json catalog (DKAN, ArcGIS Hub, data.gov), a DCAT / DCAT-AP RDF feed (JSON-LD, Turtle, or RDF/XML), Socrata, OpenDataSoft, or an ArcGIS FeatureServer, and writes them to a static PortalJS catalog or pushes them into a CKAN instance over its API. Use when moving datasets from an external open-data platform into a PortalJS portal, or bridging one CKAN instance to another.

Questions

How do I install portaljs-migrate?: Download skills/portaljs-migrate/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
Where does portaljs-migrate live?: The publisher keeps it at https://github.com/datopian/portaljs.
Which agents can use portaljs-migrate?: Claude, Cursor, and Codex can read a SKILL.md you add from the publisher's repository.

name: portaljs-migrate description: Migrate (harvest) datasets between open-data platforms. Reads CKAN, a DCAT-US /data.json catalog (DKAN, ArcGIS Hub, data.gov), a DCAT / DCAT-AP RDF feed (JSON-LD, Turtle, or RDF/XML), Socrata, OpenDataSoft, or an ArcGIS FeatureServer, and writes them to a static PortalJS catalog or pushes them into a CKAN instance over its API. Use when moving datasets from an external open-data platform into a PortalJS portal, or bridging one CKAN instance to another. allowed-tools: Read, Write, Edit, Bash(npm:), Bash(node:), Bash(git:*), WebFetch version: 1.0.0 author: Datopian license: MIT compatibility: Claude Code with PortalJS portals (Next.js 14, React 18, Node 18+). Runs from any project via the plugin, a personal ~/.claude/commands install, or a portaljs clone. tags:

Symptom	Cause	Fix
"not a `portaljs-catalog` template"	`datasets.json` missing	Confirm the portal directory, or run `/portaljs-new-portal`
CKAN target rejects every write (403)	Key missing, expired, or lacks org permission	Set a valid `CKAN_API_KEY`; stop rather than partially migrating
Source URL matches no known format	Auto-detection failed	Pass `--source` explicitly (`ckan`, `dcat`, `dcat-rdf`, `socrata`, `ods`, `arcgis`)
DCAT-RDF fetch returns HTML, not a feed	URL is a portal page, not the feed	Follow its `<link rel="alternate">` href, or use the direct feed URL
Build fails after write	Malformed entry (missing `slug`/`namespace`/`name`)	Inspect `/tmp/portaljs-migrate-build.log`, fix, rebuild
`download` mode push fails	`git-lfs` missing, or no Arc/Giftless token	Install `git-lfs`; mint a token via the Arc API or self-hosted Giftless
Duplicate datasets after re-running	`--replace` used unintentionally, or slug collisions	Omit `--replace` to upsert; keep slugs unique per namespace

portaljs-migrate

Install

Related skills

Questions

PortalJS — Migrate

Overview

Prerequisites

Instructions

Output

Error Handling

Examples

Example 1 — CKAN to static catalog, link mode

Example 2 — data.gov DCAT-US catalog, downloaded into R2

Example 3 — DCAT-AP RDF feed from a national portal

Example 4 — CKAN to CKAN (platform-to-platform)

Resources