Individual skill
theme-detector
Detect and analyze trending market themes across sectors. Use when user asks about current market themes, trending sectors, sector rotation, thematic investing, what themes are hot or cold, or wants to identify bullish and bearish market narratives with lifecycle analysis.
skills/theme-detector/SKILL.md
Source commit 62725813263394cdd1068d9c8ae29b96d6fa3910
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- Yes
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Network or broad shell
- Last checked
- Nov 9, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 3,772
- Repository last updated
- Nov 10, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- engineering Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 19,454 bytesSKILL.mdcore · 19,454 bytesSKILL.mdcore · 19,454 bytesSKILL.mdcore · 19,454 bytesSKILL.mdcore · 19,454 bytesSKILL.mdcore · 19,454 bytesSKILL.mdcore · 19,454 bytesSKILL.mdcore · 19,454 bytesSKILL.mdcore · 19,454 bytesSKILL.mdcore · 19,454 bytesSKILL.mdcore · 19,454 bytesSKILL.mdcore · 19,454 bytesassets/report_template.mddoc · 4,559 bytesreferences/cross_sector_themes.mddoc · 11,323 bytesreferences/finviz_industry_codes.mddoc · 17,828 bytesreferences/thematic_etf_catalog.mddoc · 12,245 bytesreferences/theme_detection_methodology.mddoc · 13,599 bytesrequirements.txtdoc · 526 bytesscripts/_market_calendar.pyruns · 11,405 bytesscripts/calculators/__init__.pyruns · 37 bytesscripts/calculators/heat_calculator.pyruns · 6,070 bytesscripts/calculators/industry_ranker.pyruns · 2,874 bytesscripts/calculators/lifecycle_calculator.pyruns · 6,388 bytesscripts/calculators/theme_classifier.pyruns · 12,532 bytesscripts/calculators/theme_discoverer.pyruns · 9,618 bytesscripts/config_loader.pyruns · 4,404 bytesscripts/default_theme_config.pyruns · 10,636 bytesscripts/etf_scanner.pyruns · 30,788 bytesscripts/finviz_performance_client.pyruns · 6,837 bytesscripts/leadership.pyruns · 17,483 bytesscripts/report_generator.pyruns · 31,958 bytesscripts/representative_stock_selector.pyruns · 23,294 bytesscripts/scorer.pyruns · 3,008 bytesscripts/tests/README.mddoc · 653 bytesscripts/tests/conftest.pyruns · 298 bytesscripts/tests/test_config_loader.pyruns · 7,904 bytesscripts/tests/test_detect_divergence.pyruns · 3,971 bytesscripts/tests/test_etf_scanner.pyruns · 40,579 bytesscripts/tests/test_finviz_performance_client.pyruns · 5,302 bytesscripts/tests/test_fmp_stable_migration.pyruns · 4,116 bytesscripts/tests/test_heat_calculator.pyruns · 9,375 bytesscripts/tests/test_industry_ranker.pyruns · 10,925 bytesscripts/tests/test_leadership.pyruns · 8,925 bytesscripts/tests/test_lifecycle_calculator.pyruns · 12,279 bytesscripts/tests/test_market_calendar_contract.pyruns · 5,095 bytesscripts/tests/test_report_generator.pyruns · 26,575 bytesscripts/tests/test_representative_stock_selector.pyruns · 40,806 bytesscripts/tests/test_scorer.pyruns · 7,404 bytesscripts/tests/test_theme_classifier.pyruns · 26,776 bytesscripts/tests/test_theme_detector_e2e.pyruns · 25,815 bytesscripts/tests/test_theme_discoverer.pyruns · 19,422 bytesscripts/tests/test_theme_history.pyruns · 2,289 bytesscripts/tests/test_theme_matcher.pyruns · 3,365 bytesscripts/tests/test_uptrend_client.pyruns · 3,170 bytesscripts/theme_detector.pyruns · 44,384 bytesscripts/theme_history.pyruns · 5,209 bytesscripts/theme_matcher.pyruns · 7,064 bytesscripts/themes.yamlasset · 5,250 bytesscripts/uptrend_client.pyruns · 8,100 bytes
Read excerpt
# Theme Detector
## Overview
This skill detects and ranks trending market themes by analyzing cross-sector momentum, volume, and breadth signals. It identifies both bullish (upward momentum) and bearish (downward pressure) themes, assesses lifecycle maturity (Emerging/Accelerating/Trending/Mature/Exhausting), and provides a confidence score combining quantitative data with narrative analysis.
**3-Dimensional Scoring Model:**
1. **Theme Heat** (0-100): Direction-neutral strength of the theme (momentum, volume, uptrend ratio, breadth)
2. **Lifecycle Maturity**: Stage classification (Emerging / Accelerating / Trending / Mature / Exhausting) based on duration, extremity clustering, valuation, and ETF proliferation
3. **Confidence** (Low / Medium / High): Reliability of the detection, combining quantitative breadth with narrative confirmation. Script output is capped at Medium; Claude's WebSearch narrative confirmation step can elevate to High.
4. **Stock Leadership**: Optional daily scan-hit evidence from 5D+20%, EP9M, range expansion, new highs, and high-RS stocks. When supplied, this is blended into Theme Heat v2; when absent, it lowers confidence coverage but does not force leadership to zero.
5. **Theme Match Quality**: Specificity of the theme match from industry participation, explicit stock-basket hits, proxy ETF confirmation, and optional offline narrative scores. This is evidence quality, not a trade recommendation.
**Key Features:**