{"id":"7aad0102-a14a-42bd-bb9e-6da7dc24fa43","entityType":"agent","slug":"clawhub-ilmimris-islamic-skills","name":"Islamic Companion","canonicalUrl":"https://www.xpersona.co/agent/clawhub-ilmimris-islamic-skills","canonicalPath":"/agent/clawhub-ilmimris-islamic-skills","generatedAt":"2026-10-11T20:59:05.029Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T16:28:54.649Z","emptyReason":null},"description":"Unified Islamic utilities for prayer times, fasting schedules, and Zakat calculations using a shared configuration. Skill: Islamic Companion Owner: ilmimris Summary: Unified Islamic utilities for prayer times, fasting schedules, and Zakat calculations using a shared configuration. Tags: latest:2.0.1 Version history: v2.0.1 | 2026-02-17T08:24:27.088Z | auto - Added Python dependency support; now requires python3 and requests for some features. - Updated documentation to include installation and security instructions for API keys. -","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s17518c1jsnwyzb7wa3cpwz2qx87cjas:islamic-skills","sourceUrl":"https://clawhub.ai/ilmimris/islamic-skills","homepage":"https://clawhub.ai/ilmimris/skills/islamic-skills","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/ilmimris/islamic-skills","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/ilmimris/skills/islamic-skills","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Unified Islamic utilities for prayer times, fasting schedules, and Zakat calculations using a shared configuration. Skill: Islamic Companion Owner: ilmimris Sum"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T16:28:54.649Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T16:28:54.649Z","emptyReason":null},"stars":null,"forks":null,"downloads":1028,"packageName":null,"latestVersion":"2.0.1","tractionLabel":"1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T16:28:54.637Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T16:28:54.649Z","lastCrawledAt":"2026-10-11T16:28:54.637Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T16:28:54.637Z","lastVerifiedAt":null,"highlights":[{"version":"2.0.1","createdAt":"2026-02-17T08:24:27.088Z","changelog":"- Added Python dependency support; now requires `python3` and `requests` for some features. - Updated documentation to include installation and security instructions for API keys. - Improved environment and configuration loading in the CLI runner. - Enhanced cron job and automation instructions for scheduling features. - Minor dependency clarifications and formatting fixes in SKILL.md.","fileCount":30,"zipByteSize":28016},{"version":"2.0.0","createdAt":"2026-02-17T08:05:57.475Z","changelog":"Major update: Migrated to a Bash script-based implementation with modular structure. - Replaced Python CLI with a Bash script (`bin/islamic-companion`) for all commands. - Added modular shell scripts for API, data processing, and features (prayer, fasting, zakat, Quran, calendar, quotes, scheduler). - Updated configuration process: auto-generates `config.bash` from `config.json` for optimized CLI performance. - Now requires `bash`, `curl`, and `jq` (with limited fallback if `jq` unavailable). - Updated documentation and usage examples to reflect new CLI path and configuration changes.","fileCount":30,"zipByteSize":27445},{"version":"0.1.0","createdAt":"2026-02-16T11:45:36.560Z","changelog":"Initial release of Islamic Companion Skill. - Unified CLI tool for prayer times, fasting schedules, Zakat calculations, Quran search, monthly calendars, and Islamic quotes. - Shared configuration for location, calculation method, language, and currency. - Efficient daily result caching to minimize API calls. - Scheduler generates cron commands for prayer reminders. - Includes built-in intent-to-command mappings for easy integration. - Simple setup and usage instructions provided.","fileCount":18,"zipByteSize":13005}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17518c1jsnwyzb7wa3cpwz2qx87cjas:islamic-skills","setupComplexity":"medium","setupSteps":["Python environment detected. Create a strict virtual environment (`python -m venv .venv`) before installing dependencies to prevent system-level package conflicts.","Setup complexity is MEDIUM. Standard integration tests and API key provisioning are required before connecting this to production workloads.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-ilmimris-islamic-skills/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-ilmimris-islamic-skills/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-ilmimris-islamic-skills/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-ilmimris-islamic-skills/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-ilmimris-islamic-skills/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-ilmimris-islamic-skills/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T20:59:05.029Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-ilmimris-islamic-skills/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-ilmimris-islamic-skills/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-ilmimris-islamic-skills/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-ilmimris-islamic-skills/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T16:28:54.649Z","emptyReason":null},"readme":"Skill: Islamic Companion\n\nOwner: ilmimris\n\nSummary: Unified Islamic utilities for prayer times, fasting schedules, and Zakat calculations using a shared configuration.\n\nTags: latest:2.0.1\n\nVersion history:\n\nv2.0.1 | 2026-02-17T08:24:27.088Z | auto\n\n- Added Python dependency support; now requires `python3` and `requests` for some features.\n- Updated documentation to include installation and security instructions for API keys.\n- Improved environment and configuration loading in the CLI runner.\n- Enhanced cron job and automation instructions for scheduling features.\n- Minor dependency clarifications and formatting fixes in SKILL.md.\n\nv2.0.0 | 2026-02-17T08:05:57.475Z | auto\n\nMajor update: Migrated to a Bash script-based implementation with modular structure.\n\n- Replaced Python CLI with a Bash script (`bin/islamic-companion`) for all commands.\n- Added modular shell scripts for API, data processing, and features (prayer, fasting, zakat, Quran, calendar, quotes, scheduler).\n- Updated configuration process: auto-generates `config.bash` from `config.json` for optimized CLI performance.\n- Now requires `bash`, `curl`, and `jq` (with limited fallback if `jq` unavailable).\n- Updated documentation and usage examples to reflect new CLI path and configuration changes.\n\nv0.1.0 | 2026-02-16T11:45:36.560Z | auto\n\nInitial release of Islamic Companion Skill.\n\n- Unified CLI tool for prayer times, fasting schedules, Zakat calculations, Quran search, monthly calendars, and Islamic quotes.\n- Shared configuration for location, calculation method, language, and currency.\n- Efficient daily result caching to minimize API calls.\n- Scheduler generates cron commands for prayer reminders.\n- Includes built-in intent-to-command mappings for easy integration.\n- Simple setup and usage instructions provided.\n\nArchive index:\n\nArchive v2.0.1: 30 files, 28016 bytes\n\nFiles: config.example.json (272b), lib/api.sh (2199b), lib/cache.sh (1048b), lib/calendar.sh (3565b), lib/config.sh (2647b), lib/fasting.sh (989b), lib/format.sh (587b), lib/json.sh (6386b), lib/prayer.sh (2260b), lib/quotes.sh (2764b), lib/quran.sh (9008b), lib/scheduler.sh (2101b), lib/zakat.sh (2601b), README.md (2432b), requirements.txt (9b), SKILL.md (4355b), src/__init__.py (0b), src/api.py (3914b), src/fasting.py (852b), src/islamic_calendar.py (1594b), src/main.py (4581b), src/prayer.py (554b), src/quotes.py (1129b), src/quran_api.py (3348b), src/quran_formatter.py (1678b), src/quran_retrieval.py (485b), src/quran_search.py (926b), src/scheduler.py (1884b), src/zakat.py (1078b), _meta.json (133b)\n\nFile v2.0.1:SKILL.md\n\n---\nname: islamic-companion\ndescription: Unified Islamic utilities for prayer times, fasting schedules, and Zakat calculations using a shared configuration.\n---\n\n# Islamic Companion Skill\n\n**Unified tool for prayer times, fasting schedules, and Zakat calculations.**\n\nThis skill consolidates Islamic utilities into a single CLI with shared configuration and efficient caching.\n\n## Features\n\n- **Prayer Times:** Retrieve daily prayer times (Fajr, Dhuhr, Asr, Maghrib, Isha).\n- **Fasting:** Check Imsak and Maghrib times for fasting.\n- **Zakat:** Calculate Nisab thresholds for Gold and Silver based on current market prices.\n- **Quran:** Search for verses by keyword or fetch specific Surah/Ayah with translation.\n- **Calendar:** Generate a monthly prayer schedule for any city.\n- **Quotes:** Fetch and display random Islamic quotes or setup daily automation.\n- **Scheduler:** Generate OpenClaw cron commands to schedule daily prayer reminders.\n- **Caching:** Minimizes API calls by caching daily results locally.\n\n## Usage\n\nRun the CLI using the bash script:\n\n```bash\n# Get today's prayer times\n./bin/islamic-companion prayer --today\n\n# Setup daily quote automation\n./bin/islamic-companion quotes --setup\n\n# Get a random quote\n./bin/islamic-companion quotes --random\n\n# Get monthly calendar (Example: Serang, Banten)\n./bin/islamic-companion calendar --city \"Serang\" --month 2 --year 2026\n\n# Sync prayer schedule to cron (generates commands)\n./bin/islamic-companion prayer --sync\n\n# Check fasting times (Imsak/Maghrib)\n./bin/islamic-companion fasting --today\n\n# Check Zakat Nisab values\n./bin/islamic-companion zakat --nisab\n\n# Search Quran for keyword\n./bin/islamic-companion quran --search \"sabar\"\n\n# Get specific Surah (e.g., Al-Fatihah)\n./bin/islamic-companion quran --surah 1\n\n# Get specific Ayah (e.g., Al-Baqarah:255)\n./bin/islamic-companion quran --surah 2 --ayah 255\n```\n\n## Configuration\n\nEdit `skills/islamic-companion/config.json` to set your location and calculation method.\nNote: `config.bash` is auto-generated from `config.json` for performance.\n\n```json\n{\n  \"location\": {\n    \"latitude\": -6.2088,\n    \"longitude\": 106.8456,\n    \"name\": \"Jakarta\"\n  },\n  \"calculation\": {\n    \"method\": 20,\n    \"school\": 0\n  },\n  \"zakat\": {\n    \"currency\": \"IDR\",\n    \"gold_gram_threshold\": 85,\n    \"api_key\": \"\"\n  },\n  \"quran_language\": \"id\"\n}\n```\n\n### Calculation Methods\n- **Method 20:** Kemenag RI (Indonesia)\n- **School 0:** Standard (Shafi, Maliki, Hanbali)\n- **School 1:** Hanafi\n\n## Intent Mappings (for Agent)\n\n| User Intent | Command Executed |\n| :--- | :--- |\n| \"Get prayer times\" | `./bin/islamic-companion prayer --today` |\n| \"Show me the calendar for [City]\" | `./bin/islamic-companion calendar --city [City]` |\n| \"Setup daily Islamic quotes\" | `./bin/islamic-companion quotes --setup` |\n| \"Give me a random Islamic quote\" | `./bin/islamic-companion quotes --random` |\n| \"Sync prayer schedule\" | `./bin/islamic-companion prayer --sync` |\n| \"When is Imsak?\" | `./bin/islamic-companion fasting --today` |\n| \"Check Zakat Nisab\" | `./bin/islamic-companion zakat --nisab` |\n| \"Search Quran for [keyword]\" | `./bin/islamic-companion quran --search \"[keyword]\"` |\n| \"Read Surah [Name/Number]\" | `./bin/islamic-companion quran --surah [Number]` |\n| \"Read Surah [Number] Ayah [Number]\" | `./bin/islamic-companion quran --surah [Number] --ayah [Number]` |\n\n## Dependencies\n\n- **System:** `bash`, `curl`, `jq` (highly recommended)\n- **Python (Optional for some features):** `python3`, `requests` (Install via `pip install -r requirements.txt`)\n\n## Security & Privacy\n\n> [!WARNING]\n> **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).\n\n> [!IMPORTANT]\n> **Automation**: The `--sync` and `--setup` commands generate cron schedules. Always review the output before adding it to your system crontab.\n\n## Installation\n\n1. Clone the repository or download the skill.\n2. Install Python dependencies:\n   ```bash\n   pip install -r requirements.txt\n   ```\n3. Ensure `curl` is installed. `jq` is recommended for JSON parsing speed and reliability.\n\n## Usage\n\nRun the CLI using the bash script wrapper, which handles configuration loading and environment setup:\n\n```bash\n# Get today's prayer times (uses HTTPS)\n./bin/islamic-companion prayer --today\n\nFile v2.0.1:README.md\n\n# Islamic Companion Skill\n\n**Unified tool for prayer times, fasting schedules, and Zakat calculations.**\n\nThis skill consolidates Islamic utilities into a single CLI with shared configuration and efficient caching.\n\n## Features\n\n- **Prayer Times:** Retrieve daily prayer times (Fajr, Dhuhr, Asr, Maghrib, Isha).\n- **Fasting:** Check Imsak and Maghrib times for fasting.\n- **Zakat:** Calculate Nisab thresholds for Gold and Silver based on current market prices.\n- **Quran:** Search for verses by keyword or fetch specific Surah/Ayah with translation.\n- **Calendar:** Generate a monthly prayer schedule for any city.\n- **Quotes:** Fetch and display random Islamic quotes or setup daily automation.\n- **Scheduler:** Generate OpenClaw cron commands to schedule daily prayer reminders.\n- **Caching:** Minimizes API calls by caching daily results locally.\n\n## Usage\n\nRun the CLI using the bash script:\n\n```bash\n# Get today's prayer times\n./bin/islamic-companion prayer --today\n\n# Setup daily quote automation\n./bin/islamic-companion quotes --setup\n\n# Get a random quote\n./bin/islamic-companion quotes --random\n\n# Get monthly calendar (Example: Serang, Banten)\n./bin/islamic-companion calendar --city \"Serang\" --month 2 --year 2026\n\n# Sync prayer schedule to cron (generates commands)\n./bin/islamic-companion prayer --sync\n\n# Check fasting times (Imsak/Maghrib)\n./bin/islamic-companion fasting --today\n\n# Check Zakat Nisab values\n./bin/islamic-companion zakat --nisab\n\n# Search Quran for keyword\n./bin/islamic-companion quran --search \"sabar\"\n\n# Get specific Surah (e.g., Al-Fatihah)\n./bin/islamic-companion quran --surah 1\n\n# Get specific Ayah (e.g., Al-Baqarah:255)\n./bin/islamic-companion quran --surah 2 --ayah 255\n```\n\n## Configuration\n\nEdit `skills/islamic-companion/config.json` to set your location and calculation method.\nNote: `config.bash` is auto-generated from `config.json` for performance.\n\n```json\n{\n  \"location\": {\n    \"latitude\": -6.2088,\n    \"longitude\": 106.8456,\n    \"name\": \"Jakarta\"\n  },\n  \"calculation\": {\n    \"method\": 20,\n    \"school\": 0\n  },\n  \"zakat\": {\n    \"currency\": \"IDR\",\n    \"gold_gram_threshold\": 85,\n    \"api_key\": \"\"\n  },\n  \"quran_language\": \"id\"\n}\n```\n\n### Calculation Methods\n- **Method 20:** Kemenag RI (Indonesia)\n- **School 0:** Standard (Shafi, Maliki, Hanbali)\n- **School 1:** Hanafi\n\n## Dependencies\n\n- `bash`\n- `curl`\n- `jq` (Recommended for best performance, but limited fallback available)\n\nFile v2.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn74fkfjfcc6rn3v3saeywtpdh819efa\",\n  \"slug\": \"islamic-skills\",\n  \"version\": \"2.0.1\",\n  \"publishedAt\": 1771316667088\n}\n\nFile v2.0.1:config.example.json\n\n{\n  \"location\": {\n    \"latitude\": -6.2088,\n    \"longitude\": 106.8456,\n    \"name\": \"Jakarta\"\n  },\n  \"calculation\": {\n    \"method\": 20,\n    \"school\": 0\n  },\n  \"zakat\": {\n    \"currency\": \"IDR\",\n    \"gold_gram_threshold\": 85,\n    \"api_key\": \"\"\n  },\n  \"quran_language\": \"id\"\n}\n\nFile v2.0.1:requirements.txt\n\nrequests\n\nArchive v2.0.0: 30 files, 27445 bytes\n\nFiles: config.example.json (272b), lib/api.sh (2201b), lib/cache.sh (1048b), lib/calendar.sh (3565b), lib/config.sh (2630b), lib/fasting.sh (989b), lib/format.sh (587b), lib/json.sh (6386b), lib/prayer.sh (2259b), lib/quotes.sh (2764b), lib/quran.sh (9008b), lib/scheduler.sh (2019b), lib/zakat.sh (2601b), README.md (2432b), requirements.txt (1b), SKILL.md (3467b), src/__init__.py (0b), src/api.py (3878b), src/fasting.py (852b), src/islamic_calendar.py (1594b), src/main.py (4581b), src/prayer.py (554b), src/quotes.py (1129b), src/quran_api.py (3348b), src/quran_formatter.py (1678b), src/quran_retrieval.py (485b), src/quran_search.py (926b), src/scheduler.py (1687b), src/zakat.py (1078b), _meta.json (133b)\n\nFile v2.0.0:SKILL.md\n\n---\nname: islamic-companion\ndescription: Unified Islamic utilities for prayer times, fasting schedules, and Zakat calculations using a shared configuration.\n---\n\n# Islamic Companion Skill\n\n**Unified tool for prayer times, fasting schedules, and Zakat calculations.**\n\nThis skill consolidates Islamic utilities into a single CLI with shared configuration and efficient caching.\n\n## Features\n\n- **Prayer Times:** Retrieve daily prayer times (Fajr, Dhuhr, Asr, Maghrib, Isha).\n- **Fasting:** Check Imsak and Maghrib times for fasting.\n- **Zakat:** Calculate Nisab thresholds for Gold and Silver based on current market prices.\n- **Quran:** Search for verses by keyword or fetch specific Surah/Ayah with translation.\n- **Calendar:** Generate a monthly prayer schedule for any city.\n- **Quotes:** Fetch and display random Islamic quotes or setup daily automation.\n- **Scheduler:** Generate OpenClaw cron commands to schedule daily prayer reminders.\n- **Caching:** Minimizes API calls by caching daily results locally.\n\n## Usage\n\nRun the CLI using the bash script:\n\n```bash\n# Get today's prayer times\n./bin/islamic-companion prayer --today\n\n# Setup daily quote automation\n./bin/islamic-companion quotes --setup\n\n# Get a random quote\n./bin/islamic-companion quotes --random\n\n# Get monthly calendar (Example: Serang, Banten)\n./bin/islamic-companion calendar --city \"Serang\" --month 2 --year 2026\n\n# Sync prayer schedule to cron (generates commands)\n./bin/islamic-companion prayer --sync\n\n# Check fasting times (Imsak/Maghrib)\n./bin/islamic-companion fasting --today\n\n# Check Zakat Nisab values\n./bin/islamic-companion zakat --nisab\n\n# Search Quran for keyword\n./bin/islamic-companion quran --search \"sabar\"\n\n# Get specific Surah (e.g., Al-Fatihah)\n./bin/islamic-companion quran --surah 1\n\n# Get specific Ayah (e.g., Al-Baqarah:255)\n./bin/islamic-companion quran --surah 2 --ayah 255\n```\n\n## Configuration\n\nEdit `skills/islamic-companion/config.json` to set your location and calculation method.\nNote: `config.bash` is auto-generated from `config.json` for performance.\n\n```json\n{\n  \"location\": {\n    \"latitude\": -6.2088,\n    \"longitude\": 106.8456,\n    \"name\": \"Jakarta\"\n  },\n  \"calculation\": {\n    \"method\": 20,\n    \"school\": 0\n  },\n  \"zakat\": {\n    \"currency\": \"IDR\",\n    \"gold_gram_threshold\": 85,\n    \"api_key\": \"\"\n  },\n  \"quran_language\": \"id\"\n}\n```\n\n### Calculation Methods\n- **Method 20:** Kemenag RI (Indonesia)\n- **School 0:** Standard (Shafi, Maliki, Hanbali)\n- **School 1:** Hanafi\n\n## Intent Mappings (for Agent)\n\n| User Intent | Command Executed |\n| :--- | :--- |\n| \"Get prayer times\" | `./bin/islamic-companion prayer --today` |\n| \"Show me the calendar for [City]\" | `./bin/islamic-companion calendar --city [City]` |\n| \"Setup daily Islamic quotes\" | `./bin/islamic-companion quotes --setup` |\n| \"Give me a random Islamic quote\" | `./bin/islamic-companion quotes --random` |\n| \"Sync prayer schedule\" | `./bin/islamic-companion prayer --sync` |\n| \"When is Imsak?\" | `./bin/islamic-companion fasting --today` |\n| \"Check Zakat Nisab\" | `./bin/islamic-companion zakat --nisab` |\n| \"Search Quran for [keyword]\" | `./bin/islamic-companion quran --search \"[keyword]\"` |\n| \"Read Surah [Name/Number]\" | `./bin/islamic-companion quran --surah [Number]` |\n| \"Read Surah [Number] Ayah [Number]\" | `./bin/islamic-companion quran --surah [Number] --ayah [Number]` |\n\n## Dependencies\n\n- `bash`\n- `curl`\n- `jq` (Recommended for best performance, but limited fallback available)\n\nFile v2.0.0:README.md\n\n# Islamic Companion Skill\n\n**Unified tool for prayer times, fasting schedules, and Zakat calculations.**\n\nThis skill consolidates Islamic utilities into a single CLI with shared configuration and efficient caching.\n\n## Features\n\n- **Prayer Times:** Retrieve daily prayer times (Fajr, Dhuhr, Asr, Maghrib, Isha).\n- **Fasting:** Check Imsak and Maghrib times for fasting.\n- **Zakat:** Calculate Nisab thresholds for Gold and Silver based on current market prices.\n- **Quran:** Search for verses by keyword or fetch specific Surah/Ayah with translation.\n- **Calendar:** Generate a monthly prayer schedule for any city.\n- **Quotes:** Fetch and display random Islamic quotes or setup daily automation.\n- **Scheduler:** Generate OpenClaw cron commands to schedule daily prayer reminders.\n- **Caching:** Minimizes API calls by caching daily results locally.\n\n## Usage\n\nRun the CLI using the bash script:\n\n```bash\n# Get today's prayer times\n./bin/islamic-companion prayer --today\n\n# Setup daily quote automation\n./bin/islamic-companion quotes --setup\n\n# Get a random quote\n./bin/islamic-companion quotes --random\n\n# Get monthly calendar (Example: Serang, Banten)\n./bin/islamic-companion calendar --city \"Serang\" --month 2 --year 2026\n\n# Sync prayer schedule to cron (generates commands)\n./bin/islamic-companion prayer --sync\n\n# Check fasting times (Imsak/Maghrib)\n./bin/islamic-companion fasting --today\n\n# Check Zakat Nisab values\n./bin/islamic-companion zakat --nisab\n\n# Search Quran for keyword\n./bin/islamic-companion quran --search \"sabar\"\n\n# Get specific Surah (e.g., Al-Fatihah)\n./bin/islamic-companion quran --surah 1\n\n# Get specific Ayah (e.g., Al-Baqarah:255)\n./bin/islamic-companion quran --surah 2 --ayah 255\n```\n\n## Configuration\n\nEdit `skills/islamic-companion/config.json` to set your location and calculation method.\nNote: `config.bash` is auto-generated from `config.json` for performance.\n\n```json\n{\n  \"location\": {\n    \"latitude\": -6.2088,\n    \"longitude\": 106.8456,\n    \"name\": \"Jakarta\"\n  },\n  \"calculation\": {\n    \"method\": 20,\n    \"school\": 0\n  },\n  \"zakat\": {\n    \"currency\": \"IDR\",\n    \"gold_gram_threshold\": 85,\n    \"api_key\": \"\"\n  },\n  \"quran_language\": \"id\"\n}\n```\n\n### Calculation Methods\n- **Method 20:** Kemenag RI (Indonesia)\n- **School 0:** Standard (Shafi, Maliki, Hanbali)\n- **School 1:** Hanafi\n\n## Dependencies\n\n- `bash`\n- `curl`\n- `jq` (Recommended for best performance, but limited fallback available)\n\nFile v2.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn74fkfjfcc6rn3v3saeywtpdh819efa\",\n  \"slug\": \"islamic-skills\",\n  \"version\": \"2.0.0\",\n  \"publishedAt\": 1771315557475\n}\n\nFile v2.0.0:config.example.json\n\n{\n  \"location\": {\n    \"latitude\": -6.2088,\n    \"longitude\": 106.8456,\n    \"name\": \"Jakarta\"\n  },\n  \"calculation\": {\n    \"method\": 20,\n    \"school\": 0\n  },\n  \"zakat\": {\n    \"currency\": \"IDR\",\n    \"gold_gram_threshold\": 85,\n    \"api_key\": \"\"\n  },\n  \"quran_language\": \"id\"\n}\n\nArchive v0.1.0: 18 files, 13005 bytes\n\nFiles: config.example.json (272b), README.md (3058b), requirements.txt (17b), SKILL.md (3725b), src/__init__.py (0b), src/api.py (3878b), src/fasting.py (852b), src/islamic_calendar.py (1594b), src/main.py (4581b), src/prayer.py (554b), src/quotes.py (1129b), src/quran_api.py (3348b), src/quran_formatter.py (1678b), src/quran_retrieval.py (485b), src/quran_search.py (926b), src/scheduler.py (1687b), src/zakat.py (1078b), _meta.json (133b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: islamic-companion\ndescription: Unified Islamic utilities for prayer times, fasting schedules, and Zakat calculations using a shared configuration.\n---\n\n# Islamic Companion Skill\n\n**Unified tool for prayer times, fasting schedules, and Zakat calculations.**\n\nThis skill consolidates Islamic utilities into a single CLI with shared configuration and efficient caching.\n\n## Features\n\n- **Prayer Times:** Retrieve daily prayer times (Fajr, Dhuhr, Asr, Maghrib, Isha).\n- **Fasting:** Check Imsak and Maghrib times for fasting.\n- **Zakat:** Calculate Nisab thresholds for Gold and Silver based on current market prices.\n- **Quran:** Search for verses by keyword or fetch specific Surah/Ayah with translation.\n- **Calendar:** Generate a monthly prayer schedule for any city.\n- **Quotes:** Fetch and display random Islamic quotes or setup daily automation.\n- **Scheduler:** Generate OpenClaw cron commands to schedule daily prayer reminders.\n- **Caching:** Minimizes API calls by caching daily results locally.\n\n## Usage\n\nRun the CLI using python:\n\n```bash\n# Get today's prayer times\npython3 -m skills.islamic_companion.src.main prayer --today\n\n# Setup daily quote automation\npython3 -m skills.islamic_companion.src.main quotes --setup\n\n# Get a random quote\npython3 -m skills.islamic_companion.src.main quotes --random\n\n# Get monthly calendar (Example: Serang, Banten)\npython3 -m skills.islamic_companion.src.main calendar --city \"Serang\" --month 2 --year 2026\n\n# Sync prayer schedule to cron (generates commands)\npython3 -m skills.islamic_companion.src.main prayer --sync\n\n# Check fasting times (Imsak/Maghrib)\npython3 -m skills.islamic_companion.src.main fasting --today\n\n# Check Zakat Nisab values\npython3 -m skills.islamic_companion.src.main zakat --nisab\n\n# Search Quran for keyword\npython3 -m skills.islamic_companion.src.main quran --search \"sabar\"\n\n# Get specific Surah (e.g., Al-Fatihah)\npython3 -m skills.islamic_companion.src.main quran --surah 1\n\n# Get specific Ayah (e.g., Al-Baqarah:255)\npython3 -m skills.islamic_companion.src.main quran --surah 2 --ayah 255\n```\n\n## Configuration\n\nEdit `skills/islamic-companion/config.json` to set your location and calculation method.\n\n```json\n{\n  \"location\": {\n    \"latitude\": -6.2088,\n    \"longitude\": 106.8456,\n    \"name\": \"Jakarta\"\n  },\n  \"calculation\": {\n    \"method\": 20,\n    \"school\": 1\n  },\n  \"zakat\": {\n    \"currency\": \"IDR\",\n    \"gold_gram_threshold\": 85,\n    \"api_key\": \"\"\n  },\n  \"quran_language\": \"id\"\n}\n```\n\n### Calculation Methods\n- **Method 20:** Kemenag RI (Indonesia)\n- **School 1:** Standard (Shafi, Maliki, Hanbali)\n- **School 2:** Hanafi\n\n## Intent Mappings (for Agent)\n\n| User Intent | Command Executed |\n| :--- | :--- |\n| \"Get prayer times\" | `python3 -m skills.islamic_companion.src.main prayer --today` |\n| \"Show me the calendar for [City]\" | `python3 -m skills.islamic_companion.src.main calendar --city [City]` |\n| \"Setup daily Islamic quotes\" | `python3 -m skills.islamic_companion.src.main quotes --setup` |\n| \"Give me a random Islamic quote\" | `python3 -m skills.islamic_companion.src.main quotes --random` |\n| \"Sync prayer schedule\" | `python3 -m skills.islamic_companion.src.main prayer --sync` |\n| \"When is Imsak?\" | `python3 -m skills.islamic_companion.src.main fasting --today` |\n| \"Check Zakat Nisab\" | `python3 -m skills.islamic_companion.src.main zakat --nisab` |\n| \"Search Quran for [keyword]\" | `python3 -m skills.islamic_companion.src.main quran --search \"[keyword]\"` |\n| \"Read Surah [Name/Number]\" | `python3 -m skills.islamic_companion.src.main quran --surah [Number]` |\n| \"Read Surah [Number] Ayah [Number]\" | `python3 -m skills.islamic_companion.src.main quran --surah [Number] --ayah [Number]` |\n\n## Dependencies\n\n- `requests`\n\nFile v0.1.0:README.md\n\n# Islamic Companion Skill\n\nA unified Islamic utility suite for OpenClaw agents. Manage prayer times, fasting schedules, and Zakat calculations from a single, cohesive interface.\n\n## Features\n\n-   **Prayer Times:** Accurate daily schedules (Fajr, Dhuhr, Asr, Maghrib, Isha) via Aladhan API.\n-   **Monthly Calendar:** Fetch and display a full month's prayer schedule for any city.\n-   **Daily Quotes:** Setup daily automation to receive inspiring Islamic quotes.\n-   **Smart Scheduler:** Auto-syncs daily prayer reminders to your agent's system cron.\n-   **Fasting Info:** Imsak and Maghrib times for fasting.\n-   **Zakat Calculator:** Check Nisab thresholds for Gold and Silver based on live market data from IslamicAPI.com.\n-   **Unified Config:** Set location and calculation method once for all tools.\n\n## Installation\n\nInstall via the skills CLI:\n\n```bash\nnpx skills add ilmimris/islamic-skills\n```\n\nOr install manually:\n\n```bash\ncd skills\ngit clone https://github.com/ilmimris/islamic-skills.git islamic-companion\npip install -r islamic-companion/requirements.txt\n```\n\n## Configuration\n\nThe skill uses `config.json` for settings.\n\nWhen first run, it will automatically copy `config.example.json` to `config.json` with default values (Jakarta).\n\n### Update Location\nYou can update your location via the CLI:\n```bash\npython3 src/main.py config --set-loc -6.2088 106.8456 --name \"Jakarta\"\n```\n\n### Setup API Key (Zakat)\nTo get live Zakat data, get a free API key from [IslamicAPI.com](https://islamicapi.com) and add it to `config.json`:\n\n```json\n\"zakat\": {\n    \"api_key\": \"YOUR_API_KEY_HERE\"\n}\n```\n\n## Usage\n\nThe skill exposes a unified CLI `src/main.py` that your agent calls.\n\n### Chat Examples (Onboarding)\n\nOnce installed, you can talk to your agent naturally:\n\n> **User:** \"Set my location to Jakarta\"\n> **Agent:** *Updates config to Jakarta coordinates*\n\n> **User:** \"Sync my prayer times\"\n> **Agent:** *Schedules daily prayer reminders via cron*\n\n> **User:** \"Setup daily Islamic quotes\"\n> **Agent:** *Schedules a daily turn to deliver an inspiring quote*\n\n> **User:** \"Show me the prayer calendar for Serang\"\n> **Agent:** *Fetches and displays the monthly schedule*\n\n> **User:** \"When is Maghrib?\"\n> **Agent:** *Checks today's schedule and replies*\n\n> **User:** \"Check Zakat Nisab\"\n> **Agent:** *Fetches current gold price and calculates threshold*\n\n### CLI Reference\n\nIf you need to run it manually or debug:\n\n#### Prayer Times\n```bash\n# Get today's schedule\npython3 src/main.py prayer --today\n\n# Sync reminders to OpenClaw cron\npython3 src/main.py prayer --sync\n```\n\n#### Quotes\n```bash\n# Setup daily automation\npython3 src/main.py quotes --setup\n\n# Get a random quote\npython3 src/main.py quotes --random\n```\n\n#### Monthly Calendar\n```bash\n# Get calendar for a city\npython3 src/main.py calendar --city \"Serang\" --month 2 --year 2026\n```\n\n### Fasting\n```bash\n# Check Imsak/Iftar times\npython3 src/main.py fasting --today\n```\n\n### Zakat\n```bash\n# Check current Nisab thresholds\npython3 src/main.py zakat --nisab --currency IDR\n```\n\n## License\n\nMIT\n\nFile v0.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn74fkfjfcc6rn3v3saeywtpdh819efa\",\n  \"slug\": \"islamic-skills\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1771242336560\n}\n\nFile v0.1.0:config.example.json\n\n{\n  \"location\": {\n    \"latitude\": -6.2088,\n    \"longitude\": 106.8456,\n    \"name\": \"Jakarta\"\n  },\n  \"calculation\": {\n    \"method\": 20,\n    \"school\": 1\n  },\n  \"zakat\": {\n    \"currency\": \"IDR\",\n    \"gold_gram_threshold\": 85,\n    \"api_key\": \"\"\n  },\n  \"quran_language\": \"id\"\n}\n\nFile v0.1.0:requirements.txt\n\nrequests>=2.25.0","readmeExcerpt":"Skill: Islamic Companion Owner: ilmimris Summary: Unified Islamic utilities for prayer times, fasting schedules, and Zakat calculations using a shared configuration. Tags: latest:2.0.1 Version history: v2.0.1 | 2026-02-17T08:24:27.088Z | auto - Added Python dependency support; now requires python3 and requests for some features. - Updated documentation to include installation and security instructions for API keys. -","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"# Get today's prayer times\n./bin/islamic-companion prayer --today\n\n# Setup daily quote automation\n./bin/islamic-companion quotes --setup\n\n# Get a random quote\n./bin/islamic-companion quotes --random\n\n# Get monthly calendar (Example: Serang, Banten)\n./bin/islamic-companion calendar --city \"Serang\" --month 2 --year 2026\n\n# Sync prayer schedule to cron (generates commands)\n./bin/islamic-companion prayer --sync\n\n# Check fasting times (Imsak/Maghrib)\n./bin/islamic-companion fasting --today\n\n# Check Zakat Nisab values\n./bin/islamic-companion zakat --nisab\n\n# Search Quran for keyword\n./bin/islamic-companion quran --search \"sabar\"\n\n# Get specific Surah (e.g., Al-Fatihah)\n./bin/islamic-companion quran --surah 1\n\n# Get specific Ayah (e.g., Al-Baqarah:255)\n./bin/islamic-companion quran --surah 2 --ayah 255"},{"language":"json","snippet":"{\n  \"location\": {\n    \"latitude\": -6.2088,\n    \"longitude\": 106.8456,\n    \"name\": \"Jakarta\"\n  },\n  \"calculation\": {\n    \"method\": 20,\n    \"school\": 0\n  },\n  \"zakat\": {\n    \"currency\": \"IDR\",\n    \"gold_gram_threshold\": 85,\n    \"api_key\": \"\"\n  },\n  \"quran_language\": \"id\"\n}"},{"language":"bash","snippet":"pip install -r requirements.txt"},{"language":"bash","snippet":"# Get today's prayer times (uses HTTPS)\n./bin/islamic-companion prayer --today\n\nFile v2.0.1:README.md\n\n# Islamic Companion Skill\n\n**Unified tool for prayer times, fasting schedules, and Zakat calculations.**\n\nThis skill consolidates Islamic utilities into a single CLI with shared configuration and efficient caching.\n\n## Features\n\n- **Prayer Times:** Retrieve daily prayer times (Fajr, Dhuhr, Asr, Maghrib, Isha).\n- **Fasting:** Check Imsak and Maghrib times for fasting.\n- **Zakat:** Calculate Nisab thresholds for Gold and Silver based on current market prices.\n- **Quran:** Search for verses by keyword or fetch specific Surah/Ayah with translation.\n- **Calendar:** Generate a monthly prayer schedule for any city.\n- **Quotes:** Fetch and display random Islamic quotes or setup daily automation.\n- **Scheduler:** Generate OpenClaw cron commands to schedule daily prayer reminders.\n- **Caching:** Minimizes API calls by caching daily results locally.\n\n## Usage\n\nRun the CLI using the bash script:"},{"language":"text","snippet":"## Configuration\n\nEdit `skills/islamic-companion/config.json` to set your location and calculation method.\nNote: `config.bash` is auto-generated from `config.json` for performance."},{"language":"text","snippet":"### Calculation Methods\n- **Method 20:** Kemenag RI (Indonesia)\n- **School 0:** Standard (Shafi, Maliki, Hanbali)\n- **School 1:** Hanafi\n\n## Dependencies\n\n- `bash`\n- `curl`\n- `jq` (Recommended for best performance, but limited fallback available)\n\nFile v2.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn74fkfjfcc6rn3v3saeywtpdh819efa\",\n  \"slug\": \"islamic-skills\",\n  \"version\": \"2.0.1\",\n  \"publishedAt\": 1771316667088\n}\n\nFile v2.0.1:config.example.json\n\n{\n  \"location\": {\n    \"latitude\": -6.2088,\n    \"longitude\": 106.8456,\n    \"name\": \"Jakarta\"\n  },\n  \"calculation\": {\n    \"method\": 20,\n    \"school\": 0\n  },\n  \"zakat\": {\n    \"currency\": \"IDR\",\n    \"gold_gram_threshold\": 85,\n    \"api_key\": \"\"\n  },\n  \"quran_language\": \"id\"\n}\n\nFile v2.0.1:requirements.txt\n\nrequests\n\nArchive v2.0.0: 30 files, 27445 bytes\n\nFiles: config.example.json (272b), lib/api.sh (2201b), lib/cache.sh (1048b), lib/calendar.sh (3565b), lib/config.sh (2630b), lib/fasting.sh (989b), lib/format.sh (587b), lib/json.sh (6386b), lib/prayer.sh (2259b), lib/quotes.sh (2764b), lib/quran.sh (9008b), lib/scheduler.sh (2019b), lib/zakat.sh (2601b), README.md (2432b), requirements.txt (1b), SKILL.md (3467b), src/__init__.py (0b), src/api.py (3878b), src/fasting.py (852b), src/islamic_calendar.py (1594b), src/main.py (4581b), src/prayer.py (554b), src/quotes.py (1129b), src/quran_api.py (3348b), src/quran_formatter.py (1678b), src/quran_retrieval.py (485b), src/quran_search.py (926b), src/scheduler.py (1687b), src/zakat.py (1078b), _meta.json (133b)\n\nFile v2.0.0:SKILL.md\n\n---\nname: islamic-companion\ndescription: Unified Islamic utilities for prayer times, fasting schedules, and Zakat calculations using a shared configuration.\n---\n\n# Islamic Companion Skill\n\n**Unified tool for prayer times, fasting schedules, and Zakat calculations.**\n\nThis skill consolidates Islamic utilities into a single CLI with shared configuration and efficient caching.\n\n## Features\n\n- **Prayer Times:** Retrieve daily prayer times (Fajr, Dhuhr, Asr, Maghrib, Isha"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: islamic-companion\ndescription: Unified Islamic utilities for prayer times, fasting schedules, and Zakat calculations using a shared configuration.\n---\n\n# Islamic Companion Skill\n\n**Unified tool for prayer times, fasting schedules, and Zakat calculations.**\n\nThis skill consolidates Islamic utilities into a single CLI with shared configuration and efficient caching.\n\n## Features\n\n- **Prayer Times:** Retrieve daily prayer times (Fajr, Dhuhr, Asr, Maghrib, Isha).\n- **Fasting:** Check Imsak and Maghrib times for fasting.\n- **Zakat:** Calculate Nisab thresholds for Gold and Silver based on current market prices.\n- **Quran:** Search for verses by keyword or fetch specific Surah/Ayah with translation.\n- **Calendar:** Generate a monthly prayer schedule for any city.\n- **Quotes:** Fetch and display random Islamic quotes or setup daily automation.\n- **Scheduler:** Generate OpenClaw cron commands to schedule daily prayer reminders.\n- **Caching:** Minimizes API calls by caching daily results locally.\n\n## Usage\n\nRun the CLI using the bash script:\n\n```bash\n# Get today's prayer times\n./bin/islamic-companion prayer --today\n\n# Setup daily quote automation\n./bin/islamic-companion quotes --setup\n\n# Get a random quote\n./bin/islamic-companion quotes --random\n\n# Get monthly calendar (Example: Serang, Banten)\n./bin/islamic-companion calendar --city \"Serang\" --month 2 --year 2026\n\n# Sync prayer schedule to cron (generates commands)\n./bin/islamic-companion prayer --sync\n\n# Check fasting times (Imsak/Maghrib)\n./bin/islamic-companion fasting --today\n\n# Check Zakat Nisab values\n./bin/islamic-companion zakat --nisab\n\n# Search Quran for keyword\n./bin/islamic-companion quran --search \"sabar\"\n\n# Get specific Surah (e.g., Al-Fatihah)\n./bin/islamic-companion quran --surah 1\n\n# Get specific Ayah (e.g., Al-Baqarah:255)\n./bin/islamic-companion quran --surah 2 --ayah 255\n```\n\n## Configuration\n\nEdit `skills/islamic-companion/config.json` to set your location and calculation method.\nNote: `config.bash` is auto-generated from `config.json` for performance.\n\n```json\n{\n  \"location\": {\n    \"latitude\": -6.2088,\n    \"longitude\": 106.8456,\n    \"name\": \"Jakarta\"\n  },\n  \"calculation\": {\n    \"method\": 20,\n    \"school\": 0\n  },\n  \"zakat\": {\n    \"currency\": \"IDR\",\n    \"gold_gram_threshold\": 85,\n    \"api_key\": \"\"\n  },\n  \"quran_language\": \"id\"\n}\n```\n\n### Calculation Methods\n- **Method 20:** Kemenag RI (Indonesia)\n- **School 0:** Standard (Shafi, Maliki, Hanbali)\n- **School 1:** Hanafi\n\n## Intent Mappings (for Agent)\n\n| User Intent | Command Executed |\n| :--- | :--- |\n| \"Get prayer times\" | `./bin/islamic-companion prayer --today` |\n| \"Show me the calendar for [City]\" | `./bin/islamic-companion calendar --city [City]` |\n| \"Setup daily Islamic quotes\" | `./bin/islamic-companion quotes --setup` |\n| \"Give me a random Islamic quote\" | `./bin/islamic-companion quotes --random` |\n| \"Sync prayer schedule\" | `./bin/islamic-companion prayer --sync` |\n| \"When is Imsak?\" | `./bin/islamic-companion fasti"},{"path":"README.md","content":"# Islamic Companion Skill\n\n**Unified tool for prayer times, fasting schedules, and Zakat calculations.**\n\nThis skill consolidates Islamic utilities into a single CLI with shared configuration and efficient caching.\n\n## Features\n\n- **Prayer Times:** Retrieve daily prayer times (Fajr, Dhuhr, Asr, Maghrib, Isha).\n- **Fasting:** Check Imsak and Maghrib times for fasting.\n- **Zakat:** Calculate Nisab thresholds for Gold and Silver based on current market prices.\n- **Quran:** Search for verses by keyword or fetch specific Surah/Ayah with translation.\n- **Calendar:** Generate a monthly prayer schedule for any city.\n- **Quotes:** Fetch and display random Islamic quotes or setup daily automation.\n- **Scheduler:** Generate OpenClaw cron commands to schedule daily prayer reminders.\n- **Caching:** Minimizes API calls by caching daily results locally.\n\n## Usage\n\nRun the CLI using the bash script:\n\n```bash\n# Get today's prayer times\n./bin/islamic-companion prayer --today\n\n# Setup daily quote automation\n./bin/islamic-companion quotes --setup\n\n# Get a random quote\n./bin/islamic-companion quotes --random\n\n# Get monthly calendar (Example: Serang, Banten)\n./bin/islamic-companion calendar --city \"Serang\" --month 2 --year 2026\n\n# Sync prayer schedule to cron (generates commands)\n./bin/islamic-companion prayer --sync\n\n# Check fasting times (Imsak/Maghrib)\n./bin/islamic-companion fasting --today\n\n# Check Zakat Nisab values\n./bin/islamic-companion zakat --nisab\n\n# Search Quran for keyword\n./bin/islamic-companion quran --search \"sabar\"\n\n# Get specific Surah (e.g., Al-Fatihah)\n./bin/islamic-companion quran --surah 1\n\n# Get specific Ayah (e.g., Al-Baqarah:255)\n./bin/islamic-companion quran --surah 2 --ayah 255\n```\n\n## Configuration\n\nEdit `skills/islamic-companion/config.json` to set your location and calculation method.\nNote: `config.bash` is auto-generated from `config.json` for performance.\n\n```json\n{\n  \"location\": {\n    \"latitude\": -6.2088,\n    \"longitude\": 106.8456,\n    \"name\": \"Jakarta\"\n  },\n  \"calculation\": {\n    \"method\": 20,\n    \"school\": 0\n  },\n  \"zakat\": {\n    \"currency\": \"IDR\",\n    \"gold_gram_threshold\": 85,\n    \"api_key\": \"\"\n  },\n  \"quran_language\": \"id\"\n}\n```\n\n### Calculation Methods\n- **Method 20:** Kemenag RI (Indonesia)\n- **School 0:** Standard (Shafi, Maliki, Hanbali)\n- **School 1:** Hanafi\n\n## Dependencies\n\n- `bash`\n- `curl`\n- `jq` (Recommended for best performance, but limited fallback available)"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn74fkfjfcc6rn3v3saeywtpdh819efa\",\n  \"slug\": \"islamic-skills\",\n  \"version\": \"2.0.1\",\n  \"publishedAt\": 1771316667088\n}"},{"path":"config.example.json","content":"{\n  \"location\": {\n    \"latitude\": -6.2088,\n    \"longitude\": 106.8456,\n    \"name\": \"Jakarta\"\n  },\n  \"calculation\": {\n    \"method\": 20,\n    \"school\": 0\n  },\n  \"zakat\": {\n    \"currency\": \"IDR\",\n    \"gold_gram_threshold\": 85,\n    \"api_key\": \"\"\n  },\n  \"quran_language\": \"id\"\n}"},{"path":"requirements.txt","content":"requests"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Unified Islamic utilities for prayer times, fasting schedules, and Zakat calculations using a shared configuration. Skill: Islamic Companion Owner: ilmimris Summary: Unified Islamic utilities for prayer times, fasting schedules, and Zakat calculations using a shared configuration. Tags: latest:2.0.1 Version history: v2.0.1 | 2026-02-17T08:24:27.088Z | auto - Added Python dependency support; now requires python3 and requests for some features. - Updated documentation to include installation and security instructions for API keys. -","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1027,"uniquenessScore":45,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T16:28:54.649Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T16:28:54.649Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T20:59:05.029Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}