# Portaljs Architect

Recommend a data-portal architecture (storage, compute, catalog, access, hosting...

- Repository: https://github.com/datopian/portaljs (2370 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-28
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add datopian/portaljs --skill portaljs-architect -g -a claude-code -y`
Codex: `npx skills add datopian/portaljs --skill portaljs-architect -g -a codex -y`
Cursor: `npx skills add datopian/portaljs --skill portaljs-architect -g -a cursor -y`
Gemini CLI: `npx skills add datopian/portaljs --skill portaljs-architect -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add datopian/portaljs`

## Description

Recommend a data-portal architecture (storage, compute, catalog, access, hosting, metadata) from stated needs, then hand off to the build skills. The advisory entry point. Use when starting a new data-portal project and the underlying architecture has not yet been decided.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# PortalJS, Architect

## Overview
The advisory entry point for a PortalJS project. Before anything gets scaffolded, this
skill works out what to build: given the kind of portal, the shape of the data, and its
purpose, it fills six architecture slots (storage, catalog, compute, access, hosting,
metadata), resolves two build-time knobs (per-dataset data tier and the portal-wide
`DATA_QUERY` mode), and hands off to the concrete build skills. It decides; it does not
build. When the brief is thin it interviews in short rounds and never dead-ends, every
question has a sensible default, reachable by replying "use defaults."

## Prerequisites
- A rough idea of the portal's purpose and data (exact numbers are not required, the
  interview supplies defaults for anything missing).
- Optional: local files or a directory of sample data to inspect for size and shape.
- No PortalJS project needs to exist yet; this skill runs before scaffolding.

## Instructions
The canonical, full step-by-step workflow lives in
[`.claude/commands/portaljs-architect.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-architect.md), that file is the single source of truth. Follow it when executing this skill:

The rest: https://github.com/datopian/portaljs/blob/HEAD/skills/portaljs-architect/SKILL.md