CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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, Inflationary, and Transitional states. Run when user asks about macro regime, market regime change, structural rotation, or long-term market positioning.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

78%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, actionable skill body: lean tables, executable commands, documented fallbacks, and a genuine fail-closed validation note. The main gaps are the missing requirements.txt in the bundle, duplicated reference/command listings, and the absence of an explicit error-recovery step in the workflow.

Suggestions

Add requirements.txt to the bundle (or correct the install path) — the Workflow's 'pip install -r skills/macro-regime-detector/requirements.txt' references a file that is not present alongside SKILL.md, references/, and scripts/.

Consolidate the reference-file listings: the three references/*.md files appear in both the Workflow steps and the Resources section; keep the annotated listing in Resources and reference it from the Workflow to remove redundancy.

Extend the fail-closed note with an explicit recovery step, e.g., 'If no report is written or the exit is non-zero: verify FMP_API_KEY / network access, then re-run in yfinance-only mode' — turning a what-not-to-conclude note into a feedback loop.

DimensionReasoningScore

Conciseness

The body is efficient and skill-specific — tables for components, regimes, and sibling-skill comparisons, with no explanations of concepts Claude already knows. Minor trimmable redundancy remains: the three reference files are listed in both the Workflow and a separate Resources section, and the Script Arguments section partially repeats the run command from the Workflow, fitting 'minor instances of over-explanation that could be trimmed' rather than the lean 5 anchor.

4 / 5

Actionability

Concrete, copy-paste-ready commands are provided ('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/') with documented options. Minor gaps: requirements.txt is referenced but absent from the bundle, and the Script Arguments block shows 'python3 macro_regime_detector.py' without the full path context used in the Workflow — 'concrete code or commands with minor gaps'.

4 / 5

Workflow Clarity

The four-step sequence is clear with prerequisites, data-fetch fallback behavior (FMP → yfinance, SHY/TLT fallback), and an explicit fail-closed checkpoint ('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.'). It falls short of the 5 anchor because there is no explicit error-recovery step telling Claude what to do (e.g., check FMP_API_KEY, retry without key) when the script fails — the guidance only says what not to conclude.

4 / 5

Progressive Disclosure

The SKILL.md is a clean overview with well-signaled, one-level-deep references, and every referenced file (references/regime_detection_methodology.md, references/indicator_interpretation_guide.md, references/historical_regimes.md) exists in the bundle. Detailed methodology and interpretation content is appropriately split into those reference files rather than inlined, and the Resources section annotates what each contains — matching the clear-overview 5 anchor.

5 / 5

Total

17

/

20

Passed

Description

88%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete, third-person, domain-specific actions with named instruments and an explicit 'Run when...' trigger clause. The only weaknesses are a few missing natural synonyms and one broadish trigger phrase ('long-term market positioning') that could overlap with generic portfolio-positioning requests.

DimensionReasoningScore

Specificity

Multiple concrete actions are named with specific instruments: 'Detect structural macro regime transitions (1-2 year horizon)', 'Analyze RSP/SPY concentration, yield curve, credit conditions, size factor, equity-bond relationship, and sector rotation', and identification of five named regime states. Coverage is comprehensive and entirely third-person ('Detect', 'Analyze').

5 / 5

Completeness

Both questions are explicitly answered: the 'what' is concrete ('Detect structural macro regime transitions... Analyze RSP/SPY concentration, yield curve...'), and the 'when' is an explicit trigger clause ('Run when user asks about macro regime, market regime change, structural rotation, or long-term market positioning'). This matches the 5-anchor example structure of concrete what + explicit when with trigger phrases.

5 / 5

Trigger Term Quality

Good natural trigger phrases: 'macro regime', 'market regime change', 'structural rotation', 'long-term market positioning', plus named ratios (RSP/SPY, yield curve) users would mention. A few common variations are missing (e.g., 'market cycle', 'risk-on/risk-off', 'rotation trade'), which fits the 'a few natural terms missing' anchor rather than comprehensive coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — cross-asset ratio regime detection with distinctive vocabulary (RSP/SPY, five named regime states) — but the trigger phrase 'long-term market positioning' is broad enough to overlap with general portfolio-allocation skills, matching 'mostly distinct; minor overlap risk with closely related skills' rather than the minimal-conflict 5 anchor.

4 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

tradermonty/claude-trading-skills

Path

skills/macro-regime-detector/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.