WorldEnergyData Source Readiness
Quick Start
Use the canonical skill and script in the worldenergydata checkout:
WED_REPO="${WED_REPO:-../worldenergydata}"
cd "$WED_REPO"
git fetch origin main
python .claude/skills/worldenergydata-source-readiness/scripts/source_readiness_summary.py
JSON output:
WED_REPO="${WED_REPO:-../worldenergydata}"
cd "$WED_REPO"
git fetch origin main
python .claude/skills/worldenergydata-source-readiness/scripts/source_readiness_summary.py --format json
If the script is missing, update the worldenergydata checkout to a revision at or after PR #461.
What This Returns
The summary includes:
- data group / module
- catalog status and freshness status
- latest known date and whether it came from metadata, file timestamps, or scheduler success
- repo-local data location
- external data root, if metadata records one
- configured scheduler output directory
- dataset count, record count, file count, and size
Interpretation Rule
Do not treat latest_known_date as source-data vintage unless the row says the basis is an inspected dataset field. Most current rows use metadata refresh, newest file modified date, or scheduler success.
For acceptance criteria, require each Tier-A source to expose:
source_data_latest_datelast_successful_refreshdata_locationrecord_countfreshness_statusrefresh_cadenceblocker_issueornone
Canonical Files
In worldenergydata:
.claude/skills/worldenergydata-source-readiness/SKILL.md.claude/skills/worldenergydata-source-readiness/scripts/source_readiness_summary.pydata/freshness-scorecard.jsondata/modules/<module>/_metadata.jsondata/modules/<module>/manifest.jsonconfig/scheduler/scheduler_config.yml