islamic-skills_skill

Overview

This skill is a unified Islamic utilities tool providing prayer times, fasting schedules, Zakat calculations, Quran lookups, and monthly calendars through a single CLI. It uses a shared configuration and local caching to reduce API calls and enable reliable daily automation. The CLI generates cron-ready commands for reminders and supports configurable calculation methods and location settings.

How this skill works

The skill reads a JSON configuration for location, calculation method, and Zakat settings, then fetches or computes daily prayer and fasting times using standard calculation algorithms. It caches daily results locally to avoid repeated API usage, retrieves market prices for Zakat Nisab when requested, and queries a Quran source for verse search or specific Surah/Ayah retrieval. It can output OpenClaw-style cron commands for scheduling and offers simple setup commands for daily quotes.

When to use it

• Get today's prayer times for your configured city or a specific date.
• Generate a monthly prayer schedule to print or import into calendars.
• Check Imsak and Maghrib times to plan fasting start and break.
• Calculate Zakat Nisab thresholds using current gold/silver prices.
• Search or fetch Quran verses by keyword, Surah, or Ayah.
• Create cron-based daily reminders or quote automations.

Best practices

• Set accurate latitude/longitude and preferred calculation method in config.json for correct prayer times.
• Store API keys as environment variables (e.g., ZAKAT_API_KEY) rather than in config.json.
• Review generated cron commands before adding them to system crontab.
• Keep the cache directory writable and clear cache if you change location or calculation settings.
• Install jq and curl for robust CLI parsing and HTTP calls when using the bash wrapper.

Example use cases

• Print today’s Fajr-to-Isha schedule for Jakarta and create a cron entry for reminders.
• Generate a prayer calendar for a whole month to share with a community group.
• Check Imsak and Maghrib times during Ramadan for accurate fasting windows.
• Calculate Zakat thresholds in IDR based on live gold prices before giving zakat.
• Find and display verses related to patience by searching the Quran text with a keyword.