Agent skill

FRED Macro Time Series

by kansoku-trade in kansoku-trade/kansoku

Looks up US and global macro series from St. Louis Fed FRED, such as CPI, GDP, Fed funds, yields, M2 and the dollar index, and reports them with units and dates.

Custom licenceAuto-check: notesData & Analytics

Install FRED Macro Time Series

skills CLI

$ npx skills add kansoku-trade/kansoku --skill fred -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install kansoku-trade/kansoku fred --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/kansoku-trade/kansoku.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/fred .claude/skills/fred && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "fred" agent skill from https://github.com/kansoku-trade/kansoku/tree/main/.claude/skills/fred into .claude/skills/fred/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "fred", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/kansoku-trade/kansoku/tree/main/.claude/skills/fred

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add kansoku-trade/kansoku --skill fred -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install kansoku-trade/kansoku fred --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/kansoku-trade/kansoku.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/fred .agents/skills/fred && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "fred" agent skill from https://github.com/kansoku-trade/kansoku/tree/main/.claude/skills/fred into .agents/skills/fred/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "fred", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add kansoku-trade/kansoku --skill fred -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install kansoku-trade/kansoku fred --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/kansoku-trade/kansoku.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/fred .cursor/skills/fred && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "fred" agent skill from https://github.com/kansoku-trade/kansoku/tree/main/.claude/skills/fred into .cursor/skills/fred/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "fred", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/kansoku-trade/kansoku.git --path .claude/skills/fred

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add kansoku-trade/kansoku --skill fred -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install kansoku-trade/kansoku fred --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/kansoku-trade/kansoku.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/fred .gemini/skills/fred && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "fred" agent skill from https://github.com/kansoku-trade/kansoku/tree/main/.claude/skills/fred into .gemini/skills/fred/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "fred", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install kansoku-trade/kansoku fred

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add kansoku-trade/kansoku --skill fred -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/kansoku-trade/kansoku.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/fred .github/skills/fred && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "fred" agent skill from https://github.com/kansoku-trade/kansoku/tree/main/.claude/skills/fred into .github/skills/fred/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "fred", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add kansoku-trade/kansoku --skill fred -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install kansoku-trade/kansoku fred --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/kansoku-trade/kansoku.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/fred .opencode/skills/fred && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "fred" agent skill from https://github.com/kansoku-trade/kansoku/tree/main/.claude/skills/fred into .opencode/skills/fred/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "fred", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: fred
GitHub stars: 328
Token cost: ~1.1k tokens
SKILL.md length: 306 words
Files: 4 (incl. scripts)
Skills in repo: 13
Repo updated: Sep 26, 2026
First seen: Oct 7, 2026
Licence: Custom licence

At a glance

Looks up US and global macro series from St. Louis Fed FRED, such as CPI, GDP, Fed funds, yields, M2 and the dollar index, and reports them with units and dates.

Works in 3 steps: Resolve user phrasing to a FRED series… → Run series.py for observations + metadata. → Synthesise NL reply with units,…
Checking the latest CPI, core CPI or PCE reading and when it was published
SKILL.md covers When to use, Workflow, CLI examples and Output shape, plus 4 more sections
Runs Python scripts from its folder; calls python3; needs FRED_API_KEY

What it does

The skill turns everyday phrasing into a FRED series ID, first through a curated aliases.json that holds English and Chinese names, and when no alias fits, through scripts/search.py, which picks the most popular series that is not discontinued. scripts/series.py then returns the observations and metadata for that series. Triggers include inflation measures, GDP, unemployment and nonfarm payrolls, Fed funds and SOFR, Treasury yields and the yield curve, M1 and M2, the dollar index, VIX, breakevens, oil and gold prices, consumer sentiment, housing starts and retail sales.

The reply narrates the data in plain language with units, frequency and last update date, and credits the St. Louis Fed (FRED) as the source. The scripts print JSON with an ok flag and a list of dated values, and their exit codes tell the agent how to react to errors. Environment settings load automatically from a .env file at the project root, or from ~/.config/market-intel/env as a fallback, and replies follow the language you write in, English or Chinese.

When your agent uses it

Checking the latest CPI, core CPI or PCE reading and when it was published
Pulling unemployment, GDP or nonfarm payroll history
Comparing the yield curve, Fed funds rate or M2 over time
Finding a macro series from a plain-language name

