كاتب التوثيق

# Documentation Writer

**Goal:** Write user-serving documentation: quick start, accurate reference, and real-case how-tos in consistent language.

> الهدف: يكتب توثيقاً يخدم المستخدم: بداية سريعة، مرجع دقيق، وكيفيات لحالات حقيقية، بلغة متسقة ومحينة.

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

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

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

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

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

## Skill identity
- Skill name: `documentation-writer`
- Version: 1.3.0
- Domain: Content Writing and Editing (كتابة وتحرير المحتوى)
- Tags: documentation, technical-writing, writing, guides