CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

portaljs-add-map

Render a GeoJSON dataset on an interactive Leaflet map in the Views section of a dataset's showcase. Installs react-leaflet and a Map component, then renders the map for the chosen dataset. Use when a dataset's data is geographic and a map view is needed alongside the showcase's default metadata and download.

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

81%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-structured, token-efficient body with a clearly sequenced workflow, explicit validation checkpoints, and a real, well-scoped one-level-deep reference file. The main weakness is that the copy-paste-ready component code and gating snippet live in an external file, leaving the body's own guidance concrete but not fully self-contained.

DimensionReasoningScore

Conciseness

Efficient throughout — exact install/verify commands, a lean summary of the canonical workflow, and dense error/output tables with no padding or explanations of concepts Claude already knows. Minor trims possible: several Error Handling rows duplicate the reference file's troubleshooting, and the Output section is more granular than needed.

4 / 5

Actionability

Mostly executable guidance: exact commands ('npm install react-leaflet@^5 leaflet@^1.9', 'npx tsc --noEmit') and exact paths ('components/MapView.tsx', 'pages/[owner]/[slug].tsx', '/public/data/'). Not 5 because the MapView/Map component code and the gating check ('the dataset check shown in the Instructions') are described rather than shown — the executable detail is deferred to the external canonical workflow file.

4 / 5

Workflow Clarity

Eight clearly sequenced steps with explicit validation checkpoints ('Validate the portal directory', 'Verify with npx tsc --noEmit', 'Fix the first reported error before reporting success') and a symptom→cause→fix error table providing feedback loops for recovery. This matches the top anchor: explicit validation plus error-recovery guidance.

5 / 5

Progressive Disclosure

Verified against the actual bundle: references/reference.md exists, is one level deep, clearly signaled in Resources, and correctly holds the detail (props, SSR rationale, troubleshooting) while the body stays an overview. Not 5 because the most executable content — the full workflow and component code — is delegated to a remote GitHub URL outside the bundle rather than a bundled file.

4 / 5

Total

17

/

20

Passed

Description

83%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 description that names concrete actions in third person and pairs a clear what with an explicit and specific 'Use when' trigger clause. Trigger vocabulary is good but could add common synonyms and file extensions to sharpen routing.

DimensionReasoningScore

Specificity

Names several concrete actions ('Render a GeoJSON dataset on an interactive Leaflet map', 'Installs react-leaflet and a Map component') with a precise target (Views section of a showcase), but coverage has minor gaps — the dataset-registration path covered in the body is absent, and 'renders the map' repeats the first clause.

4 / 5

Completeness

Explicitly answers both: what — 'Render a GeoJSON dataset on an interactive Leaflet map... Installs react-leaflet and a Map component'; when — 'Use when a dataset's data is geographic and a map view is needed alongside the showcase's default metadata and download'. The when-clause is explicit and states concrete trigger conditions, matching the top anchor.

5 / 5

Trigger Term Quality

Good natural keywords ('GeoJSON', 'Leaflet', 'map', 'map view', 'geographic', 'dataset') that users would plausibly say. Not 5 because common synonyms and extensions ('.geojson', 'shapefile', 'spatial', 'plot on a map') are missing; not 3 since several natural phrasings are present beyond domain jargon.

4 / 5

Distinctiveness Conflict Risk

A clear niche (GeoJSON + Leaflet + dataset showcase) with distinct triggers, but minor overlap risk with the closely related 'portaljs-add-chart' skill and with generic 'add a map' requests outside the PortalJS context. Not 5 because the ecosystem anchor ('showcase') is jargon rather than a user-spoken trigger.

4 / 5

Total

17

/

20

Passed

Validation

87%

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

CriteriaDescriptionResult

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-map/SKILL.md

Reviewed

Table of Contents

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.