Example prompts

“What's the latest core CPI reading, and when was it updated?”
“Show me the 10Y yield and the yield curve spread over recent months.”
“Pull the unemployment rate and nonfarm payrolls and describe the trend.”

Requirements

Python 3
Settings in a .env file at the project root or in ~/.config/market-intel/env
Network access to FRED

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

Resolve user phrasing to a FRED series ID — first via aliases.json (curated), then search.py if no alias matches.
Run series.py for observations + metadata.
Synthesise NL reply with units, frequency, and last update date; cite "Source: St. Louis Fed (FRED)".

What it can do on your machine

Read from SKILL.md and the folder at commit 8fa9a03. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 2 files in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
- python3
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
- fred.stlouisfed.org
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- FRED_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

FRED Macro Time Series loads about 1.1k tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 306 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~25
When it runs · the whole SKILL.md, loaded when a task matches: ~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NoteMentions a .env fileSKILL.md:31

nt is auto-loaded on script import from `.env` at project root (or `~/.config/market-intel/env` as fallback) — no manual

NoteMentions a .env fileSKILL.md:98

ed.org/docs/api/api_key.html and add to `.env` at project root. |

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 306 words (~1,055 tokens).

name: fred

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files (scripts) in .claude/skills/fred of kansoku-trade/kansoku.

SKILL.md
aliases.json
scripts/search.py
scripts/series.py

Open the folder on GitHubat commit 8fa9a03

Compare with similar skills

FRED Macro Time Series next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

FRED Macro Time Series compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
FRED Macro Time Series this skillkansoku-trade/kansoku	328	—	~1.1k	Automated safety check: Notes	Custom licence	14 days ago
Kqlmicrosoft/fabric-rti-mcp	131	—	~6.2k	Automated safety check: Pass	MIT	9 days ago
Data Scientistdavila7/claude-code-templates	33k	8 repos	~2.6k	Automated safety check: Pass	MIT	today
Scientific Toolkit SkillzLanqing/codex-claude-academic-skills	4.7k	—	~1.2k	Automated safety check: Pass	MIT	4 mo ago
Data Sciencetravisjneuman/.claude	100	—	~2.3k	Automated safety check: Pass	MIT	yesterday
Exploring Dataoaustegard/claude-skills	150	—	~1.7k	Automated safety check: Pass	MIT	yesterday

Similar skills

Kql
microsoft/fabric-rti-mcp
Official
KQL language expertise for writing correct, efficient Kusto queries using the Fabric RTI MCP tools.
131 GitHub stars~6.2k tokensUpdated 9 days ago
Data & AnalyticsAuto-check passed
Data Scientist
davila7/claude-code-templates
Expert data scientist for advanced analytics, machine learning, and statistical modeling.
33k GitHub starsUsed in 8 repos~2.6k tokens
Data & AnalyticsAuto-check passed
Scientific Toolkit Skill
zLanqing/codex-claude-academic-skills
Research computing toolkit for optoelectronic information science and engineering, MATLAB/Octave, Python scientific analysis, signal processing, image processing, statistics, simulation…
4.7k GitHub stars~1.2k tokensUpdated 4 mo ago
Data & AnalyticsAuto-check passed
Data Science
travisjneuman/.claude
Data science and analytics expertise for statistical analysis, machine learning pipelines, data governance, business intelligence, predictive modeling, and analytics strategy.
100 GitHub stars~2.3k tokensUpdated yesterday
Data & AnalyticsAuto-check passed
Exploring Data
oaustegard/claude-skills
Exploratory data analysis. An agent skill from oaustegard/claude-skills.
150 GitHub stars~1.7k tokensUpdated yesterday
Data & AnalyticsAuto-check passed
Azure Kusto
microsoft/GitHub-Copilot-for-Azure
Official
Query and analyze data in Azure Data Explorer (Kusto/ADX) using KQL for log analytics, telemetry, and time series analysis.
255 GitHub starsUsed in 1 repo~2.1k tokens
Data & AnalyticsAuto-check passed

More from kansoku-trade/kansoku

All 13 skills in this repo

