Run any Skill in Manus with one click

sync-taxonomy

Stars29

Forks6

UpdatedApril 17, 2026 at 19:57

Use when the user edits the conflation taxonomy CSVs, or when the frontend filters / taxonomy reference page are suspected to be out of sync with the CSVs. Triggers: "sync taxonomy to the site", "update frontend after taxonomy change", "rebuild taxonomy.html", "check taxonomy drift", "constants.js out of sync", "regenerate taxonomy generated file".

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

henryspatialanalysis

henryspatialanalysis/OpenPOIs

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name	sync-taxonomy
description	Use when the user edits the conflation taxonomy CSVs, or when the frontend filters / taxonomy reference page are suspected to be out of sync with the CSVs. Triggers: "sync taxonomy to the site", "update frontend after taxonomy change", "rebuild taxonomy.html", "check taxonomy drift", "constants.js out of sync", "regenerate taxonomy generated file".

Sync taxonomy to the frontend

The conflation CSVs in src/openpois/conflation/data/ are the single source of truth for three frontend artifacts:

site/src/taxonomy.generated.js — machine-readable SHARED_LABELS, OSM_KEYS, OVERTURE_L0S (gitignored; imported by constants.js).
site/public/taxonomy.html — user-facing taxonomy reference page (gitignored).
site/src/constants.js — display-label maps OSM_KEY_LABELS / OVERTURE_L0_LABELS (hand-maintained).

When the CSVs change, (1) and (2) must be regenerated, and (3) must be audited for any new keys/L0s that need human-readable labels.

Steps

Check for drift:
```
python scripts/check_taxonomy_sync.py
```
Exit 0 = clean, skip the rest. Exit 1 = proceed.
Regenerate the generated artifacts:
```
python scripts/build_taxonomy.py
```
Writes both site/public/taxonomy.html and site/src/taxonomy.generated.js.
Re-run the check:
```
python scripts/check_taxonomy_sync.py
```
Must exit 0 now. If it still fails, something is wrong with build_taxonomy.py — debug before continuing.
Audit display labels — the check prints WARN: lines if constants.js is missing entries in OSM_KEY_LABELS or OVERTURE_L0_LABELS. Add pretty labels for any new keys (e.g. tourism: 'Tourism'). Missing entries fall back to the raw key (e.g. tourism), which is ugly but not broken.
Run the test:
```
pytest tests/test_taxonomy_sync.py
```
Preview in a browser:
```
cd site && npm run dev
```
Verify in each source view:
- OSM: filter checkboxes match OSM_KEYS in the generated file; toggling a new key (e.g. tourism) filters POIs appropriately.
- Overture: POIs from all 12 L0 categories render (lodging, education, etc.). If a new L0 appears, confirm it's enabled on initial load.
- Conflated: all SHARED_LABELS appear as checkboxes; any new "Other *" labels are unchecked by default.
- /taxonomy.html page renders with the new rows.
Build:
```
cd site && npm run build
```
Must succeed without new warnings.

Key files

scripts/build_taxonomy.py — regenerates taxonomy.html + taxonomy.generated.js.
scripts/check_taxonomy_sync.py — drift detector, exits 1 on mismatch.
tests/test_taxonomy_sync.py — pytest wrapper; runs in CI.
site/src/constants.js — OSM_KEY_LABELS, OVERTURE_L0_LABELS (display labels only).
.claude/docs/taxonomy-setup.md — background on the four CSVs.

When this skill runs automatically

This is step 1 of skills/update-site — anytime the site is bumped to new data, taxonomy drift is caught first. It is also referenced from skills/conflate-snapshots.

More from this repository

same repository

full-data-pull

henryspatialanalysis/OpenPOIs

Use when the user wants to refresh the independent POI snapshots (OSM, Overture) and rate the OSM snapshot for conflation. Triggers: "refresh all snapshots", "do a new data pull", "download new OSM/Overture", "monthly data refresh", "pull the latest POI data". Does NOT include conflation or Source Cooperative publishing — those live in conflate-snapshots.

2026-07-2529

model-history-pipeline

henryspatialanalysis/OpenPOIs

Use when the user wants to run the full OSM-history turnover model from scratch — downloading Geofabrik full-history PBFs, formatting observations, fitting lambda, and applying predictions to the current snapshot. Triggers: "run the full history pipeline", "refit the model from scratch", "bump osm_data version and rerun", "new model run", "rerun history modeling for <date>".

2026-07-2529

verify-pipeline-run

