skills/pudl/SKILL.md
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.
npx skillsauth add catalyst-cooperative/skills pudlInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use this skill for data-user workflows: reading PUDL outputs, understanding table and field semantics, tracing source context, and interpreting methodology.
The reference files in this skill are the canonical AI-facing layer for:
pudl-dev should reuse these references instead of duplicating them.
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.
testing
Explore and query any dataset annotated with a Frictionless Data Package descriptor (datapackage.json). Use this skill whenever a user wants to discover what tables or resources a dataset contains, look up column names and descriptions, surface usage warnings embedded in metadata, or understand how to load data from Parquet files, DuckDB or SQLite databases, or CSV files described by a datapackage.json. Also use when the user has a datapackage.json and wants to know what's in it, how to query it efficiently, or how to connect its metadata to actual data files. Pairs well with dataset-specific skills (like `pudl`) that layer domain knowledge on top.
development
Full-stack development guidance for the PUDL project, covering contributor workflows, local ETL and Dagster development, metadata/schema changes, dbt and pytest validation, and data-oriented documentation context (data access, data dictionaries, data sources, and methodology).
development
Maintainer-only workflow for handling GitHub Secret Scanning alerts on OpenClaw. Use when Codex needs to triage, redact, clean up, and resolve secret leakage found in issue comments, issue bodies, PR comments, or other GitHub content.
development
Maintainer workflow for OpenClaw releases, prereleases, changelog release notes, and publish validation. Use when Codex needs to prepare or verify stable or beta release steps, align version naming, assemble release notes, check release auth requirements, or validate publish-time commands and artifacts.