添加图表

本条目介绍 添加图表 的公开用途。DeepSkill 当前公开目录说明:“在 PortalJS 门户中为数据集展示添加图表(折线图、柱状图、面积图、饼图或散点图)。安装 recharts,编写一个可复用的 Chart 组件,并在展示视图部分渲染该组件。适用于已注册在 datasets.json 中的数据集的可视化。” 适用场景包括做图表与报表、写代码与代码审查。本页根据公开目录资料和固定版本的上游仓库整理,建议使用前核对该版本的环境、工具、权限及数据处理要求。Skillπ 提供站方用途介绍与原站链接;原始 SKILL.md 和附件仅在对应许可允许时开放。

仓库
jeremylongshore/tons-of-skills-marketplace

安装方式

先用 Prompt 核对来源,也可切换到安装命令或下载可用的安装包。

安装方式

用 AI 助手安装

复制提示词,让助手先核对固定版本和依赖。

查看 Prompt收起 Prompt
先检查当前 Agent 是否已安装 SkillPI Skill Finder。如果尚未安装,请按官方仓库的说明安装并启用:https://github.com/Findskills/skillpi。然后使用 Skill Finder 打开此 SkillPI 详情页并定位 "portaljs-add-chart":https://skillpi.com/zh/skills/deepskill-17cedbe2e7c0f2899e6bad3f871e5e1d9311e7248b1232b133023a1e7b320120。安装前核对上游来源和版本:https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/6ea46b08dce892944db7c16f28d0b5308d402402/plugins/community/portaljs/skills/portaljs-add-chart/SKILL.md。来源不一致时停止并说明差异。核对通过后,用 Skill Finder 安装目标 Skill,并报告安装路径和来源版本。

此命令从 GitHub 来源仓库获取指定技能。运行前请先查看源文件。

运行工具
npx skills add https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/6ea46b08dce892944db7c16f28d0b5308d402402/plugins/community/portaljs/skills/portaljs-add-chart --skill portaljs-add-chart
许可协议: —

来源与配置

查看 GitHub 源码

jeremylongshore/tons-of-skills-marketplace固定提交 6ea46b08dce892944db7c16f28d0b5308d402402

配置方式待核实

请查看原始来源中的适用工具、依赖和权限要求。

安装实测待补充

本条目介绍 添加图表 的公开用途。DeepSkill 当前公开目录说明:“在 PortalJS 门户中为数据集展示添加图表(折线图、柱状图、面积图、饼图或散点图)。安装 recharts,编写一个可复用的 Chart 组件,并在展示视图部分渲染该组件。适用于已注册在 datasets.json 中的数据集的可视化。” 适用场景包括做图表与报表、写代码与代码审查。本页根据公开目录资料和固定版本的上游仓库整理,建议使用前核对该版本的环境、工具、权限及数据处理要求。Skillπ 提供站方用途介绍与原站链接;原始 SKILL.md 和附件仅在对应许可允许时开放。

↓ 0 下载 ↗ 0 分享点击

文件浏览

在原站浏览文件 ↗

原始 SKILL.md

打开原文 ↗
---
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.
allowed-tools: Read, Write, Edit, Bash(npm:*), Bash(npx:*)
version: 1.0.0
author: Datopian <hello@datopian.com>
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:
  - portaljs
  - data-portal
  - chart
  - recharts
  - dataviz
  - nextjs
---

# PortalJS — Add Chart

## 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`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-chart.md) —
the single source of truth. Read and follow it when executing. Summary:

1. 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.
2. Resolve the dataset from `datasets.json` (`namespace`, `file`, `format`).
3. 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()`).
4. Install the chart library: `npm install recharts@^2.15.0`.
5. Write `components/Chart.tsx` (idempotent — do not overwrite a customized component).
6. 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.
7. Verify with `npx tsc --noEmit`.
8. 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`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-chart.md)
- Chart-type and prop reference: [`references/reference.md`](references/reference.md)
- Related skills: `portaljs-add-dataset`, `portaljs-add-map`, `portaljs-define-schema`
- recharts documentation: <https://recharts.org/>

当前收录版本

1.0.0

核对来源版本 ↗

质量评测

满分 100。前四项来自 DeepSkill 收录的质量报告。

场景价值92/100
评分依据

直接解决用户在 PortalJS 门户中为数据集添加图表可视化的核心任务痛点

触发精准88/100
评分依据

触发词精准完整,覆盖多种变体,边界清晰

结构规范95/100
评分依据

Phase/步骤清晰,有出口条件,含端到端示例

执行可靠90/100
评分依据

工具来源明确,参数正确,覆盖主要异常

证据可验 (前四项均值)91/100
计算方式

取前四项原始分值的算术平均,四舍五入取整。可通过收录报告核对各项评分与说明,运行记录需单独查证。

权限与使用前检查

根据当前主文档自动整理,命中内容可能是示例或防护说明;不是实际权限声明,也未覆盖附件、外部依赖或运行行为。

文档引用的域名或地址

这些地址可能用于文档链接或示例,不是已批准的联网清单。使用前核对实际目的地及发送的数据。

  • github.com
  • recharts.org

本站展示提示不会授予权限。涉及文件改动、密钥、外部发送或费用时,仍由你使用的工具按需确认。

安全评级与访问范围

risk · 静态证据核验,不代表运行安全保证。

使用前请由宿主核对并授权实际文件读写、外部服务和联网目的地;本站的核验不会授予任何运行权限。

来源与使用声明 SkillPi 的部分技能资料来自公开来源或创作者提交。第三方内容的权利归各自权利人所有。安装或运行前,请查看原站的许可、权限要求和使用风险。

来源与使用

请按详情页的作者、原始来源和许可证核对使用条件,运行前检查技能需要的权限。目录收录不等于已验证安装或安全性。