pudl
Access PUDL table data plus table/column/source metadata in Jupyter or Marimo notebooks for debugging and visualization. Use when users ask what a table contains, how to read it, or how columns are defined.
How do I install this agent skill?
npx skills add https://github.com/catalyst-cooperative/agent-skills --skill pudlIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill facilitates access to the Public Utility Data Liberation (PUDL) project's datasets and metadata. It provides code snippets for reading local and remote Parquet files, querying metadata using Python and CLI tools, and exploring data methodology.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
PUDL Data and Metadata Guide
Use this skill for data-user workflows: reading PUDL outputs, understanding table and field semantics, tracing source context, and interpreting methodology.
Trigger phrases
- "show me this PUDL table in a notebook"
- "how do I read table X from Parquet"
- "load this table from local PUDL output"
- "read this PUDL table from S3"
- "what columns are in this table"
- "what does this column mean"
- "show table metadata for X"
- "which data source does this table come from"
- "find field descriptions for this table"
- "I need notebook code to explore this PUDL data"
Audience and scope
- Primary audience: analysts and data users, not core maintainers.
- Focus: using outputs and metadata confidently without digging into internals.
- Secondary audience: developers who need the same data context while coding.
Source-of-truth policy
The reference files in this skill are the canonical AI-facing layer for:
- data access and output usage patterns,
- table/field/source metadata retrieval,
- source-doc and methodology interpretation.
pudl-dev should reuse these references instead of duplicating them.
Reference index
Escalation boundary
If a task requires modifying ETL code, schema migrations, dbt tests, or CI workflow,
hand off to pudl-dev and keep these references as the shared data context.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/catalyst-cooperative/agent-skills/pudl">View pudl on skillZs</a>