portfolio-compliance-audit

Stars7

Forks4

UpdatedMay 10, 2026 at 18:14

Runs a full Shariah portfolio audit across multiple stocks and ETFs. Use for portfolio screening, compliance concentration review, unresolved names, and action-oriented portfolio summaries.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

goww7

goww7/yassir-oss

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Financial Specialists, All OtherBusiness and Financial Operations Occupations·SOC 13-2099

SKILL.md

readonly

name	portfolio-compliance-audit
description	Runs a full Shariah portfolio audit across multiple stocks and ETFs. Use for portfolio screening, compliance concentration review, unresolved names, and action-oriented portfolio summaries.

Portfolio Compliance Audit

Source Order

get_shariah
get_market_data
get_financials
sec_company_facts for follow-up validation on risky holdings
web_search only for missing current catalysts or material events

Workflow

Normalize the holdings list and identify stocks vs ETFs.
Run the portfolio-level Shariah workflow first.
If HalalTerminal quota is blocked, stop the audit there, mark the portfolio as unresolved, and send the user to the HalalTerminal dashboard to check account access before rerunning.
Do not spend tokens on market-data, financials, or news after a quota block unless the user explicitly asked for a provisional fallback view.
Separate holdings into compliant, non-compliant, mixed, abstaining (INSUFFICIENT_DATA), and unresolved buckets — abstain is evidence absence, not a compliance signal.
For each ETF holding, render its v2 disposition and attestation count rather than collapsing to pass/fail.
After the scan, for any COMPLIANT holding with marginal ratios (debt-to-MC > 25% OR cash-and-securities > 20%), call get_compliance_trajectory and get_screening_staleness once and report the drift signal alongside the verdict.
Flag concentration risk when the same weak methodology pattern appears repeatedly.
Call out unresolved and abstaining names as portfolio risk, not as acceptable certainty.
If a holding fails, prepare replacement ideas via get_halal_alternatives but keep them secondary unless the user asked for substitutes.

Output Contract

Portfolio Verdict: concise top-line read
Compliant Holdings
At Risk Holdings
Unresolved Holdings
Purification Notes
Concentration / Construction Risks
Recommended Actions: remove, re-screen, monitor, or replace
If quota-blocked, make the first recommendation check HalalTerminal account access, then rerun the audit

More from this repository

same repository

zakat-calculation

goww7/yassir-oss

Calculate zakat owed on a stock/ETF portfolio (the obligatory ~2.5% alms) from market values against the nisab threshold. Use for "calculate my zakat", "how much zakat do I owe on my holdings", or zakat on a specific set of positions.

2026-06-027

sukuk-screening

goww7/yassir-oss

Search, look up, and assess sukuk (Islamic fixed income / "halal bonds") by issuer, country, structure, currency, ISIN, or issuer LEI. Use for sukuk discovery, building a sukuk shortlist, or checking a single sukuk instrument's structure and compliance basis.

2026-06-027

halal-replacement-ideas

goww7/yassir-oss

Suggests halal-compliant replacements for a failing holding, theme, or benchmark exposure. Use when the user wants alternatives, substitutions, or fresh Shariah-compliant ideas.

2026-05-107

single-asset-shariah-review

goww7/yassir-oss

Reviews one stock or ETF for Shariah compliance, methodology differences, purification implications, and investability. Use when the user asks if a ticker is halal, wants a compliance verdict, or needs a decision-ready memo on one asset.

2026-05-107

watchlist-monitoring

goww7/yassir-oss

Monitors a watchlist, portfolio, or symbol set for Shariah compliance drift via trajectory + staleness insights, then surfaces filings, earnings, and material events. Use when the user asks what changed, what to monitor, which names need re-screening, or runs /monitor.

2026-05-107

dcf-valuation

goww7/yassir-oss

Performs discounted cash flow (DCF) valuation analysis to estimate intrinsic value per share. Triggers when user asks for fair value, intrinsic value, DCF, valuation, "what is X worth", price target, undervalued/overvalued analysis, or wants to compare current price to fundamental value.

2026-04-267

name	portfolio-compliance-audit
description	Runs a full Shariah portfolio audit across multiple stocks and ETFs. Use for portfolio screening, compliance concentration review, unresolved names, and action-oriented portfolio summaries.

Portfolio Compliance Audit

Source Order

get_shariah
get_market_data
get_financials
sec_company_facts for follow-up validation on risky holdings
web_search only for missing current catalysts or material events

Workflow

Normalize the holdings list and identify stocks vs ETFs.
Run the portfolio-level Shariah workflow first.
If HalalTerminal quota is blocked, stop the audit there, mark the portfolio as unresolved, and send the user to the HalalTerminal dashboard to check account access before rerunning.
Do not spend tokens on market-data, financials, or news after a quota block unless the user explicitly asked for a provisional fallback view.
Separate holdings into compliant, non-compliant, mixed, abstaining (INSUFFICIENT_DATA), and unresolved buckets — abstain is evidence absence, not a compliance signal.
For each ETF holding, render its v2 disposition and attestation count rather than collapsing to pass/fail.
After the scan, for any COMPLIANT holding with marginal ratios (debt-to-MC > 25% OR cash-and-securities > 20%), call get_compliance_trajectory and get_screening_staleness once and report the drift signal alongside the verdict.
Flag concentration risk when the same weak methodology pattern appears repeatedly.
Call out unresolved and abstaining names as portfolio risk, not as acceptable certainty.
If a holding fails, prepare replacement ideas via get_halal_alternatives but keep them secondary unless the user asked for substitutes.

Output Contract

Portfolio Verdict: concise top-line read
Compliant Holdings
At Risk Holdings
Unresolved Holdings
Purification Notes
Concentration / Construction Risks
Recommended Actions: remove, re-screen, monitor, or replace
If quota-blocked, make the first recommendation check HalalTerminal account access, then rerun the audit