Skip to content
SkillMixed4,990 tokens in use

US Market Bubble Detector

Scores US market bubble risk from six measured indicators and a capped qualitative adjustment, then labels a phase from Normal to Critical with a stated risk budget.

7,430 stars on the repository MIT Licensetradermonty/claude-trading-skills · skills/us-market-bubble-detector

Skill label

measured from its files

What installing US Market Bubble Detector costs

96tokens idle
4,990tokens in use
19,603tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Mixed

Script-ledMixedModel-led

Scripts do part of the work and the model's judgement does the rest.

This describes the skill's structure, how much of it is scripts. It does not say how well it works. Scripts: scripts/bubble_scorer.py.

Touches

Nothing detected: no shell, network, file writes, git or credentials in its files.

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Excellent
  • Frontmatter12/15
  • Structure25/25
  • Examples15/15
  • Output15/15
  • Size15/15
  • Resources15/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent

No findings.

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity100
  • Maintenance52
  • Community68
  • Maturity36
  • Momentum40

US Market Bubble Detector evaluates bubble risk with a revised Minsky and Kindleberger framework. It first requires measured data: CBOE put/call ratio, VIX, FINRA margin debt, S&P 500 breadth and IPO activity. Six indicators are scored mechanically from 0 to 2, and price acceleration is added from the ten-year return distribution.

A strict qualitative step adds at most three points and only with measurable evidence such as Google Trends multiples and dated media coverage. The final score maps to a phase and a risk budget. The report is an analytical framework and is not investment advice.

What You Get

  • A report with a score out of 15 and a phase from Normal through Caution, Elevated Risk and Euphoria to Critical
  • A table of six indicators with measured values, scores and rationale
  • A qualitative section where each added point lists its evidence and passes a double-counting check
  • A risk budget range and the checklist of conditions the framework describes for each phase

Common Use Cases

  • Asking whether the market looks like a bubble and getting a scored answer with sources
  • Reviewing valuation concerns against measured leverage, volatility and breadth data
  • Comparing a past score with the current one using the same fixed criteria

What Makes It Unique

Qualitative points are capped at three and each needs measurable proof, with a checklist against double counting. The version history explains how an earlier, looser revision overscored on narrative alone. A bundled scorer and reference notes on past bubbles and a data collection guide back the method.

Under The Hood

The agent collects Phase 1 data with web search and by reading public pages such as CBOE, Yahoo Finance, FINRA, Barchart and Renaissance Capital, or uses values you supply. A bundled Python script, which uses only the standard library, scores the indicators mechanically. The agent writes the final Markdown report. The skill needs no API key, and it points to reference files for the framework, historical cases and a daily checklist.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers