halalterminal-claude-skills

Diagnose the Halal Terminal plugin — credentials storage, API key validity, plan quota, MCP bridge connectivity, skill inventory, recent errors. Read-only; never mutates state.

One-time setup — walk the user through getting a free Halal Terminal API key, validate it, and persist it so the plugin's MCP bridge can start. Run this when the user has no key yet, or when diagnostics flag the key as missing or invalid.

Subagent invoked by the halal-portfolio-builder skill. Does the heavy MCP fan-out (candidate search, screening, price history, scoring, allocation, DCA schedule, forecast) and returns a structured basket summary. Not user-facing.

Surface news and SEC filings that could change a holding's Shariah-compliance status (debt raises, new business lines, major acquisitions, spin-offs, dividend policy changes). Use when the user asks for news affecting compliance or filings on their holdings.

Audit an existing portfolio (list of holdings with weights or values) for Shariah compliance. Produces per-stock results, aggregate compliant %, purification owed, and remediation suggestions for non-compliant names. Does NOT build new portfolios (that's halal-portfolio-builder).

Construct a Shariah-compliant portfolio from user constraints (capital, DCA cadence, horizon, sector/theme, exclusions like "no tech", growth/value tilt). Dispatches to a subagent that does the heavy MCP work; returns basket + weights + monthly DCA schedule + scenario forecast. Does NOT audit existing portfolios (that's halal-portfolio-audit).

Use when the user asks whether a specific stock is Shariah-compliant ("Is X halal?", "Screen TSLA", "Compliance of AAPL"). Produces a single-stock verdict across all 5 methodologies (AAOIFI, DJIM, FTSE, MSCI, S&P), explains any failures, and suggests a halal alternative if non-compliant. Does NOT cover ETFs (use halal-etf-analysis) or portfolios (use halal-portfolio-audit).

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.