Islamic Reflection

Provides daily Islamic reflections with Hijri calendar awareness, including Ramadan, Jummah, and Dhul Hijjah, plus Quran/Hadith references and practical chal...

Security Scan

The skill and included Python script are coherent with the stated purpose (daily Islamic reflections); it has no credential requests, no unusual installs, and only makes a single harmless lookup to a public Hijri API.

Purpose & Capability

Name/description match the included assets: the SKILL.md instructs running a local Python script and the repo includes a reflection generator. No unrelated binaries, env vars, or cloud credentials are requested.

Instruction Scope

SKILL.md mandates always executing the included script and displaying its raw output exactly as returned. The script itself only reads the local date, selects a reflection, and performs one outbound HTTPS call to api.aladhan.com to obtain the Hijri date. Requiring execution and verbatim display is restrictive but consistent with the skill's goal; it does mean the agent must run included code rather than generate its own content, so review of the script is warranted before use.

Install Mechanism

No install spec; this is instruction-only with an included Python script. No downloads or third-party packages are fetched at install time.

Credentials

The skill requests no environment variables, credentials, or config paths. The single external network call is to a public Hijri API and does not send user secrets or system data.

Persistence & Privilege

always is false and the skill does not request elevated or persistent privileges. Autonomous invocation is allowed by default but the skill does not modify other skills or system settings.

Assessment

This skill appears internally consistent and low-risk: it runs a bundled Python script that prints a daily reflection and fetches the Hijri date from api.aladhan.com. Before installing, consider: (1) Review the included script (scripts/reflection.py) yourself or run it in a sandbox to confirm behavior; (2) Be aware the SKILL.md forces the agent to execute and display the script's raw output — if you prefer the agent to filter or summarize output, do not allow automatic verbatim printing; (3) If you are security-sensitive, disable autonomous invocation (or run the skill in an environment with restricted network access) so the agent cannot call the external API or run the script without your explicit consent.

Islamic Daily Reflection

CRITICAL: Always Run the Script

When user requests a reflection, you MUST execute the Python script:

python scripts/reflection.py

Display the complete output exactly as returned by the script.

The script provides:

• ✅ Formatted output with ═══ borders
• ✅ Hijri calendar awareness
• ✅ Ramadan/Jummah/Regular reflections
• ✅ Actionable daily challenges
• ✅ Quran/Hadith references

DO NOT generate your own reflection. ALWAYS run the script.

User Commands

Users may ask:

• "daily reflection"
• "islamic reminder"
• "inspire me"
• "motivate me islamically"
• "friday reflection"
• "ramadan reflection"

For ALL of these: run python scripts/reflection.py

Script Output Format

The script returns formatted text like:

═══════════════════════════════════════
📅 Thursday, 13 February 2026 | 25 Sha'ban 1447

🤲 Patience in Small Trials

[Reflection content...]

💡 Today's Action (X min):
[Actionable challenge...]

📖 [Quran/Hadith reference]
═══════════════════════════════════════

Display this output exactly as received - preserve all formatting, emojis, and borders.

Technical Details

The script (scripts/reflection.py):

• Detects current date (Gregorian + Hijri)
• Selects appropriate reflection type:
  • Ramadan days 1-30 (specific reflections)
  • Jummah (Friday reflections)
  • Regular days (30 rotating themes)
• Formats with consistent structure
• No external dependencies (uses stdlib only)

Reflection Themes

Regular days rotate through: Patience, Gratitude, Tawakkul, Taqwa, Ikhlas, Humility, Contentment, Hope, Khashyah, Love for Allah, Brotherhood, Honesty, Justice, Mercy, Forgiveness, Charity, Good Character, Dhikr, Knowledge, Kindness to Parents, Neighbors, Promises, Avoiding Backbiting, Controlling Anger, Thankful in Trials, Dua, Quran Reading, Tahajjud, Fasting, Remembering Death

Special occasions:

• Ramadan (Month 9): Day-specific reflections
• Dhul Hijjah (Month 12, Days 1-10): Hajj themes
• Jummah (Fridays): Friday-specific
• Muharram (Day 10): Ashura

Version

1.0.0 - Python script with pre-written reflections