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.

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable and rigorously sequenced with validation checkpoints, and it makes good use of one-level-deep references. Its main weakness is verbosity from repeatedly restating the v2.1 revision history, which keeps conciseness at the mid anchor.

Suggestions

Consolidate the recurring v2.0-vs-v2.1 revision narrative (Key Revisions, Summary, v2.0 Problem, Key Improvements, Version History, Reason for Revision) into a single short changelog section to cut redundancy.

Move the detailed indicator scoring tables and per-phase action lists into a reference file, keeping SKILL.md as a lean overview that links out, to improve token efficiency.

Trim the inline restatement of qualitative-adjustment examples that already appear in implementation_guide.md to avoid duplicate content between the body and its reference.

Dimension	Reasoning	Score
Conciseness	The body is ~540 lines and restates the v2.0→v2.1 revision rationale across several sections ("Key Revisions", "Summary: Essence of v2.1 Revision", "v2.0 Problem", "Key Improvements", "Version History", "Reason for v2.1 Revision"), so it is mostly efficient but could be tightened; not a 1 because it avoids padding with concepts Claude already knows.	2 / 3
Actionability	Provides exact numeric thresholds ("2 points: P/C < 0.70"), concrete data-source URLs, a copy-paste output-format template, and an executable scorer script, meeting the fully-executable anchor rather than the pseudocode anchor at 2.	3 / 3
Workflow Clarity	The four phases are strictly sequenced with explicit validation gates ("Do NOT proceed with evaluation without Phase 1 data collection", confirmation-bias checklist, self-check questions, implementation checklist), matching the clear-sequence-with-validation anchor.	3 / 3
Progressive Disclosure	SKILL.md serves as an overview with one-level-deep, well-signaled references plus a "When to Load References" navigation section, and all five referenced files verified present, meeting the clear-overview-with-signaled-references anchor; a touch of inline detail could be delegated but structure is sound.	3 / 3
	Total	11 / 12 Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is third-person, concrete, and explicitly pairs a what-clause with a Use-when trigger, covering natural user phrasings. It is slightly dense but every clause carries specificity, so it lands at the top of the scale across all dimensions.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions and enumerates specific metrics ("Put/Call, VIX, margin debt, breadth, IPO data") plus "mandatory data collection and mechanical scoring", matching the multi-action anchor rather than the domain-only anchor at 2.	3 / 3
Completeness	Explicitly answers what ("Evaluates market bubble risk through quantitative data-driven analysis...") and when ("Use when user asks about bubble risk..."), satisfying the explicit-trigger anchor rather than capping at 2 for a missing when clause.	3 / 3
Trigger Term Quality	"Use when user asks about bubble risk, valuation concerns, or profit-taking timing" covers natural phrasings a user would actually say, hitting the good-coverage anchor rather than the partial-coverage anchor at 2.	3 / 3
Distinctiveness Conflict Risk	The narrow niche of market-bubble detection anchored to the "Minsky/Kindleberger framework v2.1" with distinct triggers is unlikely to fire for unrelated skills, matching the clear-niche anchor.	3 / 3
	Total	12 / 12 Passed

Validation

93%

Warnings & errors only

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

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
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
Path: examples/weekly-trade-strategy/.claude/skills/us-market-bubble-detector/SKILL.md
Commit: 62a1635

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

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.