playbooks

home / skills / openclaw / skills / ramadan-times

ramadan-times skill

/skills/xymoxy/ramadan-times

This skill automatically detects your location and provides accurate Ramadan times in your language across 100+ cities.

npx playbooks add skill openclaw/skills --skill ramadan-times

Review the files below or copy the command above to add this skill to your agents.

Files (3)
SKILL.md
2.4 KB
---
name: ramadan-times
description: Intelligent Ramadan times skill that auto-detects location, provides accurate iftar/sahur times in user's language, and supports 100+ cities worldwide. Supports Turkish, English, Arabic and more.
triggers:
  - ramazan
  - iftar
  - sahur
  - oruç
  - ramadan
  - prayer times
  - iftar saati
  - when is iftar
  - sahur time
metadata:
  openclaw:
    emoji: "🌙"
    requires:
      bins: ["curl", "date"]
    settings:
      location: auto-detect
      language: auto-detect
---

# Ramadan Times Skill 🌙

Intelligent Ramadan times with auto-location detection and multi-language support.

## Features

- 🌍 Auto-detects user location/timezone
- 🌍 Supports 100+ cities worldwide
- 🗣️ Multi-language: TR, EN, AR, DE, FR, ES, RU
- ⏰ Real-time countdown to iftar
- 📅 Weekly schedule support
- 🔔 Daily reminder capability

## Usage

Just ask naturally:
- "İftar saatleri?" / "When is iftar?"
- "Sahur ne zaman?" / "When is sahur?"
- "Ramazan ne zaman başlıyor?"
- "İstanbul iftar"
- "London iftar time"

## Auto-Detection

1. Check user's timezone from OpenClaw config
2. Fallback to Istanbul if not found
3. Support city override in query

## Supported Languages

| Code | Language |
|------|----------|
| tr | Türkçe |
| en | English |
| ar | العربية |
| de | Deutsch |
| fr | Français |
| es | Español |
| ru | Русский |

## Response Examples

### Turkish (auto)
```
🌙 RAMADAN - İstanbul

📅 20 Şubat 2026, Cuma

🌅 Sahur: 04:30
🌅 İftar: 18:47

⏰ İftara: 5 saat 23 dakika
```

### English (auto)
```
🌙 RAMADAN - Istanbul

📅 Friday, February 20, 2026

🌅 Sahur: 04:30
🌅 Iftar: 18:47

⏰ Time until iftar: 5 hours 23 minutes
```

## Supported Cities

Major cities:
- Istanbul, Ankara, Izmir, Istanbul (TR)
- London, New York, Los Angeles, Dubai, Cairo
- Paris, Berlin, Moscow, Tokyo
- And 100+ more...

## API Sources

1. sunrise-sunset.org (sunrise/sunset times)
2. Prayer times API (fallback)
3. Manual calculation (emergency fallback)

## Intelligent Features

1. **Auto-language**: Detect from user or use English
2. **Auto-location**: Get from system timezone
3. **City search**: Override with explicit city name
4. **Time until**: Calculate and show countdown
5. **Next week**: Show entire week's schedule

## Cron Integration

Can be used for daily iftar reminder:
```
0 17 * * * - "İftara 2 saat kaldı!" reminder
```

Overview

This skill provides intelligent Ramadan times with auto-detected location and multi-language support. It returns accurate sahur and iftar times, real-time countdowns, and weekly schedules for 100+ cities. It can send daily reminders and supports many languages including English, Turkish and Arabic.

How this skill works

The skill reads the user timezone or configured location and falls back to a default city if needed. It fetches sunrise/sunset times from reliable APIs and applies prayer-time calculations or fallbacks for accuracy. Users can override the detected city and request language-specific responses; it also computes time-until iftar and can produce weekly schedules or cron-driven reminders.

When to use it

  • Ask for today’s iftar or sahur time for your detected location
  • Request a city-specific Ramadan schedule (e.g., “Istanbul iftar”)
  • Get a countdown to iftar or sahur in your preferred language
  • Set up daily iftar reminders via cron or scheduled notifications
  • Fetch an entire week’s Ramadan timetable for planning

Best practices

  • Provide permission to read timezone/location for accurate local times
  • Specify city name when traveling or when timezone is ambiguous
  • Choose preferred language for consistent responses
  • Use weekly schedule for meal planning and community announcements
  • Validate reminder cron entries in your scheduler before enabling

Example use cases

  • User asks “When is iftar?” and receives a localized, language-matched response with countdown
  • Admin schedules daily reminders: “Iftara 2 saat kaldı!” via cron to a group chat
  • User requests a week view: “Show next week’s sahur/iftar for London” for meal planning
  • Traveler overrides auto-location: “Dubai iftar time” to get precise times while abroad
  • Developer integrates reminders into a community bot for daily notifications

FAQ

Which cities are supported?

Over 100 major cities worldwide are supported; you can also request a specific city by name as an override.

What languages are available?

The skill supports English, Turkish, Arabic, German, French, Spanish, Russian and can auto-detect or accept a language preference.

How accurate are the times?

Times are based on sunrise/sunset APIs and standard prayer-time calculations, with fallback manual calculations for reliability.

Can I get daily reminders?

Yes. The skill supports cron-style scheduling for daily reminders and can send countdown notifications before iftar.