analyze-silver-miner-metal-ratio

What problem does it solve?

This Skill provides a framework to analyze the relative valuation of silver miners versus silver price by computing and evaluating the miner-to-metal ratio, determining historical positioning, detecting divergence signals, and performing forward-looking scenario analysis.

Core Features & Use Cases

• Ratio construction: compute miner_price / metal_price and apply optional smoothing to reveal trend signals.
• Historical analysis: compute percentile ranks and identify bottom/top zones using historical distributions.
• Scenario planning: quantify how much miners would need to rise or silver would need to fall to return to a top valuation, under various assumptions.
• Use Case: a research analyst wants to validate a claim that "silver miners are near a bottom," and simulate forward performance after bottom signals.

Quick Start

• Run a quick analysis with default proxies SIL / SI=F:
  • python scripts/ratio_analyzer.py --quick
• Generate a basic visualization:
  • python scripts/ratio_plotter.py --quick --output-dir ../../output
• For a full report with historical analogs and forward returns:
  • python scripts/ratio_analyzer.py --start-date 2010-01-01 --forward-horizons 52,104,156 --output result.json