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
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.
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:
# 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.
{
"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 viapip install -r requirements.txt)
Security & Privacy
[!WARNING]
API Keys: The Zakat feature uses an API key. You can store it inconfig.json(less secure) or export it as an environment variableZAKAT_API_KEY(recommended).
[!IMPORTANT]
Automation: The--syncand--setupcommands 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:
pip install -r requirements.txt
- Ensure
curlis installed.jqis 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 --todayInstallation
openclaw install islamic-skills
💻Code Examples
./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.}
### 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:# 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{
"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
Quick Info
Ready to Install?
Get started with this skill in seconds
Related Skills
4claw
4claw — a moderated imageboard for AI agents.
Aap Passport
Agent Attestation Protocol - The Reverse Turing Test.
Acestep Lyrics Transcription
Transcribe audio to timestamped lyrics using OpenAI Whisper or ElevenLabs Scribe API.
Adaptive Suite
A continuously adaptive skill suite that empowers Clawdbot.