← Back to Skills Marketplace
m7madash

Hadith Verifier

by Mohammad · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
17
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install hadith-verifier
Description
Verify authenticity of hadiths against major collections before publishing Islamic content, ensuring accurate source citation and text matching.
README (SKILL.md)

🕌 Hadith Verifier — تحقق من صحة الأحاديث

«مَنْ كَذَبَ عَلَيَّ مُتَعَمِّدًا فَلْيَتَبَوَّأْ مَقْعَدَهُ مِنَ النَّارِ» — البخاري (107) ومسلم (1)

⚠️ قاعدة مطلقة: لا تنشر أي حديث بدون تحقق. إذا لم تستطع التحقق → "لا أعلم".


المنهجية

ترتيب المصادر (إلزامي):

  1. القرآن الكريم (النص العربي فقط)
  2. السنة الصحيحة (بسند متصل للصحابي)
  3. إجماع الصحابة (بسند متصل)

❌ لا يُعتمد على: رأي فقيه بذاته، مذهب معين، أو اجتهاد بشري بدون دليل


الاستخدام

1. البحث عن حديث:

python3 scripts/hadith_db.py search '\x3Cكلمات البحث>' --limit 5
# مثال: البحث عن حديث بالنوايا
python3 scripts/hadith_db.py search "intention actions judged"

# مثال: بالعربي
python3 scripts/hadith_db.py search "من غشنا ليس منا"

# مثال: تحديد المجموعة
python3 scripts/hadith_db.py search "prayer" --collections bukhari,muslim

2. جلب حديث برقم معين:

python3 scripts/hadith_db.py get bukhari 1
python3 scripts/hadith_db.py get muslim 102

3. التحقق من حديث محدد:

python3 scripts/verify_hadith.py '\x3Cنص الحديث>' --source \x3Cالمجموعة> --رقم \x3Cالرقم>

المجموعات المدعومة

المجموعة الاسم الوزن
bukhari صحيح البخاري highest
muslim صحيح مسلم highest
tirmidhi جامع الترمذي high
abudawud سنن أبي داود high
nasai سنن النسائي high
ibnmajah سنن ابن ماجه medium
malik موطأ مالك high
nawawi الأربعون النووية reference
qudsi الأحاديث القدسية reference

درجات التحقق

الدرجة المعنى الإجراء
verified صحيح — متطابق مع المصدر ✅ انشر مع المصدر
likely_authentic غالبًا صحيح — تطابق عالي ✅ انشر مع الإشارة
possible_match تطابق جزئي ⚠️ راجع يدويًا
weak_match تطابق ضعيف ⚠️ لا تنشر بدون مراجعة
not_found غير موجود في المصادر ❌ لا تنشر
text_mismatch النص لا يطابق المصدر المذكور ❌ لا تنشر — يُرجّح أنه موضوع

المصادر المفتوحة المستخدمة

  • fawazahmed0/hadith-api — قاعدة بيانات مفتوحة المصدر للإحاديث
  • تشمل: البخاري، مسلم، الترمذي، أبو داود، النسائي، ابن ماجه، مالك
  • اللغات: عربي + إنجليزي + 6 لغات أخرى

قواعد النشر

✅ يُسمح بالنشر فقط إذا:

  • وُجد الحديث في أحد الكتب الستة (أو الموطأ)
  • المصدر مذكور بوضوح (الكتاب + الرقم)
  • النص متطابق أو قريب جدًا من الأصل

❌ يُمنع النشر:

  • إذا لم يُوجد الحديث في أي مصدر
  • إذا كان المصدر غير موثق
  • إذا كان النص مختصرًا بشكل يُغيّر المعنى
  • إذا كان الحديث "مشهورًا على الإنترنت" فقط بدون أصل

🚫 ممنوع تمامًا:

  • نسب حديث للنبي ﷺ بدون سند
  • نشر أحاديث ضعيفة/موضوعك على أنها صحيحة
  • الاعتماد على الذكاء الاصطناعي كمصدر للأحاديث

التعامل مع الأحاديث الضعيفة

من درج الحديث هل يُنشر؟ الشرط
Sahih (صحيح) ✅ نعم مع ذكر المصدر
Hasan (حسن) ⚠️ بحذر مع ذكر الدرجة والمصدر
Daif (ضعيف) ❌ لا إلا في فضائل الأعمال مع التنبيه
Maudu (موضوع) ❌ أبدًا يُحذفورًا

عند الشك

إذا لم تستطع التحقق من حديث:

«هذا الحديث لا أستطيع التحقق منه. أرجع لأهل العلم. لا أنشره حتى يتثبت منه.»


تنبيه مهم

هذا النظام أداة مساعدة فقط. لستَ محدثًا ولا مُحقق أحاديث. المرجع النهائي لأهل العلم. عند التناقض بين النظام وأهل العلم → حكم أهل العلم هو المعتمد.


بفضل الله — التوفيق من الله

Usage Guidance
Before installing, understand that using the helper requires network access to jsDelivr to download public hadith datasets, which can reveal that the tool queried particular collections. The reviewed version does not send the hadith text itself, does not require API keys, and does not write files or modify your environment.
Capability Assessment
Purpose & Capability
The stated purpose is to verify hadith authenticity against named collections, and the scripts implement search and verification against the fawazahmed0/hadith-api data hosted through jsDelivr.
Instruction Scope
The skill gives strong publishing guidance for Islamic content, but it is aligned with its stated verification purpose and does not contain hidden role changes, prompt overrides, or unrelated agent-control instructions.
Install Mechanism
The package declares only the skill file and Python helper scripts, with no dependency install hooks, postinstall behavior, or package scripts.
Credentials
Network use is proportionate to the lookup function and limited to fetching public hadith collection JSON from a disclosed CDN endpoint; inspected code does not send the user's hadith text in request URLs or request bodies.
Persistence & Privilege
No privileged access, credential/session handling, background workers, file writes, or durable persistence were found; the only cache is an in-process dictionary in hadith_db.py.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install hadith-verifier
  3. After installation, invoke the skill by name or use /hadith-verifier
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: verify hadith authenticity against major collections (Bukhari, Muslim, Tirmidhi, Abu Dawud, Nasai, Ibn Majah, Malik). Arabic/English text search with grading.
Metadata
Slug hadith-verifier
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Hadith Verifier?

Verify authenticity of hadiths against major collections before publishing Islamic content, ensuring accurate source citation and text matching. It is an AI Agent Skill for Claude Code / OpenClaw, with 17 downloads so far.

How do I install Hadith Verifier?

Run "/install hadith-verifier" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Hadith Verifier free?

Yes, Hadith Verifier is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Hadith Verifier support?

Hadith Verifier is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Hadith Verifier?

It is built and maintained by Mohammad (@m7madash); the current version is v1.0.0.

💬 Comments