portaljs-new-portal
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.
npx skills add datopian/portaljs --skill portaljs-new-portal --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 — New Portal ## Overview Scaffold a production-ready PortalJS data portal from a brief. The skill is **interactive**: if the brief is thin it interviews the user in three short rounds (mapped to the template's three surfaces — Home, Catalog, Showcase), echoes a brief back for confirmation, then copies `examples/portaljs-catalog` (locally or via a remote `tiged` fetch), substitutes placeholder tokens, sets the namespace mode, seeds any datasets named in the interview, installs dependencies, and verifies the scaffold with a type check. ## Prerequisites - Node.js >=22 and npm available on `PATH`. - Network access, unless a current local checkout of the portaljs repo is available (the resolver defaults to a remote fetch of the template). - A destination directory name that does not already contain files (or user consent to overwrite one that does). ## Instructions The canonical, full step-by-step workflow is [`.claude/commands/portaljs-new-portal.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-new-portal.md) — the single source of truth. Read and follow it when executing. Summary: 1. Interview the user in up to three rounds — Home/basics, Catalo
- 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
What does the portaljs-new-portal skill do?
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.
How do I install it?
Run `npx skills add datopian/portaljs --skill portaljs-new-portal --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.