City Data Research Skill

This repository contains a Codex skill for repeatable city and municipal data research.

The skill helps an agent gather, extract, validate, and organize indicators for one city or a list of cities. It is designed for market studies, public policy scans, site selection, regional benchmarking, and other workflows that require sourced tables and concise reports.

What it supports

• Web research across official, institutional, and reputable public sources.
• Browser automation for interactive portals and visually structured pages.
• Programmatic extraction from HTML, CSV, JSON, APIs, downloads, and data repositories.
• Ad hoc scraping when source structure requires custom requests or parsing.
• Source logging, reproducible extraction notes, and confidence flags.
• Output as comparison tables, datasets, and short reports according to the user's requested format.

Skill files

The skill is in city-data-research/:

• SKILL.md: core workflow and decision rules.
• references/source-playbook.md: source discovery and extraction guidance.
• references/reporting-patterns.md: suggested output structures.
• scripts/inspect_source.py: quick inspection for URLs or local data files.
• scripts/merge_indicators.py: utility to merge indicator CSVs by city keys.

Installation

Copy the city-data-research/ folder into your Codex skills directory, for example:

cp -R city-data-research ~/.codex/skills/