CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

70

Quality

88%

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, information-dense skill body with concrete commands, a clear workflow, a documented fail-closed behavior, and an exemplary one-level-deep reference structure. The main defects are the missing requirements.txt referenced by the install command, minor duplicated content, and no recovery step for the documented failure mode.

Suggestions

Add a requirements.txt to the bundle (or fix the install command to reference the actual dependency-install path) so the prerequisite step in the Workflow section is executable as written.

Deduplicate the FMP API key guidance — keep it in Prerequisites and drop the repeated --api-key detail from Script Arguments, or vice versa — and consolidate the reference file listing into the Resources section only.

Add a brief recovery step after the fail-closed note, e.g. what to inspect first (FMP key validity, network failures, per-component data availability) before concluding the analysis cannot run.

DimensionReasoningScore

Conciseness

The body is lean and well compressed — the 6-component table, regime list, and comparison table convey dense information without padding, and it assumes Claude's competence throughout. It falls short of 5 due to minor redundancy: the FMP API key guidance appears in both "Prerequisites" and "Script Arguments", and the three reference documents are listed twice (Workflow step 1/4 and the "Resources" section).

4 / 5

Actionability

The workflow gives mostly executable guidance: a concrete install command, a ready-to-run `uv run python3 skills/macro-regime-detector/scripts/macro_regime_detector.py --output-dir reports/` invocation, and documented CLI options. It is not 5 because the install step targets `skills/macro-regime-detector/requirements.txt`, a file that does not exist anywhere in the bundle (only SKILL.md, references/, and scripts/ are present), so the prerequisite step as written would fail.

4 / 5

Workflow Clarity

The 4-step workflow (load references → run script → read report → present findings) is clearly sequenced and includes an explicit failure-mode 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 stops short of 5 because there is no recovery guidance for that failure (e.g., what to check or retry), only a warning not to misread it.

4 / 5

Progressive Disclosure

SKILL.md is a clean overview: methodology and interpretation detail are pushed to `references/regime_detection_methodology.md`, `references/indicator_interpretation_guide.md`, and `references/historical_regimes.md` — all of which exist in the bundle — referenced one level deep and clearly signaled both in the workflow and in a Resources section. No inlining of content that belongs in separate files.

5 / 5

Total

17

/

20

Passed

Description

92%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 capability list, explicit "Run when" triggers, and a well-delineated niche with named regime states and specific cross-asset ratios. The only gap is modest synonym coverage in the trigger terms (e.g., "market cycle", "regime shift").

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities — "Analyze RSP/SPY concentration, yield curve, credit conditions, size factor, equity-bond relationship, and sector rotation" — and names all five output states (Concentration, Broadening, Contraction, Inflationary, Transitional), giving comprehensive and specific coverage. It is not the 4 anchor because nothing significant is missing: the inputs, the analysis actions, and the classification outputs are all explicit.

5 / 5

Completeness

It explicitly answers both questions: what it does ("Detect structural macro regime transitions (1-2 year horizon) using cross-asset ratio analysis...") and when to use it ("Run when user asks about macro regime, market regime change, structural rotation, or long-term market positioning"). This matches the anchor-5 example structure of concrete capabilities followed by explicit trigger phrases; there is no weak 'when' that would drop it to 4.

5 / 5

Trigger Term Quality

"Run when user asks about macro regime, market regime change, structural rotation, or long-term market positioning" provides good natural phrasing users would actually say. Not a 5 because common synonyms like "market cycle", "regime shift", or "broadening/rotation trade" are missing, leaving a few natural trigger variations uncovered.

4 / 5

Distinctiveness Conflict Risk

"RSP/SPY concentration", "yield curve", "HYG-style credit conditions", and named regime states carve out a clear niche with distinct trigger phrases ("macro regime", "market regime change"), minimizing conflict risk with generic market-analysis skills. It sits above the 4 anchor because the trigger terms are specific to regime detection rather than merely naming file types or broad domains.

5 / 5

Total

19

/

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
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.