About

Imported from jeremylongshore/tons-of-skills-marketplace (plugins/community/portaljs/skills/portaljs-add-chart/SKILL.md). Install upstream with npx skills add jeremylongshore/tons-of-skills-marketplace --skill portaljs-add-chart. Copyright stays with the author (MIT).

PortalJS — Add Chart

Name: portaljs-add-chart
Author: jeremylongshore

Overview

Add a visualization to a dataset's showcase in a PortalJS portal. The skill installs recharts (added directly — never @portaljs/components), writes a reusable client-side Chart component into components/, and renders a <Chart /> into the Views section of the showcase route pages/[owner]/[slug].tsx for one chosen dataset. The chart reads the same /public/data/<file> the showcase <Table /> already uses, so no data is duplicated. Five chart types are supported: line, bar, area, pie, and scatter.

Prerequisites

A scaffolded PortalJS portal (see portaljs-new-portal).
The target dataset already registered in datasets.json (see portaljs-add-dataset).
components/ui/parseCsv.ts present (ships with the template).
Node 18+ and npm available in the portal directory.

Instructions

The canonical, full step-by-step workflow is .claude/commands/portaljs-add-chart.md — the single source of truth. Read and follow it when executing. Summary:

Gather input — dataset slug, X column, Y column(s), chart type (default line), portal directory. If any is missing, interview the user; never dead-end on a missing value.
Resolve the dataset from datasets.json (namespace, file, format).
Validate that the X and every Y column exist in the data file's header; warn on non-numeric Y columns (values are coerced with Number()).
Install the chart library: npm install recharts@^2.15.0.
Write components/Chart.tsx (idempotent — do not overwrite a customized component).
Render <Chart /> into the Views section, gated on the dataset's (namespace, slug) so other showcases are unaffected. Extend an existing view-dispatch block, do not overwrite.
Verify with npx tsc --noEmit.
Report the component, route, and dependency added.

Output

Created: components/Chart.tsx (recharts wrapper, if absent).
Modified: pages/[owner]/[slug].tsx (import + gated <Chart /> in Views); package.json (recharts@^2.15.0).
Verified: npx tsc --noEmit passes.
Result: the chart renders at /@<namespace>/<slug> under a "Views" heading.

Error Handling

Symptom	Cause	Fix
Missing dataset/columns	Slug or column not in manifest/header	List available slugs/headers and re-prompt; do not error out.
Gaps in the chart	Non-numeric cells coerced to `NaN`	Clean the source data or pick a numeric Y column.
`tsc` failure	Bad column prop or import path	Fix the first reported error before reporting success.
Sluggish render	Over ~2,000 SVG points	Pre-aggregate the series (e.g. yearly buckets).

Examples

Example 1 — Single line series

/portaljs-add-chart co2-emissions x=year y=emissions type=line

Example 2 — Multi-series bar chart

/portaljs-add-chart trade x=year y=imports,exports type=bar

Example 3 — Pie chart of a categorical breakdown

/portaljs-add-chart budget x=department y=amount type=pie

Resources

Full workflow: .claude/commands/portaljs-add-chart.md
Chart-type and prop reference: references/reference.md
Related skills: portaljs-add-dataset, portaljs-add-map, portaljs-define-schema
recharts documentation: https://recharts.org/

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/jeremylongshore-tons-of-skills-marketplace-portaljs-add-chart/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

jeremylongshore-tons-of-skills-marketplace-portaljs-add-chart.ocm.jsonjson

{
  "ocm": "1",
  "id": "jeremylongshore-tons-of-skills-marketplace-portaljs-add-chart",
  "kind": "skill",
  "name": "portaljs-add-chart",
  "description": "Add a chart (line, bar, area, pie, or scatter) to a dataset's showcase in a PortalJS portal. Installs recharts, writes a reusable Chart component, and renders it in the showcase Views section. Use when visualizing a dataset already registered in datasets.json.",
  "publisher": "jeremylongshore",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "data_analysis"
    ],
    "tags": [
      "skill-md",
      "portaljs",
      "data-portal",
      "chart",
      "recharts",
      "dataviz",
      "nextjs",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Add a chart (line, bar, area, pie, or scatter) to a dataset's showcase in a PortalJS portal. Installs recharts, writes a reusable Chart component, and renders it in the showcase Views section. Use when visualizing a dataset already registered in datasets.json."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/jeremylongshore/tons-of-skills-marketplace",
      "path": "plugins/community/portaljs/skills/portaljs-add-chart/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/HEAD/plugins/community/portaljs/skills/portaljs-add-chart/SKILL.md",
      "key": "jeremylongshore/tons-of-skills-marketplace/plugins/community/portaljs/skills/portaljs-add-chart/SKILL.md"
    },
    "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.",
    "allowed_tools": [
      "Read,",
      "Write,",
      "Edit,",
      "Bash(npm:*),",
      "Bash(npx:*)"
    ],
    "license": "MIT"
  },
  "instructions": "# PortalJS — Add Chart\n\n## Overview\n\nAdd a visualization to a dataset's **showcase** in a PortalJS portal. The skill installs\n`recharts` (added directly — never `@portaljs/components`), writes a reusable client-side\n`Chart` component into `components/`, and renders a `<Chart />` into the **Views** section\nof the showcase route `pages/[owner]/[slug].tsx` for one chosen dataset. The chart reads the\nsame `/public/data/<file>` the showcase `<Table />` already uses, so no data is duplicated.\nFive chart types are supported: line, bar, area, pie, and scatter.\n\n## Prerequisites\n\n- A scaffolded PortalJ",
  "cost": {
    "context_tokens": 878
  }
}

Fetch it by URL: GET /api/v1/registry/jeremylongshore-tons-of-skills-marketplace-portaljs-add-chart/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.