connect-geography

Create GeographyPlugin integrations joining PxWeb data with map geometry.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/arvidfcjarfalla-prog/atlas --skill connect-geography
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: connect-geography
Source: https://github.com/arvidfcjarfalla-prog/atlas/tree/main/.claude/skills/connect-geography
Command: npx skills add https://github.com/arvidfcjarfalla-prog/atlas --skill connect-geography

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Build geography plugins for new countries so PxWeb/SDMX data can join to map geometry. Reads geometry files + API responses, generates a plugin following the Norway SSB pattern. Use when saying "geography plugin", "connect geometry", "ny geo-plugin", or "lägg till land".

Core Features & Use Cases

  • Create a GeographyPlugin for a new country so data from its statistical API can join to map geometry.
  • Read the country's geometry file at apps/web/public/geo/{iso2}/admin1.geojson (or municipalities.geojson) to determine join keys and code mappings.
  • Model after the Norway SSB plugin to ensure consistency with existing plugins and tooling.
  • Determine PxWeb dimension naming, codes, and mapping strategy (direct_code, alias_crosswalk, or label_match).

Quick Start

Create a new GeographyPlugin for a target country by following the Norway SSB template and configuring geometry and API metadata.

Frequently Asked Questions about connect-geography

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I join PxWeb statistical data with GeoJSON map geometry?

To join PxWeb data with GeoJSON geometry, you build a geography plugin that reads local geometry files and API responses to map statistical codes to geographic regions. This enforces the Norway SSB pattern for consistent data integration.

What is the best way to add a new country's statistics API to a geography plugin?

Adding a new country's statistics API requires modeling a geography plugin after the Norway SSB template. The plugin reads the target country's GeoJSON geometry files to determine join keys and configures PxWeb dimension naming and code mappings.

How does a geography plugin map PxWeb dimension codes to GeoJSON features?

A geography plugin maps PxWeb dimensions to GeoJSON features using one of three strategies: direct_code matching, alias_crosswalk translation, or label_match. The chosen strategy depends on the specific country's API dimension naming.

Can I use a different plugin structure instead of the Norway SSB pattern for mapping geography?

Using the Norway SSB pattern is enforced for all geography plugins to ensure consistency with existing tooling. This standardized structure defines the plugin interface with id, name, and mapping logic, preventing fragmented custom implementations.

Do I need specific PxWeb dimension names to build a geography plugin?

You need to determine the PxWeb dimension naming and codes for your target country before building the plugin. The plugin uses these dimensions to configure the mapping strategy, whether using direct_code, alias_crosswalk, or label_match approaches.