Agent skill

Macro Regime Read

by SilvioBaratto in SilvioBaratto/optimizer

Read macro/FRED series from the DB and label the current market regime for the economist.

Custom licenceAuto-check passed

Install Macro Regime Read

skills CLI
$ npx skills add SilvioBaratto/optimizer --skill macro-regime-read -a claude-code

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

GitHub CLI
$ gh skill install SilvioBaratto/optimizer macro-regime-read --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/SilvioBaratto/optimizer.git skills-src && mkdir -p .claude/skills && cp -r skills-src/fund/src/fund/skills/macro-regime-read .claude/skills/macro-regime-read && 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/

Facts

Skill name
macro-regime-read
GitHub stars
176
Token cost
~403 tokens
SKILL.md length
169 words
Files
2
Skills in repo
10
Repo updated
First seen
Licence
Custom licence

At a glance

Read macro/FRED series from the DB and label the current market regime for the economist.

  • Works in 4 steps: Pull the series with… → Read the optimizer regime output… → Map to a regime enum (see reference.md):… → …
  • The run needs a regime read (calm vs turbulent
  • SKILL.md covers When to use, Load-bearing rule, Procedure and Boundaries, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Macro Regime Read is an agent skill from SilvioBaratto/optimizer. Read macro/FRED series from the DB and label the current market regime for the economist. Use when the run needs a regime read (calm vs turbulent, expansion vs stress) to condition views and de-risking. Interprets the optimizer's regime output and the macro series; it NEVER fabricates regime probabilities or weights.

Its SKILL.md is about 400 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `reference.md`).

The repository describes itself as: Quantitative portfolio construction and optimization platform built on skfolio and scikit-learn.

When your agent uses it

  • The run needs a regime read (calm vs turbulent
  • Expansion vs stress) to condition views and de-risking

Example prompts

  • “/macro-regime-read”

Workflow steps

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

  1. Pull the series with get_macro_series(names, asof) (yield curve, credit
  2. Read the optimizer regime output (turbulence / absorption ratio / mixture prob).
  3. Map to a regime enum (see reference.md): calm / normal / turbulent / stress.
  4. Emit a typed regime read (label + drivers + confidence) for views-construction.

What it can do on your machine

Read from SKILL.md and the folder at commit 63e897b. 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

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Macro Regime Read loads about 403 tokens when it runs. Until then it costs about 84 tokens; SKILL.md has 169 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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); files beside SKILL.md 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 169 words (~403 tokens).

“The economist's first step: turn raw macro/FRED series plus the optimizer's regime signal into a short, typed regime label the views step can act on.”

— opening of SKILL.md by SilvioBaratto, Custom licence
name
macro-regime-read

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in fund/src/fund/skills/macro-regime-read of SilvioBaratto/optimizer.

  • SKILL.md
  • reference.md

Open the folder on GitHubat commit 63e897b

Compare with similar skills

Macro Regime Read 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.

Macro Regime Read compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Macro Regime Read this skillSilvioBaratto/optimizer176—~403Automated safety check: PassCustom licence
Macro Regime Detectortradermonty/claude-trading-skills3k1 repos~1.2kAutomated safety check: PassMIT
FRED Macro Time Serieskansoku-trade/kansoku328—~1.1kAutomated safety check: NotesCustom licence
Macro Regimeagentii-ai/agentii-investment-intelligence207—~923Automated safety check: PassApache-2.0
Trader Regimeruvnet/ruflo74k—~408Automated safety check: NotesMIT
Form Labelsthedaviddias/Front-End-Checklist74k—~565Automated safety check: PassMIT

Similar skills

  • Macro Regime Detector

    tradermonty/claude-trading-skills

    Detect structural macro regime transitions (1-2 year horizon) using cross-asset ratio analysis.

    3k GitHub starsUsed in 1 repo~1.2k tokens
    Business, Finance & HRAuto-check passed
  • FRED Macro Time Series

    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.

    328 GitHub stars~1.1k tokensUpdated 13 days ago
    Data & AnalyticsAuto-check: notes
  • Macro Regime

    agentii-ai/agentii-investment-intelligence

    Macro regime analysis, bull bear market detection, business cycle analysis, macro environment assessment, interest rate cycle, yield curve analysis, monetary policy, fiscal policy, global macro…

    207 GitHub stars~923 tokensUpdated 10 days ago
    Business, Finance & HRAuto-check passed
  • Trader Regime

    ruvnet/ruflo

    Detect current market regime using npx neural-trader — bull/bear/ranging/volatile classification with recommended strategy.

    74k GitHub stars~408 tokensUpdated today
    Business, Finance & HRAuto-check: notes
  • Form Labels

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing rendered HTML, interactive components, or design-system patterns related to Associate labels with form controls.

    74k GitHub stars~565 tokensUpdated 3 days ago
    Frontend & DesignAuto-check passed
  • Fred Macro

    gauss314/skills

    API gratuita de la Reserva Federal (FRED): 840K+ series macroeconómicas (GDP, CPI, tasas, empleo, M2, VIX, treasuries).

    247 GitHub stars~2.2k tokensUpdated 3 mo ago
    Data & AnalyticsAuto-check passed