Korea Market Quotes
kansoku-trade/kansoku
Fetches KOSPI, KOSDAQ, SK Hynix and Samsung quotes from Yahoo Finance and runs a capitulation-reversal test on Korean chip-stock selloffs.
328 GitHub stars~1.7k tokensUpdated 14 days ago
Auto-check passed
Trump Truth Social Monitor
kansoku-trade/kansoku
Pulls recent Truth Social posts from a public RSS mirror, sorts them into market-relevant topic buckets and prepares them for market-impact grading, with an archive mode.
328 GitHub stars~2.2k tokensUpdated 14 days ago
Auto-check passed
Trade Decision Gate
kansoku-trade/kansoku
Runs a fixed checklist before any buy, add, sell or trim, scores the result, logs each verdict as JSON and flags trades that went against it.
328 GitHub stars~2k tokensUpdated 14 days ago
Auto-check passed
US Capital Rotation Scanner
kansoku-trade/kansoku
Takes one end-of-session reading of US capital flow across sector cohorts, names the dominant rotation narrative and saves a dated journal file.
328 GitHub stars~1.9k tokensUpdated 14 days ago
Auto-check passed
GDELT News and Tone Search
kansoku-trade/kansoku
Queries the GDELT 2.0 Doc API for multilingual global news, article lists, tone timelines and volume charts, with a helper script and a request throttle.
328 GitHub stars~1k tokensUpdated 14 days ago
Auto-check passed
HiThink A-Share Market Data
kansoku-trade/kansoku
Pulls mainland China A-share data from HiThink's official API: limit-up pools, dragon-tiger lists, hot rankings, move explanations, financial statements, quote snapshots and daily candles.
328 GitHub stars~1.8k tokensUpdated 14 days ago
Auto-check: notes

Questions about FRED Macro Time Series

What does FRED Macro Time Series do?

Looks up US and global macro series from St. Louis Fed FRED, such as CPI, GDP, Fed funds, yields, M2 and the dollar index, and reports them with units and dates. py, which picks the most popular series that is not discontinued.py then returns the observations and metadata for that series.

When should I use FRED Macro Time Series?

FRED Macro Time Series fits situations like: checking the latest CPI, core CPI or PCE reading and when it was published; pulling unemployment, GDP or nonfarm payroll history; comparing the yield curve, Fed funds rate or M2 over time; finding a macro series from a plain-language name.

How do I install FRED Macro Time Series in Claude Code?

Run `npx skills add kansoku-trade/kansoku --skill fred -a claude-code`. Or copy the skill folder (.claude/skills/fred in kansoku-trade/kansoku) into .claude/skills/fred in your project. Claude Code loads it when a task matches its description.

How do I install FRED Macro Time Series in Codex?

Run `npx skills add kansoku-trade/kansoku --skill fred -a codex`. Or copy the skill folder (.claude/skills/fred in kansoku-trade/kansoku) into .agents/skills/fred in your project. Codex loads it when a task matches its description.

Can I use FRED Macro Time Series in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add kansoku-trade/kansoku --skill fred -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/fred, .gemini/skills/fred, .github/skills/fred and .opencode/skills/fred in your project.

What does FRED Macro Time Series need to run?

Going by SKILL.md and its folder, FRED Macro Time Series needs Python for the scripts in its folder, the command-line tools its instructions call (python3) and credentials named FRED_API_KEY. Our summary lists: Python 3; Settings in a .env file at the project root or in ~/.config/market-intel/env; Network access to FRED.

Does FRED Macro Time Series access the network?

SKILL.md names 1 domain. As links in the text: fred.stlouisfed.org. This is read from the text; nothing was executed.

Is FRED Macro Time Series safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does FRED Macro Time Series use?

FRED Macro Time Series has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does FRED Macro Time Series use?

About 1.1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to FRED Macro Time Series?

Skills that share tags, products or a category with FRED Macro Time Series: Kql (microsoft/fabric-rti-mcp, 131 stars), Data Scientist (davila7/claude-code-templates, 33k stars), Scientific Toolkit Skill (zLanqing/codex-claude-academic-skills, 4.7k stars) and Data Science (travisjneuman/.claude, 100 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains FRED Macro Time Series?

kansoku-trade (a GitHub organization) maintains it in kansoku-trade/kansoku, which has 328 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on September 26, 2026.

Source: kansoku-trade/kansoku on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install FRED Macro Time Series

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Files

Compare with similar skills

Similar skills

More from kansoku-trade/kansoku

Related

Questions about FRED Macro Time Series