portaljs-add-chart

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.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

85%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-organized, action-oriented skill body that sequences a multi-step workflow with validation and feedback loops while keeping the overview concise and pointing one level deep to a real reference file. The main gap is that the core Chart component code is delegated rather than inlined.

Suggestions

Inline a minimal Chart.tsx skeleton (or a trimmed snippet) so the skill is executable without round-tripping to the canonical workflow URL.

Tighten the Instructions summary to avoid restating steps already covered by the linked canonical workflow file.

Add a brief note on how to verify the chart renders in the browser (e.g., expected URL) beyond the tsc type check.

Dimension	Reasoning	Score
Conciseness	Lean overview that assumes Claude's competence and delegates detail to the canonical workflow file; a few summary steps lightly duplicate that file and could be trimmed.	4 / 5
Actionability	Gives concrete commands ("npm install recharts@^2.15.0", "npx tsc --noEmit") and exact paths, plus executable slash-command examples, but the Chart.tsx component body itself is delegated rather than shown.	4 / 5
Workflow Clarity	An 8-step numbered sequence with explicit validation checkpoints (column validation in step 3, "npx tsc --noEmit" in step 7) and an Error Handling table providing fix-and-retry feedback loops.	5 / 5
Progressive Disclosure	Well-structured overview with one-level-deep, clearly signaled references — the canonical workflow URL and the real references/reference.md — and content appropriately split across files.	5 / 5
	Total	18 / 20 Passed

Description

88%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, third-person description that clearly states both the capability and the trigger condition with concrete actions. Minor gains available by adding natural synonyms (plot, graph) and sharpening the trigger against sibling viz skills.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — "Add a chart (line, bar, area, pie, or scatter)", "Installs recharts, writes a reusable Chart component, and renders it in the showcase Views section" — with comprehensive coverage of what it does.	5 / 5
Completeness	Explicitly answers both what ("Add a chart... Installs recharts, writes a reusable Chart component, and renders it in the showcase Views section") and when ("Use when visualizing a dataset already registered in datasets.json").	5 / 5
Trigger Term Quality	Includes natural terms a user would say ("chart", "visualizing a dataset", "PortalJS portal") but omits common synonyms like "plot", "graph", or "data visualization".	4 / 5
Distinctiveness Conflict Risk	Clear PortalJS/dataset-showcase niche with distinct triggers, but "visualizing a dataset" carries minor overlap risk with sibling skills like portaljs-add-map.	4 / 5
	Total	18 / 20 Passed

Validation

87%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
allowed_tools_field	'allowed-tools' contains unusual tool name(s)	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	14 / 16 Passed

Repository: datopian/portaljs
Path: skills/portaljs-add-chart/SKILL.md
Commit: ebfd391

Reviewed: 7 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.