# pudl

Помогает находить и загружать открытые энергетические данные PUDL из Parquet-файлов в S3 без установки пакета pudl. Разбирает таблицы EIA, FERC и EPA.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2100 установок · ★ 3
- Автор: catalyst-cooperative
- Лицензия: CC-BY-4.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/catalyst-cooperative/agent-skills/tree/HEAD/skills/pudl/SKILL.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/skills/pudl

## Что делает

Скилл объясняет структуру открытых датасетов проекта PUDL от Catalyst Cooperative: выработку электричества, отчёты FERC, стоимость топлива и выбросы EPA. Он находит нужные таблицы через дескриптор Frictionless Data Package, расшифровывает значения колонок и предупреждает об ограничениях качества данных. При этом ставить сам Python-пакет pudl в систему не требуется.

Внутри заложен чёткий порядок работы с метаданными и файлами Parquet на S3. Скрипт `python scripts/fetch_descriptor.py` кэширует схему в `assets/cache/`, а запросы к ней строятся через jq. Скилл отдаёт приоритет готовым таблицам с префиксом `out_*`, предупреждает о сырых `_core_*` и требует соединять данные EIA и FERC строго по идентификаторам `utility_id_pudl` и `plant_id_pudl`. Для выгрузки данных агент формирует запросы с фильтрами в DuckDB или Polars, чтобы не качать файлы целиком.

Без базового скилла `datapackage` этот инструмент бесполезен. Для анализа таблиц разработчики советуют `polars >= 1.0`, а при чтении из S3 через Pandas потребуется пакет `s3fs`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add catalyst-cooperative/agent-skills --skill pudl -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/pudl/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/pudl/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add catalyst-cooperative/agent-skills --skill pudl -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/pudl/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add catalyst-cooperative/agent-skills --skill pudl -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/pudl/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install catalyst-cooperative/agent-skills pudl
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/pudl/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add catalyst-cooperative/agent-skills --skill pudl -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/catalyst-cooperative/agent-skills --path skills/pudl
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/pudl/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add catalyst-cooperative/agent-skills --skill pudl -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/catalyst-cooperative/agent-skills/tree/HEAD/skills/pudl/SKILL.md

## Когда брать
- Найти таблицы с генерацией электроэнергии и расходами коммунальных служб
- Расшифровать названия колонок и коды в отчётах EIA и FERC
- Связать таблицы EIA и FERC по ключам `utility_id_pudl` и `plant_id_pudl`
- Загрузить нужный срез Parquet из S3 через Polars или DuckDB

## Примеры запросов агенту
- Найди в PUDL таблицы с выбросами электростанций по данным EPA CEMS
- Объясни назначение колонок в отчёте FERC Form 1 и покажи внешние ключи
- Напиши запрос на Polars для чтения среза генерации из S3 без полного скачивания файла

## Похожие
- [xlsx](https://affpapa.org/nevibecode/skills/xlsx.md) — скилл · 187223 установки
- [google-agents-cli-observability](https://affpapa.org/nevibecode/skills/google-agents-cli-observability.md) — скилл · 511300 установок
- [caveman-evidence-review](https://affpapa.org/nevibecode/skills/caveman-evidence-review.md) — скилл · 104500 установок
- [migration](https://affpapa.org/nevibecode/skills/migration.md) — скилл · 103900 установок
- [performance-optimization](https://affpapa.org/nevibecode/skills/performance-optimization.md) — скилл · 65200 установок
- [supabase](https://affpapa.org/nevibecode/skills/supabase.md) — скилл · 8 установок

Из того же набора: [catalyst-cooperative/agent-skills](https://affpapa.org/nevibecode/by/catalyst-cooperative/agent-skills.md) — 2 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md