A comprehensive CLI utility for managing prayer schedules, fasting, Quranic research, and Zakat calculations with local caching.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install islamic-skills
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install islamic-skills using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Islamic Companion?
The Islamic Companion is a high-performance, unified toolset designed to integrate spiritual life into a developer's environment or an AI agent's workflow. By utilizing Openclaw Skills, this tool consolidates several essential Islamic utilities—including precise prayer time calculations, fasting schedules (Imsak/Maghrib), and Quranic verse retrieval—into a single, streamlined CLI interface.
Designed with efficiency in mind, the skill features a robust caching mechanism to minimize API calls and ensure rapid response times. It supports various calculation methods and schools of thought, making it a versatile global companion for users who want to maintain their worship schedule while working within terminal-based environments.
Islamic Companion Use Cases
- Automating daily prayer notifications and reminders through system cron jobs.
- Calculating Zakat Nisab thresholds dynamically based on current gold and silver market prices.
- Performing keyword-based searches across the Quran for research or study.
- Generating localized monthly prayer calendars for any city worldwide.
- Retrieving random Islamic quotes for daily inspiration or terminal startup messages.
How Islamic Companion Works
- The skill reads the user's geographical and preferred calculation settings from a centralized JSON configuration file.
- Upon execution, the CLI wrapper loads the necessary environment variables and verifies dependencies like curl and jq.
- Data is fetched from reliable APIs for real-time information (like prayer times or market prices) and cached locally to enhance performance.
- For automation, the skill generates specific commands that can be integrated into the system's crontab or Openclaw Skills workflows.
- AI agents utilize the provided intent mappings to translate natural language requests into specific CLI commands for immediate execution.
Islamic Companion Setup
To integrate this utility into your Openclaw Skills environment, follow these installation steps:
- Clone the skill repository and navigate to the directory.
- Install the required Python dependencies:
pip install -r requirements.txt
- Ensure curl is installed on your system. It is highly recommended to install jq for faster JSON processing.
- Customize your location and preferences in
skills/islamic-companion/config.jsonto ensure accurate local calculations.
Islamic Companion Data Schema & Taxonomy
The skill utilizes a structured configuration and caching system to organize its operations. The metadata and configuration are categorized as follows:
| Component | Description | Format |
|---|---|---|
| Location Metadata | Latitude, longitude, and city name for precise timing | JSON Object |
| Calculation Method | Method index (e.g., Kemenag RI) and School (e.g., Hanafi) | Integer/Enum |
| Zakat Settings | Currency, gold gram thresholds, and API keys | Object |
| Quran Config | Preferred translation language and search parameters | String |
Daily results are stored in a local cache to ensure high availability and offline access to the current day's schedule.
Islamic Companion Advanced Features
- Support for multiple calculation methods (e.g., Method 20 for Indonesia) and various legal schools of thought.
- Automated cron command generation for seamless integration with system-level schedulers.
- Deep-link Quranic retrieval by Surah and Ayah numbers for precise referencing.
- Live Zakat Nisab calculations that adapt to market fluctuations using external API integration.
- Optimized bash wrappers for minimal overhead when used within high-frequency automation pipelines.
SKILL.md
Loading
Related Openclaw Skills
Research Paper Knowledge Base
A persistent, cross-session knowledge base tool that extracts structured intelligence from academic papers and saves them directly to your workspace.
Feishu Notes Bot
A sophisticated AI agent skill to create and synchronize structured meeting notes and action items directly through Feishu interactive messages.
Nimble Web Tools
A high-performance web intelligence toolset that provides AI agents with real-time search, extraction, and crawling capabilities in LLM-friendly formats.
Nimble Web Search
A real-time web intelligence tool for AI agents featuring 8 specialized focus modes and AI-powered result synthesis.
Mee6 Discord Bot Controller
A specialized skill enabling AI agents to control the Mee6 Discord bot for leveling, moderation, and plugin management.
Calendar Reminder
A proactive scheduling assistant that bridges Outlook calendars with Lark notifications for intelligent daily reminders using Openclaw Skills.
Featured*