henryspatialanalysis/OpenPOIs

Use when the user wants a QA/sanity check on a recently completed pipeline run — row counts, parameter spot-checks, diffs vs. prior versions, or site-side verification. Triggers: "sanity check the run", "verify the new data looks right", "QA the model output", "diff against the last version", "did the upload work".

2026-07-2529

conflate-snapshots

henryspatialanalysis/OpenPOIs

Use when the user wants to match rated OSM POIs with Overture POIs into a unified dataset, partition it for web consumption, and push to Source Cooperative. Triggers: "run conflation", "publish new data", "push new conflated data to Source Cooperative", "bump conflation version", "reconflate with new parameters", "re-upload the partitioned parquet".

2026-06-2929

iterate-model-types

henryspatialanalysis/OpenPOIs

Use when the user wants to sweep model types or group keys against a fixed history run — keeping `versions.osm_data` pinned while producing multiple fitted models. Triggers: "try a different model type", "rerun the model for <group_key>", "sweep model variants", "compare random_by_type vs constant", "fit a new group_key on the same observations".

2026-06-2729

update-site

henryspatialanalysis/OpenPOIs

Use when the user wants to bump the frontend to point at newly uploaded Source Cooperative data, or wants to run/preview/build the site locally. Triggers: "push new data to the site", "bump site to latest data version", "update constants.js", "deploy the site", "preview the site with new data", "rebuild site after data refresh".

2026-05-2129

name	sync-taxonomy
description	Use when the user edits the conflation taxonomy CSVs, or when the frontend filters / taxonomy reference page are suspected to be out of sync with the CSVs. Triggers: "sync taxonomy to the site", "update frontend after taxonomy change", "rebuild taxonomy.html", "check taxonomy drift", "constants.js out of sync", "regenerate taxonomy generated file".

Sync taxonomy to the frontend

The conflation CSVs in src/openpois/conflation/data/ are the single source of truth for three frontend artifacts:

site/src/taxonomy.generated.js — machine-readable SHARED_LABELS, OSM_KEYS, OVERTURE_L0S (gitignored; imported by constants.js).
site/public/taxonomy.html — user-facing taxonomy reference page (gitignored).
site/src/constants.js — display-label maps OSM_KEY_LABELS / OVERTURE_L0_LABELS (hand-maintained).

When the CSVs change, (1) and (2) must be regenerated, and (3) must be audited for any new keys/L0s that need human-readable labels.

Steps

Check for drift:
```
python scripts/check_taxonomy_sync.py
```
Exit 0 = clean, skip the rest. Exit 1 = proceed.
Regenerate the generated artifacts:
```
python scripts/build_taxonomy.py
```
Writes both site/public/taxonomy.html and site/src/taxonomy.generated.js.
Re-run the check:
```
python scripts/check_taxonomy_sync.py
```
Must exit 0 now. If it still fails, something is wrong with build_taxonomy.py — debug before continuing.
Audit display labels — the check prints WARN: lines if constants.js is missing entries in OSM_KEY_LABELS or OVERTURE_L0_LABELS. Add pretty labels for any new keys (e.g. tourism: 'Tourism'). Missing entries fall back to the raw key (e.g. tourism), which is ugly but not broken.
Run the test:
```
pytest tests/test_taxonomy_sync.py
```
Preview in a browser:
```
cd site && npm run dev
```
Verify in each source view:
- OSM: filter checkboxes match OSM_KEYS in the generated file; toggling a new key (e.g. tourism) filters POIs appropriately.
- Overture: POIs from all 12 L0 categories render (lodging, education, etc.). If a new L0 appears, confirm it's enabled on initial load.
- Conflated: all SHARED_LABELS appear as checkboxes; any new "Other *" labels are unchecked by default.
- /taxonomy.html page renders with the new rows.
Build:
```
cd site && npm run build
```
Must succeed without new warnings.

Key files

scripts/build_taxonomy.py — regenerates taxonomy.html + taxonomy.generated.js.
scripts/check_taxonomy_sync.py — drift detector, exits 1 on mismatch.
tests/test_taxonomy_sync.py — pytest wrapper; runs in CI.
site/src/constants.js — OSM_KEY_LABELS, OVERTURE_L0_LABELS (display labels only).
.claude/docs/taxonomy-setup.md — background on the four CSVs.

When this skill runs automatically

This is step 1 of skills/update-site — anytime the site is bumped to new data, taxonomy drift is caught first. It is also referenced from skills/conflate-snapshots.