etf-premium

etf-premium is a skill for Claude Code from himself65/finance-skills. It costs 223 tokens per session (5,055 once invoked), scanned A, original, MIT.

An analysis of an exchange-traded fund (ETF), a fund traded like a stock, compared with its net asset value (NAV), the value of what it holds. It also examines why the trading price may move away from that value.

In plain words
What is it for?
Use it to measure an ETF's premium or discount to NAV and investigate unusual one-day price surges or divergence from its holdings.
Why use it?
It helps explain when an ETF trades above or below the value of its underlying holdings and separates asset-value changes from other market effects.

Skill for Claude Code

Written for Claude Code: dynamic context !`command`.

Part of the finance-market-analysis plugin — 11 skills shipped together

Good fit Use it to measure an ETF's premium or discount to NAV and investigate unusual one-day price surges or divergence from its holdings.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/himself65/finance-skills/etf-premium
About the project

Finance Skills is a collection of agent skills for financial analysis and trading, covering activities such as company valuation, earnings research, market analysis, and options calculations. It is for users who want coding agents to perform structured finance workflows, and the catalogue contains its skills, plugins, instructions, and MCP integration.

himself65/finance-skills · 3,302 stars · on GitHub · skills.himself65.com

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add himself65/finance-skills --skill etf-premium
Clone the repo
git clone --depth 1 https://github.com/himself65/finance-skills

Made for: Claude Code.

Or install finance-market-analysis, the plugin that ships this one along with the rest of its 11 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for etf-premium

README.md
[![agentmods](https://agentmods.dev/badge/skills/himself65/finance-skills/etf-premium/github.svg)](https://agentmods.dev/skills/himself65/finance-skills/etf-premium)
Your own site
<a href="https://agentmods.dev/skills/himself65/finance-skills/etf-premium"><img src="https://agentmods.dev/badge/skills/himself65/finance-skills/etf-premium/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for etf-premium

Your own site · 80×15
<a href="https://agentmods.dev/skills/himself65/finance-skills/etf-premium"><img src="https://agentmods.dev/badge/skills/himself65/finance-skills/etf-premium.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 223 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 5,055 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • Socket pass 12 May 2026
  • Snyk warn 12 May 2026
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00223 $0.05055
Opus 5 $0.00112 $0.02527
Sonnet 5 $0.00045 $0.01011
Haiku 4.5 $0.00022 $0.00505

Measured 10d ago against content hash 2feb9285691b, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

etf-premium scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Runs shell commandslowCapability

Expected in a hook, worth knowing in a rule or an instructions file.

subprocess.check_call([sys.executable, "-m", "pip", "install", "-q", "yfinance", "pandas", "numpy"])
plugins/market-analysis/skills/etf-premium/SKILL.md · 402 lines

How it starts

The opening of the file, as written. The whole thing — 402 lines — stays where its author put it; the contents beside it link to each section on GitHub.

ETF Premium/Discount Analysis Skill

Calculates the premium or discount of an ETF's market price relative to its Net Asset Value (NAV) using data from Yahoo Finance via yfinance.

Why this matters: An ETF's market price can diverge from the value of its underlying holdings (NAV). When you buy at a premium, you're overpaying relative to the assets; at a discount, you're getting a bargain. This divergence is typically small for liquid US equity ETFs but can be significant for bond ETFs, international ETFs, leveraged/inverse products, and crypto ETFs — especially during periods of market stress.

Important: For research and educational purposes only. Not financial advice. yfinance is not affiliated with Yahoo, Inc.


Step 1: Ensure Dependencies Are Available

Current environment status:

!`python3 -c "exec('try:\n import yfinance, pandas, numpy\n print(f\'yfinance={yfinance.__version__} pandas={pandas.__version__} numpy={numpy.__version__}\')\nexcept Exception:\n print(\'DEPS_MISSING\')')"`

If DEPS_MISSING, install required packages:

import subprocess, sys
subprocess.check_call([sys.executable, "-m", "pip", "install", "-q", "yfinance", "pandas", "numpy"])

If already installed, skip and proceed.


Step 2: Route to the Correct Sub-Skill

Classify the user's request and jump to the matching section. If the user asks a general question about an ETF's premium or discount without specifying a particular analysis type, default to Sub-Skill A (Single ETF Snapshot).

User Request Route To Examples
Single ETF premium/discount Sub-Skill A: Single ETF Snapshot "is SPY at a premium?", "AGG premium to NAV", "BITO premium"
Compare multiple ETFs Sub-Skill B: Multi-ETF Comparison "compare bond ETF discounts", "which has bigger premium IBIT or BITO", "rank these ETFs by premium"
Screener / find extreme premiums Sub-Skill C: Premium Screener "which ETFs have biggest discount", "find ETFs trading below NAV", "premium screener"
Deep analysis with context Sub-Skill D: Premium Deep Dive "why is HYG at a discount", "is ARKK premium normal", "ETF premium analysis with context"
Sudden premium surge / gamma squeeze Sub-Skill E: Premium Surge Decomposition "why did KWEB jump 13% today", "is this ETF rally driven by gamma", "decompose today's ETF move", "dealer GEX for SOXL", "how long until the premium converges"

Read the full file on GitHub · 402 lines

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago First seen · 402 lines · 223 tokens per session scan A 2feb9285691b

Subscribe to this mod's changes

etf-premium is a skill published in the GitHub repository himself65/finance-skills (3,302 stars, last pushed 13d ago), licensed MIT. It adds 223 tokens to every session and 5,055 once invoked, about $0.0011 per session on Opus 5. A static security scan graded it A with 1 finding (runs shell commands). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

quotient

Prediction-market intelligence for Polymarket agents. Quotient runs a multi-role AI forecasting pipeline over 1,600+ sources and publishes daily trade signals with side, entry prices, conviction tiers, capacity, and convergence reads. Pull forecasts (with what-changed deltas), recent sources (articles + X posts), the…

BankrBot/skills · 201 tokens

delu-oracle

Full-cognition token analysis for Base EVM tokens via the deluagent oracle. Pass a CA or cashtag, get back a flat decision header (action, conviction, entry/stop/size, read) plus full cognition report. Tiered x402 pricing — 100M+ DELU free, 50M+ 50k DELU, public 250k DELU. Sequential calls only.

BankrBot/skills · 87 tokens

lonestaroracle-data

Live pay-per-call data for crypto and DeFi protocol risk, funding rates, open interest, liquidations, stablecoin health, macro, equities, and on-chain intelligence — settled per query in USDC on Base via x402, no signup or API key.

BankrBot/skills · 58 tokens

backtesting-sim

Backtesting and simulation: vectorized backtesting, paper trading simulation, strategy A/B testing, automated strategy building, natural language to strategy, and trading plan generation. USE FOR: backtest, backtesting, paper trading, simulation, strategy builder, A/B test strategies, natural language strategy…

mahmoud20138/Tradecraft · 118 tokens

cross-asset-relationships

Cross-asset and quantitative analysis: pair correlations, correlation heatmaps, currency strength, cross-timeframe divergence, intermarket analysis, market breadth, carry trades, swap rates, risk premia, and multi-pair baskets. USE FOR: correlation, currency strength, intermarket, market breadth, carry trade, swap…

mahmoud20138/Tradecraft · 85 tokens

freqtrade-bot

Freqtrade — open-source Python crypto trading bot. Backtesting, hyperopt (ML parameter optimization), FreqAI (self-training adaptive strategies), Telegram + WebUI control. Supports Binance, Kraken, Bybit, OKX, Gate.io (spot + futures). SQLite trade h.

mahmoud20138/Tradecraft · 61 tokens