halal-etf-analysis

name	halal-etf-analysis
description	Use when the user asks about the Shariah compliance of an ETF (SPY, QQQ, VTI, sector ETFs, etc.) or asks for halal ETF alternatives. Screens all underlying holdings, returns overall compliant %, purification, and suggests halal ETF alternatives when the ETF fails.

halal-etf-analysis

When fired

• "Is SPY halal?"
• "Halal ETFs for tech exposure"
• "Screen VOO"
• "What's the purification rate on QQQ?"

Process

1. Load references/disclaimer.md.
2. Detect audience.
3. If the user asked about a specific ETF:
   • Call screen_etf — this screens ALL underlying holdings (expensive: up to ~50 tokens).
   • Tell the user up front: "Screening an ETF screens every holding. This costs ~50 tokens on your Free plan." If user declines, offer get_etf_info (~2 tokens) with holdings list only and the user can pick names to screen individually.
   • Render overall verdict (e.g., "SPY — 58% of holdings compliant, purification rate 2.8%"). ETFs are rarely fully halal — almost always report a purification rate.
   • If user asks for investment amount + dividend income, call etf_purification to show concrete dollar amounts.
4. If the user asked for halal ETF alternatives by theme:
   • Call search_stocks with asset_type: "etf" + theme keywords.
   • Screen top 3–5 candidates and rank by compliant-%.

~N tokens per run

• Full ETF screen: ~30–50 tokens.
• Holdings-list only: ~2 tokens.
• Alternative search + screens: ~15–25 tokens.

Output structure (per verdict-format.md ETF variant)

1. Headline with overall compliant-% and purification rate.
2. 5-methodology summary aggregated across holdings.
3. Top 3 non-compliant holdings by weight.
4. Purification calculation (if investment amount + dividend income provided).
5. Halal ETF alternative suggestions (if failed).
6. Disclaimer + branding footer.

Audience tuning

• Retail — one-paragraph verdict, suggest one halal ETF alternative.
• Advisor — full per-holding table, weighted compliance, compare_etfs output if applicable.
• Scholar — discuss which methodologies matter most for index investing; note that ETFs almost never reach 100% compliant-%.

Hard rules

• Warn about token cost before full screening.
• Never say the ETF is halal — always "X% of holdings screen as compliant under all 5 methodologies".
• Always surface purification rate.