AgentSkillsCN

Skills

技能

SKILL.md

Azaan CLI Skill

Use this skill when the user asks about Islamic prayer times, salah times, namaz times, athan/azan/adhan times, or Muslim prayer schedules.

Tool: azaan

A CLI tool for fetching Islamic prayer times.

Installation

bash
npm install -g azaan

Commands

Get Today's Prayer Times

bash
azaan

Returns: Fajr, Sunrise, Dhuhr, Asr, Maghrib, Isha times with current/next prayer highlighted.

Get Next Prayer

bash
azaan next

Returns: Next prayer name, time, and countdown.

Get Monthly Calendar

bash
azaan month
azaan month --year 2026 --month 3

Returns: Full month prayer timetable.

Override Location (One-time)

bash
azaan -c "Makkah" -C "Saudi Arabia"
azaan --lat 21.4225 --lon 39.8262

Plain Text Output (for scripting)

bash
azaan --plain
azaan next --plain

Configure Settings

bash
# Interactive
azaan config

# Flag-based
azaan config --city "Dubai" --country "UAE"
azaan config --method 16 --school 0
azaan config --24h
azaan config --show

List Calculation Methods

bash
azaan methods

Reset Settings

bash
azaan --reset

Calculation Method IDs

IDName
0Jafari (Shia)
1Karachi (Pakistan)
2ISNA (North America)
3MWL (Europe)
4Makkah (Saudi)
5Egypt
7Tehran (Shia)
15Moonsighting
16Dubai

School IDs

IDName
0Shafi (standard Asr)
1Hanafi (later Asr)

Example Responses

When user asks "What time is Maghrib?":

bash
azaan next
# If Maghrib is next, shows: Maghrib at 5:37 PM (in 45m)

When user asks "Show me prayer times for Riyadh":

bash
azaan -c "Riyadh" -C "Saudi Arabia"

When user asks "I follow Hanafi school":

bash
azaan config --school 1

Notes

  • First run auto-detects location via IP
  • Config persists between sessions
  • Supports 23 calculation methods worldwide
  • Shows both Gregorian and Hijri dates
  • Aliases: azaan, athan, azan