More from SilvioBaratto/optimizer

All 10 skills in this repo
  • Yfinance

    SilvioBaratto/optimizer

    Load proactively whenever the user works with yfinance or Yahoo Finance data — pulling price history, fetching financials or analyst data, screening stocks / funds / ETFs, streaming real-time…

    176 GitHub stars~4k tokensUpdated 2 days ago
    Auto-check: notes
  • DB Context

    SilvioBaratto/optimizer

    Complete knowledge of the optimizer PostgreSQL database: 57 ingestion tables, schema, relationships, live row counts, query patterns, and conventions.

    176 GitHub stars~6.4k tokensUpdated 2 days ago
    Auto-check: notes
  • Fund Orchestration

    SilvioBaratto/optimizer

    Sequence the fund pipeline and delegate to the four subagents (economist, allocator, risk, executor).

    176 GitHub stars~635 tokensUpdated 2 days ago
    Auto-check passed
  • Optimization Objective Map

    SilvioBaratto/optimizer

    Map a chosen ConstraintSet.objective to the correct optimizer cone / risk-measure and factory config.

    176 GitHub stars~510 tokensUpdated 2 days ago
    Auto-check passed
  • Rebalancing Execution

    SilvioBaratto/optimizer

    Translate approved target weights into paper orders under a no-trade band and an L1 turnover penalty, then place them behind human approval.

    176 GitHub stars~425 tokensUpdated 2 days ago
    Auto-check passed
  • Risk Limits Check

    SilvioBaratto/optimizer

    Validate a proposed weight vector against the ConstraintSet — drawdown ceilings nu1/nu2/nu3, ESG hard gate, robust uncertainty, and a walk-forward backtest — and BLOCK on any breach.

    176 GitHub stars~468 tokensUpdated 2 days ago
    Auto-check passed

Questions about Macro Regime Read

What does Macro Regime Read do?

Read macro/FRED series from the DB and label the current market regime for the economist. Macro Regime Read is an agent skill from SilvioBaratto/optimizer. Read macro/FRED series from the DB and label the current market regime for the economist.

When should I use Macro Regime Read?

Macro Regime Read fits situations like: the run needs a regime read (calm vs turbulent; expansion vs stress) to condition views and de-risking.

How do I install Macro Regime Read in Claude Code?

Run `npx skills add SilvioBaratto/optimizer --skill macro-regime-read -a claude-code`. Or copy the skill folder (fund/src/fund/skills/macro-regime-read in SilvioBaratto/optimizer) into .claude/skills/macro-regime-read in your project. Claude Code loads it when a task matches its description.

How do I install Macro Regime Read in Codex?

Run `npx skills add SilvioBaratto/optimizer --skill macro-regime-read -a codex`. Or copy the skill folder (fund/src/fund/skills/macro-regime-read in SilvioBaratto/optimizer) into .agents/skills/macro-regime-read in your project. Codex loads it when a task matches its description.

Can I use Macro Regime Read 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 SilvioBaratto/optimizer --skill macro-regime-read -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/macro-regime-read, .gemini/skills/macro-regime-read, .github/skills/macro-regime-read and .opencode/skills/macro-regime-read in your project.

What does Macro Regime Read need to run?

SKILL.md names no scripts, command-line tools or credentials: Macro Regime Read is instructions for the agent only.

Does Macro Regime Read access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Macro Regime Read safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Macro Regime Read use?

Macro Regime Read 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 Macro Regime Read use?

About 403 tokens (SKILL.md is roughly 1.6k 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 Macro Regime Read?

Skills that share tags, products or a category with Macro Regime Read: Macro Regime Detector (tradermonty/claude-trading-skills, 3k stars), FRED Macro Time Series (kansoku-trade/kansoku, 328 stars), Macro Regime (agentii-ai/agentii-investment-intelligence, 207 stars) and Trader Regime (ruvnet/ruflo, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Macro Regime Read?

SilvioBaratto (a GitHub user) maintains it in SilvioBaratto/optimizer, which has 176 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 7, 2026.

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