✓ Verified 💻 Development ✓ Enhanced Data

Islamic Skills

Unified Islamic utilities for prayer times, fasting schedules, and Zakat calculations using a shared

Rating
4 (470 reviews)
Downloads
1,137 downloads
Version
1.0.0

Overview

Unified Islamic utilities for prayer times, fasting schedules, and Zakat calculations using a shared configuration.

Key Features

1

Prayer Times: Retrieve daily prayer times (Fajr, Dhuhr, Asr, Maghrib, Isha).

2

Fasting: Check Imsak and Maghrib times for fasting.

3

Zakat: Calculate Nisab thresholds for Gold and Silver based on current market prices.

4

Quran: Search for verses by keyword or fetch specific Surah/Ayah with translation.

5

Calendar: Generate a monthly prayer schedule for any city.

6

Quotes: Fetch and display random Islamic quotes or setup daily automation.

7

Scheduler: Generate OpenClaw cron commands to schedule daily prayer reminders.

8

Caching: Minimizes API calls by caching daily results locally.

Complete Documentation

View Source →

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:

bash
# 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

# Check fasting times (Imsak/Maghrib)
./bin/islamic-companion fasting --today

# Check Zakat Nisab values
./bin/islamic-companion zakat --nisab

# Search Quran for keyword
./bin/islamic-companion quran --search "sabar"

# Get specific Surah (e.g., Al-Fatihah)
./bin/islamic-companion quran --surah 1

# Get specific Ayah (e.g., Al-Baqarah:255)
./bin/islamic-companion quran --surah 2 --ayah 255

Configuration

Edit skills/islamic-companion/config.json to set your location and calculation method. Note: config.bash is auto-generated from config.json for performance.

json
{
  "location": {
    "latitude": -6.2088,
    "longitude": 106.8456,
    "name": "Jakarta"
  },
  "calculation": {
    "method": 20,
    "school": 0
  },
  "zakat": {
    "currency": "IDR",
    "gold_gram_threshold": 85,
    "api_key": ""
  },
  "quran_language": "id"
}

Calculation Methods

  • Method 20: Kemenag RI (Indonesia)
  • School 0: Standard (Shafi, Maliki, Hanbali)
  • School 1: Hanafi

Intent Mappings (for Agent)

| User Intent | Command Executed | | :--- | :--- | | "Get prayer times" | ./bin/islamic-companion prayer --today | | "Show me the calendar for [City]" | ./bin/islamic-companion calendar --city [City] | | "Setup daily Islamic quotes" | ./bin/islamic-companion quotes --setup | | "Give me a random Islamic quote" | ./bin/islamic-companion quotes --random | | "Sync prayer schedule" | ./bin/islamic-companion prayer --sync | | "When is Imsak?" | ./bin/islamic-companion fasting --today | | "Check Zakat Nisab" | ./bin/islamic-companion zakat --nisab | | "Search Quran for [keyword]" | ./bin/islamic-companion quran --search "[keyword]" | | "Read Surah [Name/Number]" | ./bin/islamic-companion quran --surah [Number] | | "Read Surah [Number] Ayah [Number]" | ./bin/islamic-companion quran --surah [Number] --ayah [Number] |

Dependencies

  • System: bash, curl, jq (highly recommended)
  • Python (Optional for some features): python3, requests (Install via pip install -r requirements.txt)

Security & Privacy

[!WARNING]
API Keys: The Zakat feature uses an API key. You can store it in config.json (less secure) or export it as an environment variable ZAKAT_API_KEY (recommended).

[!IMPORTANT]
Automation: The --sync and --setup commands generate cron schedules. Always review the output before adding it to your system crontab.

Installation

  • Clone the repository or download the skill.
  • Install Python dependencies:
bash
pip install -r requirements.txt
  • Ensure curl is installed. jq is recommended for JSON parsing speed and reliability.

Usage

Run the CLI using the bash script wrapper, which handles configuration loading and environment setup:

```bash

Get today's prayer times (uses HTTPS)

./bin/islamic-companion prayer --today

Installation

Terminal bash

openclaw install islamic-skills
    
Copied!

💻Code Examples

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

binislamic-companion-quran---surah-2---ayah-255.txt
## Configuration

Edit `skills/islamic-companion/config.json` to set your location and calculation method.
Note: `config.bash` is auto-generated from `config.json` for performance.

}

.txt
### Calculation Methods
- **Method 20:** Kemenag RI (Indonesia)
- **School 0:** Standard (Shafi, Maliki, Hanbali)
- **School 1:** Hanafi

## Intent Mappings (for Agent)

| User Intent | Command Executed |
| :--- | :--- |
| "Get prayer times" | `./bin/islamic-companion prayer --today` |
| "Show me the calendar for [City]" | `./bin/islamic-companion calendar --city [City]` |
| "Setup daily Islamic quotes" | `./bin/islamic-companion quotes --setup` |
| "Give me a random Islamic quote" | `./bin/islamic-companion quotes --random` |
| "Sync prayer schedule" | `./bin/islamic-companion prayer --sync` |
| "When is Imsak?" | `./bin/islamic-companion fasting --today` |
| "Check Zakat Nisab" | `./bin/islamic-companion zakat --nisab` |
| "Search Quran for [keyword]" | `./bin/islamic-companion quran --search "[keyword]"` |
| "Read Surah [Name/Number]" | `./bin/islamic-companion quran --surah [Number]` |
| "Read Surah [Number] Ayah [Number]" | `./bin/islamic-companion quran --surah [Number] --ayah [Number]` |

## Dependencies

- **System:** `bash`, `curl`, `jq` (highly recommended)
- **Python (Optional for some features):** `python3`, `requests` (Install via `pip install -r requirements.txt`)

## Security & Privacy

> [!WARNING]
> **API Keys**: The Zakat feature uses an API key. You can store it in `config.json` (less secure) or export it as an environment variable `ZAKAT_API_KEY` (recommended).

> [!IMPORTANT]
> **Automation**: The `--sync` and `--setup` commands generate cron schedules. Always review the output before adding it to your system crontab.

## Installation

1. Clone the repository or download the skill.
2. Install Python dependencies:
example.sh
# 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

# Check fasting times (Imsak/Maghrib)
./bin/islamic-companion fasting --today

# Check Zakat Nisab values
./bin/islamic-companion zakat --nisab

# Search Quran for keyword
./bin/islamic-companion quran --search "sabar"

# Get specific Surah (e.g., Al-Fatihah)
./bin/islamic-companion quran --surah 1

# Get specific Ayah (e.g., Al-Baqarah:255)
./bin/islamic-companion quran --surah 2 --ayah 255
example.json
{
  "location": {
    "latitude": -6.2088,
    "longitude": 106.8456,
    "name": "Jakarta"
  },
  "calculation": {
    "method": 20,
    "school": 0
  },
  "zakat": {
    "currency": "IDR",
    "gold_gram_threshold": 85,
    "api_key": ""
  },
  "quran_language": "id"
}

Tags

#calendar_and-scheduling

Quick Info

Category Development
Model Claude 3.5
Complexity One-Click
Author ilmimris
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install islamic-skills