islamic-companion

name	islamic-companion
description	Unified Islamic utilities for prayer times, fasting schedules, and Zakat calculations using a shared configuration.

Islamic Companion Skill

Unified tool for prayer times, fasting schedules, and Zakat calculations.

This skill consolidates Islamic utilities into a single CLI with shared configuration and efficient caching.

Features

• Prayer Times: Retrieve daily prayer times (Fajr, Dhuhr, Asr, Maghrib, Isha).
• Fasting: Check Imsak and Maghrib times for fasting.
• Zakat: Calculate Nisab thresholds for Gold and Silver based on current market prices.
• Quran: Search for verses by keyword or fetch specific Surah/Ayah with translation.
• Calendar: Generate a monthly prayer schedule for any city.
• Quotes: Fetch and display random Islamic quotes or setup daily automation.
• Scheduler: Generate OpenClaw cron commands to schedule daily prayer reminders.
• Caching: Minimizes API calls by caching daily results locally.

Usage

Run the CLI using the bash script:

# Get today's prayer times
./bin/islamic-companion prayer --today

# Setup daily quote automation
./bin/islamic-companion quotes --setup

# Get a random quote
./bin/islamic-companion quotes --random

# Get monthly calendar (Example: Serang, Banten)
./bin/islamic-companion calendar --city "Serang" --month 2 --year 2026

# Sync prayer schedule to cron (generates commands)
./bin/islamic-companion prayer --sync


./bin/islamic-companion fasting --today


./bin/islamic-companion zakat --nisab


./bin/islamic-companion quran --search 


./bin/islamic-companion quran --surah 1


./bin/islamic-companion quran --surah 2 --ayah 255