# fred-economic-data

fred-economic-data pulls economic time series from the FRED API into Claude Code, including GDP, inflation rates, and payroll numbers.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 240 repo stars
- Author: franklee16
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/franklee16/academic-research-skills/tree/HEAD/data-sourcing/fred-economic-data/SKILL.md
- Updated: 2026-09-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/fred-economic-data

## What it does

The skill connects the agent to the Federal Reserve Bank of St. Louis database. It supplies a `FREDQuery` Python helper and endpoint conventions to look up metrics, check release dates, and traverse category trees.

The tooling supports rate transformations like annual percent change, log scale, or simple differences. It also pulls regional shape and metrics information through GeoFRED endpoints.

Requests fail immediately without an API key in the `FRED_API_KEY` environment variable. You must create an account at `fredaccount.stlouisfed.org` and generate a 32-character token before running queries.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill fred-economic-data -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/fred-economic-data/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/fred-economic-data/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill fred-economic-data -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/fred-economic-data/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill fred-economic-data -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/fred-economic-data/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install franklee16/academic-research-skills data-sourcing/fred-economic-data/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/fred-economic-data/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill fred-economic-data -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/franklee16/academic-research-skills --path data-sourcing/fred-economic-data
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/fred-economic-data/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/franklee16/academic-research-skills/tree/HEAD/data-sourcing/fred-economic-data/SKILL.md

## When to use it
- fetch historical GDP or unemployment observations
- compute year-over-year inflation rates using built-in transformations
- search macroeconomic series by keywords and tags
- inspect release calendars and upcoming publication dates

## Example prompts
- Retrieve quarterly US GDP numbers from 2020 onward as percent change from a year ago.
- Search FRED for consumer sentiment series and list the top five IDs.
- Pull the last 12 months of observations for the effective federal funds rate.

## Similar
- [fred-mcp-server](https://affpapa.org/en/nevibecode/mcp/fred-mcp-server.md) — MCP server · ★ 135 repo stars
- [api-data-fetcher](https://affpapa.org/en/nevibecode/skills/api-data-fetcher.md) — skill · 208 installs
- [data-retrieval](https://affpapa.org/en/nevibecode/skills/data-retrieval.md) — skill · ★ 89 repo stars
- [AgentEcon](https://affpapa.org/en/nevibecode/mcp/agentecon.md) — MCP server · 3813 installs
- [econometric-orchestrator](https://affpapa.org/en/nevibecode/skills/econometric-orchestrator.md) — skill · ★ 89 repo stars
- [economic-impact-report](https://affpapa.org/en/nevibecode/skills/economic-impact-report.md) — skill · ★ 8052 repo stars

From the same set: [franklee16/academic-research-skills](https://affpapa.org/en/nevibecode/by/franklee16/academic-research-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
