macro-regime-detector
Detect structural macro regime transitions (1-2 year horizon) using cross-asset ratio analysis. Analyze RSP/SPY concentration, yield curve, credit conditions, size factor, equity-bond relationship, and sector rotation to identify regime shifts between Concentration, Broadening, Contraction, Inflatio…
Install / Use
npx skills add tradermonty/claude-trading-skills --skill macro-regime-detectorInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
LegalSupported Platforms
Tags
Our assessment of macro-regime-detector
macro-regime-detector scores 87/100 on our quality scale, 86th of 208 Legal skills we index (top 42%).
Its SKILL.md is 4.7 KB long, well organised into 10 sections with 1 code example: a solid amount of guidance for an agent.
With 2,885 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so macro-regime-detector is actively maintained.
- Our last check on 2026-11-02 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-30. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
macro-regime-detector compared with similar skills
All 4 of these similar skills score higher than macro-regime-detector; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| macro-regime-detector (this skill)by tradermonty | 87 | 2.9k | 53d ago | SKILL.md |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| designby nextlevelbuilder | 100 | 149.0k | 6d ago | SKILL.md |
Frequently asked questions
- How do I install macro-regime-detector?
- Run
npx skills add tradermonty/claude-trading-skills --skill macro-regime-detector. The install tabs above show the steps for each supported agent. - Which AI agents does macro-regime-detector work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is macro-regime-detector safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is macro-regime-detector still maintained?
- The repository was last updated about 2 months ago, so macro-regime-detector is actively maintained.
Skill content
View source on GitHubname: macro-regime-detector description: Detect structural macro regime transitions (1-2 year horizon) using cross-asset ratio analysis. Analyze RSP/SPY concentration, yield curve, credit conditions, size factor, equity-bond relationship, and sector rotation to identify regime shifts between Concentration, Broadening, Contraction, Inflationary, and Transitional states. Run when user asks about macro regime, market regime change, structural rotation, or long-term market positioning.
Macro Regime Detector
Detect structural macro regime transitions using monthly-frequency cross-asset ratio analysis. This skill identifies 1-2 year regime shifts that inform strategic portfolio positioning.
When to Use
- User asks about current macro regime or regime transitions
- User wants to understand structural market rotations (concentration vs broadening)
- User asks about long-term positioning based on yield curve, credit, or cross-asset signals
- User references RSP/SPY ratio, IWM/SPY, HYG/LQD, or other cross-asset ratios
- User wants to assess whether a regime change is underway
Workflow
-
Load reference documents for methodology context:
references/regime_detection_methodology.mdreferences/indicator_interpretation_guide.md
-
Execute the main analysis script:
python3 -m pip install -r skills/macro-regime-detector/requirements.txt uv run python3 skills/macro-regime-detector/scripts/macro_regime_detector.py --output-dir reports/This fetches 600 days of data for 9 ETFs. With an FMP key, the client tries FMP first and fetches Treasury rates (~10 API calls total), then falls back to yfinance for unavailable ETF history. Without an FMP key, it runs in yfinance-only mode and uses SHY/TLT as the yield-curve fallback.
The detector fails closed and writes no report when none of its six components has usable data. Do not treat a missing report or non-zero exit as a valid low-transition regime.
-
Read the generated Markdown report and present findings to user.
-
Provide additional context using
references/historical_regimes.mdwhen user asks about historical parallels.
Prerequisites
- Python dependencies (required): install
requirements.txt, including yfinance and requests - FMP API Key (optional): set
FMP_API_KEYor pass--api-keyto use FMP and Treasury data before the yfinance/SHY-TLT fallbacks - The FMP free tier may not serve every ETF; unavailable symbols automatically use yfinance
6 Components
| # | Component | Ratio/Data | Weight | What It Detects | |---|-----------|------------|--------|-----------------| | 1 | Market Concentration | RSP/SPY | 25% | Mega-cap concentration vs market broadening | | 2 | Yield Curve | 10Y-2Y spread | 20% | Interest rate cycle transitions | | 3 | Credit Conditions | HYG/LQD | 15% | Credit cycle risk appetite | | 4 | Size Factor | IWM/SPY | 15% | Small vs large cap rotation | | 5 | Equity-Bond | SPY/TLT + correlation | 15% | Stock-bond relationship regime | | 6 | Sector Rotation | XLY/XLP | 10% | Cyclical vs defensive appetite |
5 Regime Classifications
- Concentration: Mega-cap leadership, narrow market
- Broadening: Expanding participation, small-cap/value rotation
- Contraction: Credit tightening, defensive rotation, risk-off
- Inflationary: Positive stock-bond correlation, traditional hedging fails
- Transitional: Multiple signals but unclear pattern
Output
macro_regime_YYYY-MM-DD_HHMMSS.json— Structured data for programmatic usemacro_regime_YYYY-MM-DD_HHMMSS.md— Human-readable report with:- Current Regime Assessment
- Transition Signal Dashboard
- Component Details
- Regime Classification Evidence
- Portfolio Posture Recommendations
Relationship to Other Skills
| Aspect | Macro Regime Detector | Market Top Detector | Market Breadth Analyzer | |--------|----------------------|--------------------|-----------------------| | Time Horizon | 1-2 years (structural) | 2-8 weeks (tactical) | Current snapshot | | Data Granularity | Monthly (6M/12M SMA) | Daily (25 business days) | Daily CSV | | Detection Target | Regime transitions | 10-20% corrections | Breadth health score | | API Calls | ~10 | ~33 | 0 (Free CSV) |
Script Arguments
python3 macro_regime_detector.py [options]
Options:
--api-key KEY FMP API key (default: $FMP_API_KEY)
--output-dir DIR Output directory (default: current directory)
--days N Days of history to fetch (default: 600)
Resources
references/regime_detection_methodology.md— Detection methodology and signal interpretationreferences/indicator_interpretation_guide.md— Guide for interpreting cross-asset ratiosreferences/historical_regimes.md— Historical regime examples for context
Related Skills
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
design
149.0kComprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini, Atlas Cloud, or MuAPI AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
