1. Habit
  2. Skills
  3. PUDL skill
catalyst-cooperative · 2K installs

PUDL skill
Runs by itself, weekly descriptor check.

Know when your PUDL tables change.

Install the PUDL skill and make it a habit: follow https://gethabit.dev/skills/catalyst-cooperative/pudl.md

  1. 1Copy
  2. 2Paste into Claude Code, Codex or Cursor
  3. 3It runs by itself

2K installs3 starsMIT licenceSource on GitHub ↗

PUDL

by catalyst-cooperative · 2K installs

The skill

The pudl skill helps energy data users explore PUDL: find tables, read column meanings and usage warnings, and load Parquet from S3 or locally, covering EIA, FERC and EPA data.

Only when you ask.

The habit

Know when your PUDL tables change.

↻ Runs by itselfweekly descriptor check

How the habit works.
You don't have to.

Three questionsWhen does it start? How does it check its work? What does it remember?

01

It starts by itself

weekly descriptor check. Runs in Claude Code routine or cron.

  • ↻ weekly descriptor check
  • 0 6 * * 1

02

It checks its work

descriptor read, changes listed. If a check fails, it tells you.

  • ✓python scripts/fetch_descriptor.py exits without error
  • ✓every watched table is found in the descriptor
  • ✓usage warnings are listed for each watched table

03

It remembers

watched schemas log. The next run reads it first: last week's fields, foreign keys and warnings per table.

loops/pudl-schema-watch-loop/run-log.md

One run, step by step.
Then it stops.

Stop ruleStops after 20 watched tables per run; reads metadata only, never full tables.

  1. 01

    Fetch descriptor

    Run python scripts/fetch_descriptor.py to refresh assets/cache/.

  2. 02

    Query selectively

    Use the datapackage skill's jq patterns for each watched table.

  3. 03

    Compare

    Compare fields, schema.foreignKeys and warnings with last week.

  4. 04

    Check tiers

    Flag watched tables that are not out_* tables.

  5. 05

    Report

    List changes and warnings and log the new schema.

What it may do.
Nothing more.

Safe by defaultIt writes only in its own folder and asks you before anything goes out.

Is it for you?
Use it when it fits.

Quick checkRead both lists. If the left one sounds like you, the PUDL skill helps.

Use it when

  • ✓ You look for US energy data tables
  • ✓ You need a column meaning or warning
  • ✓ You load PUDL data into a notebook

Skip it when

  • – You need non-US energy data
  • – You are developing the PUDL codebase itself

Questions

PUDL skill, answered.

Do I need AWS credentials?

No. The skill says the PUDL bucket is public and ambient credentials should be bypassed.

Which tables should I depend on?

The skill prefers out_* tables for analysis.

How do I install the PUDL skill?

Copy the prompt at the top into your agent. It installs the skill from catalyst-cooperative/agent-skills and sets up the habit. Or run npx skills add catalyst-cooperative/agent-skills --skill pudl.

Is the PUDL skill free?

Yes. It is published under MIT. Habit is free too.

PUDL. Now as a habit.

Install the PUDL skill and make it a habit: follow https://gethabit.dev/skills/catalyst-cooperative/pudl.md

  • Free
  • No account
  • Undo in one line

All catalyst-cooperative skills →More ops skills →

Works in

  • Claude Code
  • Codex
  • Cursor
  • ChatGPT
  • Claude app

Made by catalyst-cooperative, published under MIT. Habit links to the original and never changes it. Is this your skill?

Copying didn't work here. Select the line and copy it by hand.