skill
halalterminal-claude-skills
Claude Code plugin — Shariah-compliant stock screening, halal portfolio builder with DCA, ETF analysis (5 methodologies: AAOIFI/DJIM/FTSE/MSCI/S&P), zakat calculator, and methodology education. Powere
Set up
Skills are installed by placing their folder where your agent loads skills.
The download comes from github.com/goww7/halalterminal-claude-skills itself, not from our server, so what you get is exactly what its author published.
Install instructions come from the README
README
synced Oct 17, 2026halalterminal-claude-skills
Shariah-compliant investing capabilities for Claude Code, powered by Halal Terminal.
Screen stocks across five methodologies (AAOIFI, DJIM, FTSE, MSCI, S&P). Audit your portfolio. Build halal baskets with DCA schedules. Calculate zakat and dividend purification. All inside Claude Code.
What you get
9 skills, 2 slash commands, 1 portfolio-builder subagent:
| Skill | Ask for it with |
|---|---|
halal-verdict | "Is AAPL halal?" |
halal-portfolio-audit | "Audit my portfolio: AAPL 30%, MSFT 20%, ..." |
halal-portfolio-builder | "Build me a halal growth portfolio: $10k + $3k/month, 18-month horizon." |
halal-etf-analysis | "Is SPY halal?" |
halal-zakat | "Calculate zakat on my holdings." |
halal-methodologies | "Difference between AAOIFI and MSCI?" |
halal-news-watch | "Any news affecting my holdings' compliance?" |
halal-watchlist | "Add TSLA to my halal watchlist." |
using-halal-investing | Umbrella — routes to the right sub-skill. |
Plus /halal-setup (one-time API key capture) and /halal-doctor (diagnostics).
Install
/plugin install halalterminal-claude-skills
/halal-setup
/halal-setup walks you through:
- Getting a free API key at https://api.halalterminal.com (email → key in your inbox, no credit card).
- Pasting the key; it's written to
~/.claude/settings.jsonunder thehalalterminalMCP server's env block. - Validating connectivity via
/halal-doctor.
Plans and quotas
The Halal Terminal API is token-metered.
| Plan | Monthly tokens | Price | Note |
|---|---|---|---|
| Free | 500 | $0 | ~100 full screenings |
| Starter | 2,500 | $19 | for individual investors |
| Pro | 15,000 | $49 | webhooks, bulk priority |
| Enterprise | Unlimited | $199+ | custom methodologies, SLA |
Sign up: https://api.halalterminal.com
What this plugin is NOT
- Not a fatwa. Every verdict is a methodology-based screening. Consult a qualified scholar for personal rulings.
- Not a trading platform. No broker integrations, no order execution.
- Not a real-time alert system. Request-response only in v1 (webhooks coming in v2 for Pro+ users).
- Not a multi-language tool. English only in v1.
Architecture
- Skills live in
skills/<name>/SKILL.md. - Shared prompt fragments (disclaimer, methodology table, audience-rendering, verdict-format) live in
references/. - MCP server (Halal Terminal's Python SSE server) is bridged to stdio by
scripts/halalterminal-mcp.mjs. - Portfolio builder dispatches to a subagent defined in
agents/halal-portfolio-builder-agent.mdto keep ~40+ MCP calls out of your main session context.
Development
git clone https://github.com/goww7/halalterminal-claude-skills
cd halalterminal-claude-skills
npm install
npm run evals # eval harness scaffolded; per-skill evals deferred to v1.1
See CONTRIBUTING.md.
Learn more
- Research library
- API reference
- What is Islamic finance?
- Shariah-compliant ETFs compared (2026)
- Is my stock halal? Screener
Part of the Halal Terminal ecosystem
Website · API · Python SDK · JS SDK · MCP server · Discord bot · TradingView indicator · Portfolio tracker
Related projects
Other open-source tools in the Halal Terminal ecosystem — same API, different surfaces:
| Project | What it is | License |
|---|---|---|
| halalterminal-mcp | The MCP server this plugin wraps — usable from any MCP-compatible client (Cursor, Cline, Codex, etc.). | Apache-2.0 |
| yassir-oss | Open-source ReAct agent for financial research and Shariah-compliant investing — CLI + web UI, supports OpenAI / Anthropic / local LLMs. | Apache-2.0 |
| halal-discord-bot | Discord bot — /halal AAPL, /portfolio, /trending slash commands. | MIT |
| halal-portfolio-tracker | Next.js 14 app — enter holdings, get per-stock compliance + portfolio halal % + purification owed. One-click Vercel deploy. | MIT |
| halal-pine | TradingView Pine Script v5 indicator that overlays compliance status on charts. Refreshed daily from the API. | MIT |
License
Apache-2.0 — see LICENSE.
"Halal Terminal", "HalalTerminal", and the Halal Terminal logo are reserved trademarks — see TRADEMARKS.md.
Legal
- Legal & Disclaimer — educational-research framing, investment disclaimer, Shariah compliance notice, liability limits, jurisdiction notices
- Privacy Policy
- Cookie Policy
Support
- Contact: yassir@halalterminal.com
- Dashboard: https://api.halalterminal.com/dashboard
- API docs: https://api.halalterminal.com/docs (Swagger) · https://api.halalterminal.com/redoc (ReDoc)
Powered by Halal Terminal — https://halalterminal.com
Part of the Halal Terminal open ecosystem: API · MCP server · Python SDK · JS SDK · Datasets · Awesome Islamic Finance