portaljs-new-portal

by datopian2.4k

Scaffold a new PortalJS data portal from a brief. Copies the canonical template from examples/portaljs-catalog and substitutes project tokens. Use when starting a brand-new data portal project from sc

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-new-portal -a cursor -y

Download skill skills/portaljs-new-portal/SKILL.md on GitHub

Related skills

View all

Questions

How do I install portaljs-new-portal?: Download skills/portaljs-new-portal/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-new-portal live?: The publisher keeps it at https://github.com/datopian/portaljs.
Which agents can use portaljs-new-portal?: Claude, Cursor, and Codex can read a SKILL.md you add from the publisher's repository.

name: portaljs-new-portal description: Scaffold a new PortalJS data portal from a brief. Copies the canonical template from examples/portaljs-catalog and substitutes project tokens. Use when starting a brand-new data portal project from scratch. allowed-tools: Read, Write, Edit, Bash(npm:), Bash(npx:), Bash(cp:), Bash(mkdir:), Bash(git:*) version: 1.0.0 author: Datopian [email protected] 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
`DIR_EXISTS`	`./PROJECT_SLUG` already exists and is non-empty	Ask the user for a different name or consent to remove it; then proceed.
Remote fetch fails	Bad `PORTALJS_TEMPLATE_REF`, network outage, or `tiged` unavailable	Tell the user plainly and ask to retry, use a different ref, or check network.
Stale local scaffold (`pages/datasets/[slug].tsx`)	Old local clone missing `pages/[owner]/[slug].tsx`	Resolver already falls back to remote in this case — do not force local mode.
`npm install` fails	Node <22 or no network	Report the error and ask the user to check Node version and connectivity.
`tsc --noEmit` fails	Token substitution or manifest error	Print the log and fix before reporting success — never report success with a failing type check.

portaljs-new-portal

Install

Related skills

Questions

PortalJS — New Portal

Overview

Prerequisites

Instructions

Output

Error Handling

Examples

Example 1 — Full brief up front

Example 2 — No arguments, full interview

Example 3 — Single-publisher portal with no datasets yet

Resources