Quran Explainer

SKILL.md

---
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

```markdown
# <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

```markdown
# 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

```markdown
# 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.