theme-detector

Aggregate FINVIZ sector performance, ETF signals, and uptrend data to rank market themes.

1|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/kavi-lin/stock --skill theme-detector-kavi-lin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: theme-detector
Source: https://github.com/kavi-lin/stock/tree/main/skills/theme-detector
Command: npx skills add https://github.com/kavi-lin/stock --skill theme-detector-kavi-lin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pandas, numpy, yfinance, requests, finvizfinance, pyyaml, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Quantifies and ranks market themes by aggregating sector performance, uptrend signals, and ETF activity to help investors identify where money is flowing.

Core Features & Use Cases

  • Cross-sector theme detection and ranking using momentum, volume, breadth, and lifecycle analysis.
  • Bullish (LEAD) and bearish (LAG) theme identification with a structured 3D scoring framework.
  • Generates JSON + Markdown reports for sharing insights and guiding decisions.

Quick Start

Run python3 skills/theme-detector/scripts/theme_detector.py to generate reports.

Frequently Asked Questions about theme-detector

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

FAQPage Schema
How do I detect trending market themes and rank sectors by performance?

FINVIZ sector performance, ETF signals, and uptrend data are aggregated to detect and rank market themes. The tool applies momentum, volume, breadth, and lifecycle analysis to identify bullish and bearish sectors within US equities.

Can I identify sector rotation and bullish themes using yfinance and pandas?

Yes, sector rotation and bullish themes can be identified using yfinance and pandas. The Skill leverages these dependencies alongside FINVIZ data to calculate uptrend signals and output structured JSON and Markdown reports.

Do I need a FINVIZ Elite subscription to run the theme detection script?

No, a FINVIZ Elite subscription is not required. The Skill supports both optional FINVIZ Elite and public mode, alongside optional FMP data, requiring only Python 3.7+ and the included dependencies to function.

What is the best way to quantify sector momentum and breadth for US equities?

The best way to quantify sector momentum and breadth for US equities is using a structured 3D scoring framework. This approach aggregates FINVIZ sector performance and ETF activity to rank market themes and identify where capital is flowing.

How do I generate JSON and Markdown reports for thematic investing analysis?

Run the included Python script to generate JSON and Markdown reports for thematic investing analysis. The script processes uptrend data and ETF signals to produce shareable insights that guide investment decisions based on sector rotation.

Why are my FINVIZ sector performance signals not capturing market theme rotation?

FINVIZ sector performance signals alone may miss market theme rotation if they lack ETF activity and uptrend data context. This Skill resolves limitations by applying a 3D scoring framework that combines momentum, volume, and breadth analysis.