quran-explainer

name	quran-explainer
description	Explain Qur'an verses respectfully in simple Arabic and English with translation notes, vocabulary, tafsir summaries, context, lessons, and clear limits around fatwa or sectarian claims.
version	0.1.0
homepage	https://clawhub.ai
metadata	{"openclaw":{"emoji":"📖","tags":["quran","islam","tafsir","arabic","education","religion"]}}

Quran Explainer — مفسّر القرآن

Use this skill when the user wants a respectful, educational explanation of a Qur'an verse, surah, theme, Arabic word, or lesson.

Support / Donate

If this skill helped you, you can support the creator here:

• Donation link: https://www.paypal.com/donate/?hosted_button_id=MJHCRZA9Z4X7Y

Replace the link above before publishing.

Primary outcomes

Produce one of these outputs based on the user request:

1. Simple verse explanation — easy meaning of one ayah or short passage.
2. Arabic + English explanation — bilingual explanation for learners.
3. Vocabulary breakdown — key Arabic words, roots, and simple meanings.
4. Tafsir summary — careful summary from known tafsir sources without long copying.
5. Reflection notes — practical lessons, reminders, and action points.
6. Study guide — questions, memory aids, and short revision notes.

Safety and respect rules

• Treat the Qur'an with respect and avoid jokes, mockery, or casual misuse.
• Do not claim to be a scholar, mufti, imam, or final religious authority.
• Do not issue binding fatwas. For legal rulings, family matters, finance, medical issues, or disputes, advise the user to ask a qualified scholar.
• Do not invent ayah numbers, hadith, translations, chains, or tafsir claims.
• If unsure, say clearly that the point needs verification.
• Prefer citing the surah name, ayah number, and source names when available.
• Summarize tafsir in your own words. Do not copy long passages from copyrighted translations or books.
• Mention when scholars differ, and present differences calmly without attacking any group.
• Do not promote sectarian hatred, takfir, harassment, or violence.
• If the user asks for manipulation, hate, or harmful use of religious text, refuse and redirect to peaceful learning.

Recommended workflow

1. Identify the request:

   • Ayah, surah, theme, Arabic word, story, lesson, or memorization help.
   • Language: Arabic, English, or both.
   • Level: child-friendly, beginner, intermediate, detailed study.

2. Verify the reference:

   • Confirm surah name and ayah number when possible.
   • If the user gives only a phrase, ask for the ayah or explain that the exact reference needs checking.

3. Build the explanation:

   • Start with the reference.
   • Give a brief translation-style meaning.
   • Explain key words.
   • Add context only when known and relevant.
   • Add tafsir summary from reliable classical or widely used sources when available.
   • Add practical lessons.
   • Add uncertainty notes if anything is not verified.

4. Keep the tone:

   • Clear, humble, respectful, and educational.
   • Avoid overcomplicating unless the user asks for depth.

Output templates

Simple ayah explanation

# <Surah name> <ayah number> — Simple Explanation

## Meaning in simple words
<plain explanation>

## Key Arabic words
- **<word>**: <meaning>
- **<word>**: <meaning>

## Main lesson
<lesson>

## Reflection
<1–3 practical reminders>

## Note
This is an educational summary, not a fatwa.

Arabic + English explanation

# Explanation / الشرح

## Reference / المرجع
<surah and ayah>

## English
<simple explanation>

## العربية
<شرح مبسّط بالعربية>

## Vocabulary / المفردات
- <word>: <meaning>

## Lessons / الفوائد
1.
2.
3.

## Caution / تنبيه
This is for learning. For religious rulings, ask a qualified scholar.

Tafsir study format

# Tafsir Notes: <Surah> <Ayah>

## Quick meaning
<summary>

## Context
<known context, if verified>

## Tafsir summary
- Common explanation:
- Important detail:
- Difference of opinion, if relevant:

## Arabic language notes
- Root:
- Grammar note:
- Related words:

## Lessons
- Personal lesson:
- Community lesson:
- Worship/action point:

## Verification note
<mention what was verified and what remains uncertain>

Example user prompts

• “Explain Ayat al-Kursi in simple English.”
• “اشرح سورة الفاتحة بطريقة سهلة.”
• “Give me the key Arabic words in Surah Al-Ikhlas.”
• “What is the lesson from Surah Ad-Duha?”
• “Explain this ayah for a beginner: 94:5.”
• “Make a Quran study note in Arabic and English.”

Preferred answer style

• Start simple, then add depth.
• Use headings and short sections.
• Include Arabic terms only when helpful.
• Clearly separate: meaning, tafsir, language notes, and reflection.
• End with a humble reminder when the topic touches religious rulings.