مقياس قابلية القراءة

# Readability Scorer

**Goal:** Measure text difficulty objectively: sentence length, terminology, and paragraph rhythm with meaning-preserving fixes.

> الهدف: يقيس صعوبة النص موضوعياً: طول جمل، مصطلحات، وتقطيع فقرات، ويقترح تعديلات تحفظ المعنى وترفع الوضوح.

## When to use
- الحالة النموذجية: يقيس صعوبة النص موضوعياً: طول جمل، مصطلحات، وتقطيع فقرات، ويقترح تعديلات تحفظ المعنى وترفع الوضوح.
- تحويل مادة تقنية إلى محتوى مفهوم لجمهور أوسع.
- مراجعة مسودة نهائية قبل النشر.
- توحيد نبرة الكتابة مع دليل صوت العلامة.
- تحرير مسودة وتحسين وضوحها وإيقاعها.

## Workflow
1. حدّد الهدف: مقياس قابلية القراءة. اذكر الجمهور والفكرة الواحدة التي يجب أن تبقى في ذهنه.
2. افحص نهائياً: عناوين فرعية، فقرات قصيرة، وخلاصة واضحة أو دعوة فعل.
3. اكتب مخططاً من 5-9 نقاط بترتيب منطقي قبل صياغة أي فقرة.
4. حرّر بتمريرة للجمل: اختصر، فعّل الأفعال، واحذف الحشو.
5. حرّر بتمريرة للبنية: ترتيب الأفكار وحذف التكرار.
6. اجمع المادة: نقاط رئيسية، أمثلة، أرقام موثوقة، وقيود النبرة.
7. اكتب المسودة الأولى دون توقف للتحرير؛ الكمية ثم الجودة.
8. صُغ العنوان والمقدمة: وعد واضح، ثم أثبت أنك ستفيه بسرعة.

## Rules
- الأرقام والحقائق تُنسب لمصدرها باختصار.
- خاطب القارئ مباشرة عند المناسبة ولا تحدث عن نفسك أكثر منه.
- الجملة الأولى من كل فقرة تحمل معناها الأساسي.
- احذف أي جملة لا تخدم القارئ أو الهدف.
- فكرة واحدة لكل فقرة، و3-5 جمل لكل فكرة.

## Output contract
- مخطط المادة الأصلية لأي تطوير لاحق.
- قائمة عناوين بديلة للاختبار.
- ملاحظات تحرير تلخص أهم التغييرات وسببها.
- نسخة مختصرة للقنوات القصيرة عند الطلب.

## Quality checks
- [ ] هل مرّت المسودة على التمريرات الثلاث: بنية، جمل، جمهور؟
- [ ] هل الخاتمة تدفع القارئ لفعل واضح أو خلاصة مفيدة؟
- [ ] هل الحشو والملاحظات الجانبية حُذفت؟
- [ ] هل يمكن قراءة النص بصوت عالٍ دون علّة؟
- [ ] هل الأفكار متسلسلة بحيث لا يعود القارئ للخلف ليفهم؟

## Skill identity
- Skill name: `readability-scorer`
- Version: 1.1.0
- Domain: Content Writing and Editing (كتابة وتحرير المحتوى)
- Tags: readability, editing, writing, clarity