worldenergydata-source-readiness

name	worldenergydata-source-readiness
description	Route agents to the canonical worldenergydata source-readiness skill and summary script. Use when asked for worldenergydata data completeness, data locations, latest known data dates, scheduler freshness, source-readiness status, or acceptance-criteria inputs across the repo ecosystem.

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_date
• last_successful_refresh
• data_location
• record_count
• freshness_status
• refresh_cadence
• blocker_issue or none

Canonical Files

In worldenergydata:

• .claude/skills/worldenergydata-source-readiness/SKILL.md
• .claude/skills/worldenergydata-source-readiness/scripts/source_readiness_summary.py
• data/freshness-scorecard.json
• data/modules/<module>/_metadata.json
• data/modules/<module>/manifest.json
• config/scheduler/scheduler_config.yml