skills/supply-chain-event-analyst/SKILL.md
Map up/downstream dependencies (suppliers/customers), identify critical bottlenecks, and correlate historical events (disruptions, contracts) with price action for Technology/Semis, Industrial, Energy, and Chemical stocks. Use when user asks for 產業鏈, 供應鏈, 上下游, supply chain analysis, key customers, major suppliers, or dependencies for a ticker.
npx skillsauth add kavi-lin/stock supply-chain-event-analystInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
⚠️ DEPRECATED (v3.14.2)
This skill has been superseded by
scripts/nexus/supply_chain.py, the Nexus knowledge-graph supply-chain generator. The legacychain_mapper.pystub here only resolves FMP profile data; it never did the WebSearch-heavy ecosystem mapping the SKILL.md prescribed. Production paths (Nexus Tier-1 loader, supply-chain page,/api/supply-chain/generate) all use the Nexus generator now.Replacements:
- Generate a supply chain for a theme/ticker →
python3 scripts/nexus/supply_chain.py <theme_or_ticker>(router-driven; codex / claude / gemini all work).- Quick supplier/customer probe → call FMP
/company/profile/<TICKER>directly, or keep usingchain_mapper.py(2.7 KB stub) for the same data.This SKILL.md +
chain_mapper.pyare retained as read-only reference for the dependency_logic.json schema and historical context. No new feature work will land here. New callers should target the Nexus path.
Deconstruct a company's ecosystem to identify vulnerability to external shocks (raw material prices, customer demand shifts, geopolitical disruptions). This skill bridges the gap between macro sector trends and individual ticker performance by tracing value transmission.
python3 skills/supply-chain-event-analyst/scripts/chain_mapper.py <TICKER> to get basic sector info and check for existing cache.[TICKER] major suppliers 2024-2026 revenue exposure[TICKER] largest customers list annual report[TICKER] key raw materials and component dependenciesskills/supply-chain-event-analyst/references/dependency_logic.json to identify which nodes in the sector value chain are most critical.supply chain disruption, factory shutdown, key contract win, supplier bankruptcy, price hike, tariff impact.Assign a Dependency Score (1-10):
| Sector | Focus Nodes | Key Warning Signals | |---|---|---| | Semiconductors | EDA -> Equipment -> Foundry -> OSAT | Lead time increases, TSM utilization, Export curbs | | Energy | E&P -> Refining -> Storage | WTI/Brent spread, Inventory builds, Regional conflict | | Industrial | Raw Materials -> Components -> Assembly | Freight rates, Order backlog, PMI New Orders | | Chemicals | Feedstock -> Speciality -> Application | Natural Gas prices, Feedstock costs, Environmental reg |
earnings-valuation-forecaster (e.g., Adjusting EPS growth down if input costs rise).python3 skills/supply-chain-event-analyst/scripts/chain_mapper.py <TICKER>development
# earnings-analyst — 個股財報深度分析 > **Trigger**: `財報 [TICKER]` > **Version**: V1.0 > **Data Source**: FMP HTTP REST(`$FMP_API_KEY`) ## 目的 針對單一個股產出**深度財報分析報告**(逐季趨勢、品質指標、估值、分析師共識),涵蓋 sector V1.4 與 `分析 [TICKER]` 既有 protocol **沒有**的「財報層級」深潛內容。 ## 與既有 skill 的差異 | Skill | 重點 | 觸發 | |---|---|---| | `us-stock-analysis` | 估值/技術/情緒 snapshot(yfinance + FMP partial) | Phase 2 fundamentals lane | | `earnings-valuation-forecaster` | 12M 目標價 3×3 敏感度 | ad-hoc / earnings 前 14 天 | | `earnings-trade-analyzer` |
testing
Daily Top N hot themes × Top M short-term movers per theme. Combines theme-detector heat scoring (medium-term) with short-term-target predictions (1d/5d/15d) into a "Tactical Opportunity Radar" recommendation log. Tags concentration WARNING when ≥2 picks share theme. Records FRED + market regime snapshot at recommendation time for future backtest cross-tabs. Standalone — not auto-wired into investment_protocol. Use for daily watchlist refresh / Dashboard推薦面板feed / batch screening across hot themes.
testing
Short-term (1d / 5d / 15d) directional projection for a US stock — "Tactical Opportunity Radar". Outputs target range + confidence breakdown + benchmark-relative alpha + trading meta (stop / position size hint / exit trigger). Each horizon uses independent weights from config/weights.yaml. Refuses to project when source data is stale (returns insufficient_data with reasons). Hard-clamped to prevent cold-start absurd predictions. Use when caller wants short-term directional bias on a specific ticker, NOT for long-term valuation (use earnings-valuation-forecaster for 12-month). Standalone — not auto-wired into investment_protocol.
tools
Shared Finnhub API client used by other skills. Provides rate-limited (60/min), cached, retry-aware access to 17 Finnhub endpoints covering quotes, OHLCV, fundamentals, earnings calendar, earnings surprises, insider transactions, recommendation history, price targets, upgrades/downgrades, dividends, splits, IPOs, and SEC filings. Also exports adapters that normalize Finnhub raw responses into FMP-compatible shapes so that downstream code can swap providers without changing call sites. Use when another skill needs Finnhub data or when building a unified provider layer.