Skip to content

Commit d764b64

Browse files
melvinmtmelvinmt
committed
feat: add industry-performance-snapshot skill for daily performance
1 parent 181efbb commit d764b64

5 files changed

Lines changed: 690 additions & 0 deletions

File tree

‎README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -99,6 +99,7 @@ Copy the skill folder to your Claude skills directory.
9999
| [sector-pe-ratios](skills/sector-pe-ratios/) | Retrieve sector P/E ratios by exchange for valuation benchmarking |
100100
| [industry-pe-ratios](skills/industry-pe-ratios/) | Retrieve industry-specific P/E ratios for peer group comparisons |
101101
| [sector-performance-snapshot](skills/sector-performance-snapshot/) | Get sector-wide metrics including revenue, EBITDA, market cap, and enterprise value |
102+
| [industry-performance-snapshot](skills/industry-performance-snapshot/) | Get daily industry performance overview with average price changes |
102103

103104
## Get Your Octagon API Key
104105

‎skills/industry-performance-snapshot/SKILL.md‎

Lines changed: 302 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,302 @@
1+
---
2+
name: industry-performance-snapshot
3+
description: Retrieve a daily overview of industry performance using Octagon MCP. Use when analyzing daily price movements, average changes, and performance trends for specific industries within an exchange.
4+
---
5+
6+
# Industry Performance Snapshot
7+
8+
Retrieve daily industry performance data by exchange using the Octagon MCP server.
9+
10+
## Prerequisites
11+
12+
Ensure Octagon MCP is configured in your AI agent (Cursor, Claude Desktop, Windsurf, etc.). See [references/mcp-setup.md](references/mcp-setup.md) for installation instructions.
13+
14+
## Workflow
15+
16+
### 1. Identify Parameters
17+
18+
Determine your query parameters:
19+
- **Date**: Specific trading date
20+
- **Exchange**: NYSE, NASDAQ, etc.
21+
- **Industry**: Biotechnology, Semiconductors, Software, etc.
22+
23+
### 2. Execute Query via Octagon MCP
24+
25+
Use the `octagon-agent` tool with a natural language prompt:
26+
27+
```
28+
Retrieve a daily overview of industry performance for <DATE>, filtered by exchange <EXCHANGE> and industry <INDUSTRY>.
29+
```
30+
31+
**MCP Call Format:**
32+
33+
```json
34+
{
35+
"server": "octagon-mcp",
36+
"toolName": "octagon-agent",
37+
"arguments": {
38+
"prompt": "Retrieve a daily overview of industry performance for 2025-01-09, filtered by exchange NASDAQ and industry Biotechnology."
39+
}
40+
}
41+
```
42+
43+
### 3. Expected Output
44+
45+
The agent returns daily industry performance metrics:
46+
47+
| Metric | Value |
48+
|--------|-------|
49+
| Industry | Biotechnology |
50+
| Exchange | NASDAQ |
51+
| Date | 2025-01-09 |
52+
| Average Change | +7.89% |
53+
54+
**Interpretation**: Strong positive movement in biotechnology stocks on NASDAQ for the specified date.
55+
56+
**Data Sources**: octagon-stock-data-agent
57+
58+
### 4. Interpret Results
59+
60+
See [references/interpreting-results.md](references/interpreting-results.md) for guidance on:
61+
- Evaluating daily performance magnitude
62+
- Comparing industry vs. market moves
63+
- Identifying sector rotation signals
64+
- Tracking momentum trends
65+
66+
## Example Queries
67+
68+
**Specific Industry and Date:**
69+
```
70+
Retrieve a daily overview of industry performance for 2025-01-09, filtered by exchange NASDAQ and industry Biotechnology.
71+
```
72+
73+
**Technology Industry:**
74+
```
75+
Get today's performance for the Semiconductor industry on NASDAQ.
76+
```
77+
78+
**Multiple Industries:**
79+
```
80+
Compare daily performance of Software, Hardware, and Semiconductors on NASDAQ.
81+
```
82+
83+
**Historical Date:**
84+
```
85+
What was the Biotechnology industry performance on the last FDA approval day?
86+
```
87+
88+
**Trend Analysis:**
89+
```
90+
Show industry performance for Healthcare on NYSE over the past week.
91+
```
92+
93+
## Understanding Daily Performance
94+
95+
### What Average Change Represents
96+
97+
| Aspect | Description |
98+
|--------|-------------|
99+
| Definition | Average price change of stocks in industry |
100+
| Calculation | Mean of individual stock returns |
101+
| Weighting | Equal or market-cap weighted |
102+
| Timeframe | Single trading day |
103+
104+
### Performance Levels
105+
106+
| Change | Interpretation |
107+
|--------|----------------|
108+
| >5% | Exceptional (major catalyst) |
109+
| 2-5% | Strong move |
110+
| 0.5-2% | Moderate move |
111+
| -0.5% to +0.5% | Flat |
112+
| -2 to -0.5% | Moderate decline |
113+
| <-5% | Significant decline |
114+
115+
## Industry Categories
116+
117+
### Technology Industries
118+
119+
| Industry | Typical Volatility |
120+
|----------|-------------------|
121+
| Biotechnology | High (clinical trials, FDA) |
122+
| Semiconductors | Moderate-High (cyclical) |
123+
| Software | Moderate |
124+
| IT Services | Low-Moderate |
125+
| Hardware | Moderate |
126+
127+
### Healthcare Industries
128+
129+
| Industry | Typical Volatility |
130+
|----------|-------------------|
131+
| Biotechnology | High |
132+
| Pharmaceuticals | Moderate |
133+
| Medical Devices | Low-Moderate |
134+
| Healthcare Services | Low |
135+
136+
### Financial Industries
137+
138+
| Industry | Typical Volatility |
139+
|----------|-------------------|
140+
| Banks | Moderate (rate-sensitive) |
141+
| Insurance | Low-Moderate |
142+
| Asset Management | Moderate |
143+
| Fintech | Moderate-High |
144+
145+
## Analyzing Performance
146+
147+
### Context Matters
148+
149+
| Factor | Consideration |
150+
|--------|---------------|
151+
| Market direction | Industry vs. S&P 500 |
152+
| Sector performance | Industry vs. sector |
153+
| Historical range | Normal vs. unusual |
154+
| Catalyst presence | News-driven vs. rotation |
155+
156+
### Relative Performance
157+
158+
| Comparison | Insight |
159+
|------------|---------|
160+
| Industry > Market | Outperforming |
161+
| Industry = Market | In-line |
162+
| Industry < Market | Underperforming |
163+
164+
### Alpha Calculation
165+
166+
```
167+
Alpha = Industry Return - Market Return
168+
```
169+
170+
Example:
171+
- Industry: +7.89%
172+
- Market: +0.5%
173+
- Alpha: +7.39% (significant outperformance)
174+
175+
## Catalyst Analysis
176+
177+
### Common Industry Catalysts
178+
179+
| Catalyst | Expected Impact |
180+
|----------|-----------------|
181+
| FDA approval | Biotech +3-10% |
182+
| Earnings season | Varies |
183+
| Rate decision | Financials ±2-5% |
184+
| Product launch | Tech +1-3% |
185+
| Regulatory news | Varies |
186+
187+
### Biotechnology Specifics
188+
189+
| Event | Typical Response |
190+
|-------|------------------|
191+
| Phase 3 success | +5-20% |
192+
| FDA approval | +5-15% |
193+
| Clinical setback | -5-30% |
194+
| M&A announcement | +10-50% |
195+
196+
## Momentum Analysis
197+
198+
### Trend Signals
199+
200+
| Pattern | Interpretation |
201+
|---------|----------------|
202+
| Multiple up days | Positive momentum |
203+
| Multiple down days | Negative momentum |
204+
| Reversal | Potential trend change |
205+
| Range-bound | Consolidation |
206+
207+
### Follow-Through
208+
209+
| Signal | Reliability |
210+
|--------|-------------|
211+
| High volume + strong move | Strong signal |
212+
| Low volume + strong move | Weak signal |
213+
| Continuation next day | Trend confirmation |
214+
| Reversal next day | False move |
215+
216+
## Sector Rotation Signals
217+
218+
### Industry Leadership
219+
220+
| Pattern | Meaning |
221+
|---------|---------|
222+
| Cyclicals leading | Risk-on sentiment |
223+
| Defensives leading | Risk-off sentiment |
224+
| Growth leading | Optimistic outlook |
225+
| Value leading | Cautious approach |
226+
227+
### Rotation Indicators
228+
229+
| Observation | Interpretation |
230+
|-------------|----------------|
231+
| Biotech surging | Speculative appetite |
232+
| Utilities leading | Flight to safety |
233+
| Banks rallying | Rate expectations |
234+
| Tech selling off | Growth concerns |
235+
236+
## Exchange Considerations
237+
238+
### NASDAQ Characteristics
239+
240+
| Factor | Impact |
241+
|--------|--------|
242+
| Tech-heavy | More volatile |
243+
| Growth-oriented | Bigger moves |
244+
| Biotech concentration | FDA-sensitive |
245+
246+
### NYSE Characteristics
247+
248+
| Factor | Impact |
249+
|--------|--------|
250+
| More diversified | Moderate volatility |
251+
| Large-cap focus | Steadier moves |
252+
| Traditional industries | Less speculative |
253+
254+
## Common Use Cases
255+
256+
### Daily Monitoring
257+
```
258+
How did Biotechnology perform today?
259+
```
260+
261+
### Catalyst Research
262+
```
263+
What was the industry reaction to the FDA announcement?
264+
```
265+
266+
### Sector Rotation
267+
```
268+
Which industries are leading the market today?
269+
```
270+
271+
### Historical Analysis
272+
```
273+
What was industry performance during last quarter's earnings season?
274+
```
275+
276+
### Momentum Tracking
277+
```
278+
Is the Semiconductor industry showing positive momentum this week?
279+
```
280+
281+
## Analysis Tips
282+
283+
1. **Compare to market**: Industry move vs. S&P 500/NASDAQ.
284+
285+
2. **Check for catalysts**: News explains unusual moves.
286+
287+
3. **Consider volatility**: Biotech ±5% is normal, utilities ±5% is not.
288+
289+
4. **Track trends**: One day is noise, multiple days is signal.
290+
291+
5. **Volume matters**: High volume confirms moves.
292+
293+
6. **Look at breadth**: How many stocks participated?
294+
295+
## Integration with Other Skills
296+
297+
| Skill | Combined Use |
298+
|-------|--------------|
299+
| sector-performance-snapshot | Broader sector context |
300+
| industry-pe-ratios | Valuation with performance |
301+
| stock-performance | Individual stock details |
302+
| stock-quote | Current prices |

‎skills/industry-performance-snapshot/marketplace.json‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
{
2+
"name": "industry-performance-snapshot",
3+
"description": "Retrieve a daily overview of industry performance using Octagon MCP. Analyze daily price movements and average changes for specific industries.",
4+
"version": "1.0.0",
5+
"author": "OctagonAI",
6+
"tags": ["octagon", "industry", "performance", "daily", "returns", "momentum", "mcp"],
7+
"repository": "https://github.com/OctagonAI/skills"
8+
}

0 commit comments

Comments
 (0)