CtrlK
BlogDocsLog inGet started
Tessl Logo

us-market-bubble-detector

Evaluates market bubble risk through quantitative data-driven analysis using the revised Minsky/Kindleberger framework v2.1. Prioritizes objective metrics (Put/Call, VIX, margin debt, breadth, IPO data) over subjective impressions. Features strict qualitative adjustment criteria with confirmation bias prevention. Supports practical investment decisions with mandatory data collection and mechanical scoring. Use when user asks about bubble risk, valuation concerns, or profit-taking timing.

58

Quality

67%

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

Fix and improve this skill with Tessl

tessl review fix ./examples/weekly-trade-strategy/.claude/skills/us-market-bubble-detector/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

60%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 evaluation workflow with clear sequencing, validation checkpoints, and a verified one-level-deep reference bundle. Its main weakness is verbosity: it restates the v2.1 revision rationale across many sections and carries contradictory '+5 limit' legacy text, inflating tokens without adding capability.

Suggestions

Consolidate the repeated v2.0-vs-v2.1 change narrative (Key Revisions, Phase 3/4 notes, Summary, Version History) into a single short section to cut ~150 lines of redundancy.

Fix the contradiction in 'Implementation Checklist' and 'Important Principles #3' which still cite a '+5 point limit' while the body caps qualitative adjustment at +3 — align these with the v2.1 rule.

Move the detailed per-indicator scoring tables and the full Output Format template into references (e.g. quick_reference or a new scoring reference), keeping SKILL.md a concise overview that points to them.

DimensionReasoningScore

Conciseness

The ~540-line body is noticeably verbose and redundant: it restates the v2.0-vs-v2.1 changes repeatedly (Key Revisions, Phase 3, Phase 4, Important Principles, Summary, Version History all re-explain the +3 cap), and even contradicts itself (Important Principles and the Implementation Checklist still say '+5 point limit' despite the body reducing it to +3), padding the token budget with content Claude could infer.

2 / 5

Actionability

Provides concrete, executable guidance — specific scoring thresholds (e.g. 'P/C < 0.70 = 2 points', 'VIX < 12 AND within 5% of 52-week high'), named data sources with URLs, and a verified companion script (scripts/bubble_scorer.py) — with only minor gaps in how to invoke the script and how to fetch each metric.

4 / 5

Workflow Clarity

The four-phase process (Data Collection -> Quantitative -> Qualitative -> Final Judgment) is clearly sequenced with explicit validation checkpoints (the confirmation-bias checklist, the Phase 1 'Do NOT proceed without data' gate, double-counting self-checks), missing a 5 only because feedback-loop error recovery after a failed fetch is implicit rather than spelled out.

4 / 5

Progressive Disclosure

Structure is good: SKILL.md is an overview pointing one level deep to real, verified reference files (implementation_guide.md, bubble_framework.md, historical_cases.md, quick_reference.md, quick_reference_en.md) and a scoring script, each with a 'When to Load References' navigation guide; kept below 5 because substantial scoring detail is inlined in SKILL.md that could live in the references.

4 / 5

Total

14

/

20

Passed

Description

75%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, specific description that names concrete indicators and includes an explicit 'Use when' trigger clause, clearly answering both what and when. Minor gaps in trigger-term variety and capability enumeration keep it just below the top anchor.

DimensionReasoningScore

Specificity

Lists several concrete actions ('Evaluates market bubble risk', 'quantitative data-driven analysis', 'mechanical scoring', 'mandatory data collection') with named indicators (Put/Call, VIX, margin debt, breadth, IPO), though the actions are framed at the skill-process level rather than as a checklist of discrete capabilities, leaving minor coverage gaps.

4 / 5

Completeness

Explicitly answers both 'what' (evaluates bubble risk via quantitative Minsky/Kindleberger scoring) and 'when' ('Use when user asks about bubble risk, valuation concerns, or profit-taking timing'), but the 'when' clause could enumerate more of the trigger scenarios detailed in the body.

4 / 5

Trigger Term Quality

Includes natural trigger phrases a user would say ('bubble risk', 'valuation concerns', 'profit-taking timing'), with good coverage of the bubble-detection domain, though a few common phrasings ('are we in a bubble', 'is the market overheated') are absent from the description itself.

4 / 5

Distinctiveness Conflict Risk

The niche (US market bubble detection via a specific quantitative framework) is mostly distinct with a clear trigger ('Use when user asks about bubble risk'), with only minor overlap risk against generic valuation or market-analysis skills.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (546 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

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.