Agent skill · Design & Presentation

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.

BaggaT236github.com/BaggaT236GitHub ↗
claude-codeships scriptsMIT
Install
npx skills add BaggaT236/AI-Trading-Skills --skill theme-detector --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 39
SKILL.md size: 15 KB
Bundled scripts: yes
Path: skills/theme-detector/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 118
Language: Python

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# 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. **Key Features:** - Cross-sector theme detection using FINVIZ industry data - Direction-aware scoring (bullish and bearish themes) - Lifecycle maturity assessment to identify crowded vs. emerging trades - ETF proliferation scoring (more ETFs = mo

What's inside
Steps it walks through
  1. Overview
  2. When to Use This Skill
  3. Prerequisites
  4. Workflow
  5. Step 1: Verify Environment
  6. Step 2: Execute Theme Detection Script
  7. Step 3: Read and Parse Detection Results
  8. Step 4: Perform Narrative Confirmation via WebSearch
  9. Step 5: Analyze Results and Provide Recommendations
  10. Step 6: Generate Final Report
  11. Output
  12. Resources
  13. Scripts Directory (scripts/)
  14. References Directory (references/)
Ships with 24 files
  • assets/report_template.md
  • references/cross_sector_themes.md
  • references/finviz_industry_codes.md
  • references/thematic_etf_catalog.md
  • references/theme_detection_methodology.md
  • scripts/calculators/__init__.py
  • scripts/calculators/heat_calculator.py
  • scripts/calculators/industry_ranker.py
  • scripts/calculators/lifecycle_calculator.py
  • scripts/calculators/theme_classifier.py
  • scripts/calculators/theme_discoverer.py
  • scripts/config_loader.py
  • scripts/default_theme_config.py
  • scripts/etf_scanner.py
  • scripts/finviz_performance_client.py
  • scripts/report_generator.py
  • scripts/representative_stock_selector.py
  • scripts/scorer.py
  • scripts/tests/README.md
  • scripts/tests/conftest.py
  • scripts/tests/test_config_loader.py
  • scripts/tests/test_detect_divergence.py
  • scripts/tests/test_etf_scanner.py
  • scripts/tests/test_finviz_performance_client.py
first 24 of 39
Commands it runs
pip install requests beautifulsoup4 lxml pandas numpy yfinance
uv run --python 3.12 \
python skills/theme-detector/scripts/theme_detector.py \
export FINVIZ_API_KEY=your_finviz_elite_api_key_here
export FMP_API_KEY=your_fmp_api_key_here
Verify FINVIZ Elite API key (optional but recommended)
echo $FINVIZ_API_KEY
Verify FMP API key (optional)
echo $FMP_API_KEY
python3 skills/theme-detector/scripts/theme_detector.py \
More from AI-Trading-Skills
All skills →
About this skill
What does the theme-detector skill do?

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.

How do I install it?

Run `npx skills add BaggaT236/AI-Trading-Skills --skill theme-detector --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From BaggaT236/AI-Trading-Skills, a repository with 118 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going