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 bi
By tradermonty · 2,183 installs
npx skills add tradermonty/claude-trading-skills --skill us-market-bubble-detector
Source repository · Upstream listing
US Market Bubble Detection Skill (Revised v2.1)
Key Revisions in v2.1
Critical Changes from v2.0:
1. ✅ Mandatory Quantitative Data Collection Use measured values, not impressions or speculation
2. ✅ Clear Threshold Settings Specific numerical criteria for each indicator
3. ✅ Two Phase Evaluation Process Quantitative evaluation → Qualitative adjustment (strict order)
4. ✅ Stricter Qualitative Criteria Max +3 points (reduced from +5), requires measurable evidence
5. ✅ Confirmation Bias Prevention Explicit checklist to avoid over scoring
6. ✅ Granular Risk Phases Added "Elevated Risk" phase (8 9 points) for nuanced risk management
When to Use This Skill
Use this skill when:
English:
User asks "Is the market in a bubble?" or "Are we in a bubble?"
User seeks advice on profit taking, new entry timing, or short selling decisions
User reports social phenomena (non investors entering, media frenzy, IPO flood)
User mentions narratives like "this time is different" or "revolutionary technology" becoming mainstream
User consults about risk management for existing positions
Japanese:
ユーザーが「今の相場はバブルか?」と尋ねる
投資の利確・新規参入・空売りのタイミング判断を求める
社会現象(非投資家の参入、メディア過熱、IPO氾濫)を観察し懸念を表明
「今回は違う」「革命的技術」などの物語が主流化している状況を報告
保有ポジションのリスク管理方法を相談
Evaluation Process (Strict Order)
Phase 1: Mandatory Quantitative Data Collection
CRITICAL: Always collect the following data before starting evaluation
1.1 Market Structure Data (Highest Priority)
1.2 Leverage & Positioning Data
1.3 IPO & New Issuance Data
⚠️ CRITICAL: Do NOT proceed with evaluation without Phase 1 data collection
Phase 2: Quantitative Evaluation (Quantitative Scoring)
Score mechanically based on collected data using the following criteria:
Indicator 1: Put/Call Ratio (Market Sentiment)
Indicator 2: Volatility Suppression + New Highs
Indicator 3: Leverage (Margin Debt Balance)
Indicator 4: IPO Market Overheating
Indicator 5: Breadth Anomaly (Narrow Leadership)
Indicator 6: Price Acceleration
Phase 3: Qualitative Adjustment (REVISED v2.1)
Limit: +3 points maximum (REDUCED from +5 in v2.0)
⚠️ CONFIRMATION BIAS PREVENTION CHECKLIST:
Adjustment A: Social Penetration (0 1 points, STRICT CRITERIA)
Adjustment B: Media/Search Trends (0 1 points, REQUIRES MEASUREMENT)
Adjustment C: Valuation Disconnect (0 1 points, AVOID DOUBLE COUNTING)
Phase 3 Total: Maximum +3 points
Phase 4: Final Judgment (REVISED v2.1)
Key Change in v2.1:
Added "Elevated Risk" phase (8 9 points) for more nuanced positioning
9 points is no longer extreme defensive zone (was 40% risk budget)
Now allows 50 70% risk budget at 8 9 point level
More gradual transition from Caution to Euphoria phases
Data Sources (Required)
US Market
Put/Call : https://www.cboe.com/tradable products/vix/
VIX : Yahoo Finance (^VIX) or https://www.cboe.com/
Margin Debt : https://www.finra.org/investors/learn to invest/advanced investing/margin statistics
Breadth : https://www.barchart.com/stocks/indices/sp/sp500?viewName=advanced
IPO : https://www.renaissancecapital.com/IPO Center/Stats
Japanese Market
Nikkei Futures P/C : https://www.barchart.com/futures/quotes/NO 0/options
JNIVE : https://www.investing.com/indices/nikkei volatility historical data
Margin Debt : JSF (Japan Securities Finance) Monthly Report
Breadth : https://en.macromicro.me/series/31841/japan topix index 200ma breadth
IPO : https://www.pwc.co.uk/services/audit/insights/global ipo watch.html
Implementation Checklist
Verify the following when using:
Important Principles (Revised)
1. Data Impressions
Ignore "many news reports" or "experts are cautious" without quantitative data.
2. Strict Order: Quantitative → Qualitative
Always evaluate in this order: Phase 1 (Data Collection) → Phase 2 (Quantitative) → Phase 3 (Qualitative Adjustment).
3. Upper Limit on Subjective Indicators
Qualitative adjustment has a total limit of +3 points. It cannot override quantitative evaluation.
4. "Taxi Driver" is Symbolic
Do not readily acknowledge mass penetration without direct recommendations from non investors.
Common Failures and Solutions (Revised)
Failure 1: Evaluating Based on News Articles
❌ "Many reports on Takaichi Trade" → Media saturation 2 points
✅ Verify Google Trends numbers → Evaluate with measured values
Failure 2: Overreaction to Expert Comments
❌ "Warning of overheating" → Euphoria zone
✅ Judge with measured values of Put/Call, VIX, margin debt
Failure 3: Emotional Reaction to Price Rise
❌ 4.5% rise in 1 day → Price acceleration 2 points
✅ Verify position in 10 year distribution → Objective evaluation
Failure 4: Judgment Based on Valuation Alone
❌ P/E 17 → Valuation disconnect 2 points
✅ P/E + narrative dependence + other quantitative indicators for comprehensive judgment
Recommended Actions by Bubble Stage (REVISED v2.1)
Normal (0 4 points)
Risk Budget: 100%
Continue normal investment strategy
Set ATR 2.0× trailing stop
Apply stair step profit taking rule (+20% take 25%)
Short Selling: Not Allowed
Composite conditions not met (0/7 items)
Caution (5 7 points)
Risk Budget: 70 80%
Begin partial profit taking (20 30% reduction)
Tighten ATR to 1.8×
Reduce new position sizing by 50%
Short Selling: Not Recommended
Wait for clearer reversal signals
Elevated Risk (8 9 points) ⚠️ NEW in v2.1
Risk Budget: 50 70%
Increase profit taking (30 50% reduction)
Tighten ATR to 1.6×
New positions: highly selective, quality only
Begin building cash reserves for future opportunities
Short Selling: Consider Cautiously
Only after confirming at least 2/7 composite conditions
Small exploratory positions (10 15% of normal size)
Strict stop loss (ATR 2.0×)
Rationale for NEW phase:
This zone represents heightened caution without extreme defensiveness.
Market shows warning signs but not imminent collapse.
Maintain exposure to quality positions while building flexibility.
Euphoria (10 12 points)
Risk Budget: 40 50%
Accelerate stair step profit taking (50 60% reduction)
Tighten ATR to 1.5×
No new long positions except on major pullbacks
Short Selling: Active Consideration
After confirming at least 3/7 composite conditions
Small positions (20 25% of normal size)
Defined risk only (options, tight stops)
Critical (13 15 points)
Risk Budget: 20 30%
Major profit taking or full hedge implementation
ATR 1.2× or fixed stop loss
Cash preservation mode prepare for major dislocation
Short Selling: Recommended
After confirming at least 5/7 composite conditions
Scale in with small positions, pyramid on confirmation
Tight stop loss (ATR 1.5× or higher)
Consider put options for defined risk
Composite Conditions for Short Selling (7 Items)
Only consider shorts after confirming at least 3 of the following:
Output Format
Evaluation Report Structure (v2.1)
Reference Documents
references/implementation guide.md (English) RECOMMENDED FOR FIRST USE
Step by step evaluation process with mandatory data collection
NG examples vs OK examples
Self check quality criteria (4 levels)
Red flags during review
Best practices for objective evaluation
references/bubble framework.md (Japanese)
Detailed theoretical framework
Explanation of Minsky/Kindleberger model
Behavioral psychology elements
references/historical cases.md (Japanese)
Analysis of past bubble cases
Dotcom, Crypto, Pandemic bubbles
Common pattern extraction
references/quick reference.md (Japanese)
references/quick reference en.md (English)
Daily checklist
Emergency 3 question assessment
Quick scoring guide
Key data sources
When to Load References
First use or need detailed guidance: Load implementation guide.md
Need theoretical background: Load bubble framework.md
Need historical context: Load historical cases.md
Daily operations: Load quick reference.md (Japanese) or quick reference en.md (English)
Summary: Essence of v2.1 Revision
v2.0 Problem (Identified Nov 2025):
Qualitative adjustment too loose (+5 max)
"AI narrative elevated" → +1 point (no data)
"P/E 30.8" → +1 point (double counting with quantitative)
Result: 11/16 points overly bearish without evidence
v2.1 Solution:
Qualitative adjustment stricter (+3 max)
"AI narrative elevated" → 0 points (unmeasured)
"P/E 30.8 but AI has fundamental backing" → 0 points (fundamentals support)
Result: 9/15 points balanced, data driven assessment
Key Improvements:
1. Confirmation Bias Prevention : Explicit checklist before adding qualitative points
2. Measurable Evidence Required : No points without concrete data (Google Trends, media coverage)
3. Double Counting Prevention : Valuation must not duplicate Phase 2 quantitative
4. Granular Risk Phases : Added "Elevated Risk" (8 9 points) for nuanced positioning
5. Balanced Risk Budgets : 9 points = 50 70% (not 40% extreme defensive)
Core Principle:
"In God we trust; all others must bring data." W. Edwards Deming
2025 Lesson:
Even data driven frameworks can be undermined by subjective qualitative adjustments.
v2.1 requires MEASURABLE evidence for ALL qualitative points.
Independent observers must be able to verify each adjustment.
Version History:
v2.0 (Oct 27, 2025): Mandatory quantitative data collection
v2.1 (Nov 3, 2025): Stricter qualitative criteria, confirmation bias prevention, granular risk phases
Reason for v2.1 Revision:
Prevent over scoring through unmeasured "narrative" assessments and double counting.
Ensure all bubble risk evaluations are independently verifiable and free from confirmation bias.