us-market-bubble-detector

Analyze US market indicators to score bubble risk with mechanical criteria.

2|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/k1064190/stock-expectation --skill us-market-bubble-detector-k1064190
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: us-market-bubble-detector
Source: https://github.com/k1064190/stock-expectation/tree/main/.claude/skills/_archived/us-market-bubble-detector
Command: npx skills add https://github.com/k1064190/stock-expectation --skill us-market-bubble-detector-k1064190

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pypdf, pdfplumber, pdf2image, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a quantitatively-driven assessment of market bubble risk, specifically for the US market.

Core Features & Use Cases

  • Quantitative Data Collection: Gather data on market indicators such as put/call ratios, VIX, margin debt, etc.
  • Qualitative Adjustments: Apply strict criteria for qualitative adjustments to avoid confirmation bias.
  • Risk Assessment: Offers a risk score and corresponding risk budget to inform investment decisions.
  • Use Case: A user queries about the current market bubble risk. The Skill collects relevant data and provides a detailed analysis with a risk assessment.

Quick Start

Run the bubble_scorer script with the following command: python scripts/bubble_scorer.py --ticker SPY --period 1y.

Frequently Asked Questions about us-market-bubble-detector

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I assess US market bubble risk using quantitative indicators?

Detect market bubbles by gathering data on indicators like put/call ratios, VIX, margin debt, and IPO data, then applying strict qualitative criteria to generate a mechanical risk score for investment decisions.

What quantitative data is needed for market bubble detection?

Market bubble detection requires quantitative data on put/call ratios, VIX, margin debt, and IPO data to ensure all qualitative points are supported by measurable evidence and prevent confirmation bias.

How do I run a bubble risk assessment for a specific ticker?

Run a bubble risk assessment by executing the bubble_scorer script with parameters like `--ticker SPY --period 1y` to collect relevant market data and output a detailed analysis with a mechanical risk score.

Does this bubble detection approach prevent confirmation bias?

This bubble detection approach prevents confirmation bias by applying strict criteria for qualitative adjustments and ensuring all qualitative points are supported by mandatory, measurable data collection.

What outputs does the bubble scorer provide for investment strategy?

The bubble scorer outputs a mechanical risk score and a corresponding risk budget to satisfy practical investment decision-making and inform your overall investment strategy.