portaljs-new-portal
portaljs-new-portal is a skill in datopian/portaljs, last changed 20 Oct 2026. It can run shell commands, reach the network, name web addresses and pre-approve tools — read the findings before installing.
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.
At a glance
What it can touch
How much a skill can do, not whether it is risky.
Pattern check
1 item to review
Broad tools pre-approved in allowed-tools
R34 · High · SKILL.md:4Commit fc7ccd6 · 3 Nov 2026
How the check worksPattern check:1 item to reviewSee it
Install
Each tab says whether it installs commit fc7ccd6, the one we checked, or the latest version.
OpenCode also looks in .agents/skills/ and ~/.agents/skills/, so use the Any agent steps.
Goose also looks in .agents/skills/ and ~/.agents/skills/, so use the Any agent steps.
Windsurf (Devin Desktop) also looks in .agents/skills/ and ~/.agents/skills/, so use the Any agent steps.
Zed also looks in .agents/skills/ and ~/.agents/skills/, so use the Any agent steps.
Roo Code also looks in .agents/skills/ and ~/.agents/skills/, so use the Any agent steps.
Factory Droid also looks in .agents/skills/ and ~/.agents/skills/, so use the Any agent steps.
Junie also looks in .agents/skills/ and ~/.agents/skills/, so use the Any agent steps.
Amp also looks in .agents/skills/ and ~/.agents/skills/, so use the Any agent steps.
No install command here reaches Kiro. Copy the skill's folder into .kiro/skills/ in your project, or ~/.kiro/skills/ for all your projects. datopian/portaljs/skills/portaljs-new-portal (opens in a new tab)
Antigravity also looks in .agents/skills/, so the Any agent steps reach it with This project. For All projects, see where Antigravity looks.
Cline also looks in .claude/skills/, so the Claude Code steps reach it with This project. For All projects, see where Cline looks.
Read this before installing: Broad tools pre-approved in allowed-tools — SKILL.md:4
Claude Code
Pinned to commit fc7ccd6, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/datopian/portaljs.git "$tmp" &&git -C "$tmp" fetch -q --depth 1 origin fc7ccd651459549a962c8b7aa08f60f8849fd9a5 &&git -C "$tmp" sparse-checkout set -- skills/portaljs-new-portal &&git -C "$tmp" checkout -q fc7ccd651459549a962c8b7aa08f60f8849fd9a5 &&mkdir -p .claude/skills &&mkdir .claude/skills/portaljs-new-portal &&cp -R "$tmp"/skills/portaljs-new-portal/. .claude/skills/portaljs-new-portal/ &&rm -rf "$tmp"If Claude Code was already running and this created the skills folder, run /reload-skills.
Or install the portaljs plugin it ships in. Installs the latest version, not the one we checked. Installs everything in the plugin, including any hooks, MCP servers and scripts our check doesn't cover.
claude plugin marketplace add datopian/portaljs --scope project &&claude plugin install portaljs@datopian-portaljs --scope projectClaude apps
Pinned to commit fc7ccd6, the one we checked.
Skills in the Claude apps belong to your account rather than to a project.
Make portaljs-new-portal.zip, with the skill folder at the top level:
tmp="$(mktemp -d)" &&git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/datopian/portaljs.git "$tmp" &&git -C "$tmp" fetch -q --depth 1 origin fc7ccd651459549a962c8b7aa08f60f8849fd9a5 &&git -C "$tmp" sparse-checkout set -- skills/portaljs-new-portal &&git -C "$tmp" checkout -q fc7ccd651459549a962c8b7aa08f60f8849fd9a5 &&out="$(mktemp -d)" &&cp -R "$tmp"/skills/portaljs-new-portal "$out"/portaljs-new-portal &&(cd "$out" && zip -qr - portaljs-new-portal) > portaljs-new-portal.zip &&rm -rf "$tmp" "$out"In Claude, open Customize > Skills, select +, then + Create skill > Upload a skill, and choose portaljs-new-portal.zip.
On Free, Pro and Max plans, turn on Code execution and file creation (Create and edit files in newer settings) under Settings > Capabilities.
Codex
Pinned to commit fc7ccd6, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/datopian/portaljs.git "$tmp" &&git -C "$tmp" fetch -q --depth 1 origin fc7ccd651459549a962c8b7aa08f60f8849fd9a5 &&git -C "$tmp" sparse-checkout set -- skills/portaljs-new-portal &&git -C "$tmp" checkout -q fc7ccd651459549a962c8b7aa08f60f8849fd9a5 &&mkdir -p .agents/skills &&mkdir .agents/skills/portaljs-new-portal &&cp -R "$tmp"/skills/portaljs-new-portal/. .agents/skills/portaljs-new-portal/ &&rm -rf "$tmp"Codex picks up new skills on its own; restart it if this one does not appear.
Cursor
Pinned to commit fc7ccd6, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/datopian/portaljs.git "$tmp" &&git -C "$tmp" fetch -q --depth 1 origin fc7ccd651459549a962c8b7aa08f60f8849fd9a5 &&git -C "$tmp" sparse-checkout set -- skills/portaljs-new-portal &&git -C "$tmp" checkout -q fc7ccd651459549a962c8b7aa08f60f8849fd9a5 &&mkdir -p .cursor/skills &&mkdir .cursor/skills/portaljs-new-portal &&cp -R "$tmp"/skills/portaljs-new-portal/. .cursor/skills/portaljs-new-portal/ &&rm -rf "$tmp"Copilot & VS Code
Pinned to commit fc7ccd6, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/datopian/portaljs.git "$tmp" &&git -C "$tmp" fetch -q --depth 1 origin fc7ccd651459549a962c8b7aa08f60f8849fd9a5 &&git -C "$tmp" sparse-checkout set -- skills/portaljs-new-portal &&git -C "$tmp" checkout -q fc7ccd651459549a962c8b7aa08f60f8849fd9a5 &&mkdir -p .github/skills &&mkdir .github/skills/portaljs-new-portal &&cp -R "$tmp"/skills/portaljs-new-portal/. .github/skills/portaljs-new-portal/ &&rm -rf "$tmp"In a running Copilot CLI session, run /skills reload.
Or install it with gh skill, which also installs the commit we checked. Needs GitHub CLI 2.90 or later.
gh skill install datopian/portaljs skills/portaljs-new-portal/SKILL.md@fc7ccd651459549a962c8b7aa08f60f8849fd9a5 --agent github-copilot --scope projectGemini CLI
Pinned to commit fc7ccd6, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/datopian/portaljs.git "$tmp" &&git -C "$tmp" fetch -q --depth 1 origin fc7ccd651459549a962c8b7aa08f60f8849fd9a5 &&git -C "$tmp" sparse-checkout set -- skills/portaljs-new-portal &&git -C "$tmp" checkout -q fc7ccd651459549a962c8b7aa08f60f8849fd9a5 &&mkdir -p .gemini/skills &&mkdir .gemini/skills/portaljs-new-portal &&cp -R "$tmp"/skills/portaljs-new-portal/. .gemini/skills/portaljs-new-portal/ &&rm -rf "$tmp"In a running session, run /skills reload.
Or use Gemini CLI’s own installer. Installs the latest version, not the one we checked.
gemini skills install https://github.com/datopian/portaljs.git --path skills/portaljs-new-portal --scope workspaceAny agent
Pinned to commit fc7ccd6, the one we checked.
OpenCode, Goose, Windsurf (Devin Desktop), Zed, Roo Code, Factory Droid, Junie, Amp and Antigravity read .agents/skills in a project.
From your project's root folder:
tmp="$(mktemp -d)" &&git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/datopian/portaljs.git "$tmp" &&git -C "$tmp" fetch -q --depth 1 origin fc7ccd651459549a962c8b7aa08f60f8849fd9a5 &&git -C "$tmp" sparse-checkout set -- skills/portaljs-new-portal &&git -C "$tmp" checkout -q fc7ccd651459549a962c8b7aa08f60f8849fd9a5 &&mkdir -p .agents/skills &&mkdir .agents/skills/portaljs-new-portal &&cp -R "$tmp"/skills/portaljs-new-portal/. .agents/skills/portaljs-new-portal/ &&rm -rf "$tmp"Or use the skills CLI from skills.sh. Installs the latest version, not the one we checked. The skills CLI reports installs to skills.sh unless you set DISABLE_TELEMETRY=1.
npx skills@1.7.4 add datopian/portaljs --skill portaljs-new-portalWhat it can touch
From the files and frontmatter at commit fc7ccd6. This is how much a skill can do, not whether it is risky.
Pattern check
Pattern check: 1 item to review · commit fc7ccd6 · 3 Nov 2026
We checked every text file in this skill, at commit fc7ccd6 on 3 Nov 2026, against 45 published patterns such as download-and-run commands, hidden text and credential access. We don't run the skill, we don't read the web pages it points to, and we can't judge everything its instructions might lead an agent to do. In published tests, pattern checks like this one missed most malicious skills. Read the skill before you install it — especially anything it asks you to download or run.
How the check worksReport an incorrect finding
Outside links we did not follow
- https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-new-portal.md
- https://portaljs.org
Format check
Each agent reads SKILL.md a little differently. We check the file against each one's published rules; we don't run the skill in any agent.
Agent Skills specPasses with warnings
The open format from agentskills.io, held to the strictest version of each rule among the agents we check.
- Warning
Fields outside the spec: version, author and tags. Uploads to the Claude apps and API, and the spec's validator, reject the file; most agents ignore these fields. O1
Fix: Delete them for a portable skill, or keep them if you only target the agents that read them.
- Warning
Claude CodePasses
Claude Code reads its own extra fields, ignores unknown ones, and still loads a skill whose frontmatter is broken, without its fields.
- Note
Claude Code ignores fields it doesn't know: version, author and tags. O1
Fix: Check the spelling against Claude Code's field list, or delete them.
- Note
Claude apps & API uploadFails
Uploading to claude.ai or the Claude API, or packaging with Anthropic's script, accepts only the six spec fields and stops on anything else.
- Error
Upload and packaging fail on fields outside the spec: version, author and tags. O1
Fix: Delete them, and keep your own data under metadata as text values.
- Note
The description is 206 characters. The claude.ai Help Center says 200 at most, though Anthropic's API docs and validator allow 1,024. D4
Fix: If the claude.ai upload refuses it, trim the description to 200 characters.
- Error
OpenAI (Codex & API)Passes with warnings
Codex finds SKILL.md by its exact name and needs a description; OpenAI's Skills API checks the frontmatter against the spec and caps uploads.
- Warning
Fields outside the spec: version, author and tags. Codex ignores them; OpenAI doesn't say whether its upload accepts them. O1
Fix: Delete them, or move your own data under metadata as text values.
- Warning
VS Code & CopilotPasses
VS Code reads skills one folder below .github/skills, .claude/skills or .agents/skills and falls back to the folder name when the name is missing or differs; GitHub's Copilot docs require the exact name SKILL.md.
- Note
VS Code ignores fields it doesn't support: version, author and tags. O1
Fix: Delete them unless another agent you target reads them.
- Note
SKILL.md
Files
2 files
| Path | Size |
|---|---|
| SKILL.md (opens in a new tab) | 6.4 KB |
| references/reference.md (opens in a new tab) | 3.9 KB |
More from datopian/portaljs
Other Frontend & design skills
Same category, most repo stars first.