🎯 Business Analysis Skill

مهارة تحليل أعمال تنفيذية بمستوى شركات الاستشارات الكبرى (Big Four) — مبنية لـ Claude.

من ملف Excel أو CSV واحد، السكل بتطلع تقرير HTML تفاعلي كامل فيه ملخص تنفيذي، مؤشرات KPIs، تحليل جذور الأسباب، SWOT، فرص، مخاطر، توقعات، وتوصيات — كله بالعربي RTL وبتصميم Enterprise-grade.

✨ ليه السكل ده مختلف

معظم أدوات التحليل بتوصف الداتا. السكل ده بيفكر زي فريق استشارات كامل جوه Claude:

Senior Business Analyst · Senior Data Analyst · BI Consultant · Strategy Consultant · Financial Analyst · Revenue Manager · Sales Director · Operations Manager · CEO Advisor

بمعنى إنه ما بيقولش لك "المبيعات نزلت ٧٪". بيقولك:

  • إيه اللي حصل؟ المبيعات نزلت ٧٪ الشهر ده
  • ليه؟ فرع الجيزة نزل ١٨٪ بسبب تراجع عميلين كبار (تركّز ٢٣٪ من الربح)
  • إيه أثره؟ خسارة ربح متوقعة ٤١٠ ألف جنيه لو استمر
  • إيه القرار؟ استرداد العميلين + توسيع قاعدة B في القاهرة الكبرى
  • إيه المخاطر؟ لو ما اتحركناش خلال أسبوعين، الفرع يخسر مركزه في التوب ٣

🏗️ المعمارية — ليه بتشتغل بدون ما تعلّق

السكل مبني على ٣ أصول جاهزة بتمنع أكبر مشكلتين في تقارير Claude:

  • استهلاك التوكنز — الشيل جاهز، مش بيتكتب من الأول كل مرة
  • الوقوع في نص التقرير — التجميع الحتمي بيمنع أي <style> مفتوح أو ملف فاضي
الملف وظيفته
assets/profile_data.py Profiler بيقرأ الملف مرة واحدة ويطلع خريطة كاملة عن الأوراق والأعمدة والعلاقات
assets/template.html قالب التقرير الكامل: CSS + Dark mode + Mobile drawer + محرك رسوم بياني بـ ١٠ أنواع + Footer برانديد
assets/build_report.py Assembler حتمي بيدمج sections.html + report.json في ملف HTML واحد، وبيرفض التسليم لو فيه أي خطأ بنيوي

النتيجة: كل تقرير بيخلص في ٤–٥ Bash calls بدل ١٠–٢٠، وبـ ~٥٠٠٠ توكن output بدل ~٢٥٠٠٠.

📊 اللي بيطلعه التقرير

الأقسام الأساسية:

  • الملخص التنفيذي + Business Health Score
  • تقييم جودة البيانات (٠–١٠٠) مع شرح كل ملاحظة
  • مجموعة KPIs مقترحة بذكاء حسب طبيعة البيانات
  • تحليل الفترة الحالية مقابل السابقة (Period-over-Period)
  • استقرار الترتيب (Leaderboard Stability) — مين اتغير مركزه وليه
  • التركّز والاعتماد (Pareto/ABC) — مين شايل ٨٠٪ من الربح
  • Profit Bridge (Waterfall) — الفلوس راحت فين
  • Portfolio Quadrants (Scatter) — إيرادات × هامش × حجم
  • Heatmap للموسمية × الفروع أو المنتجات
  • SWOT مبني على أرقام حقيقية مش كلام عام
  • Risk Matrix (حرج / عالي / متوسط / منخفض)
  • توصيات مسعّرة بأثر مالي متوقع
  • توقعات مستقبلية (Forecast) لما يكون فيه تاريخ كافي

تحليلات متقدمة عبر الأوراق (لو الملف فيه أكتر من شيت):

  • كشف تلقائي للعلاقات ومفاتيح الربط (١:١، ١:many)
  • مطابقة الإجماليات بين الأوراق (Reconciliation)
  • تحليل Sales × Returns × Discounts × Expenses × Collections × Inventory كنموذج واحد
  • تحديد الفجوات (إيه السؤال التنفيذي اللي مش هينفع نجاوبه لأن الشيت الفلاني ناقص)

📈 محرك الرسوم البيانية

١٠ أنواع رسوم، كلها بتحترم العربي RTL وبتشتغل على الموبايل والديسكتوب:

النوع بيستخدم لـ
hbar الترتيب واللوحات الصدارية
line الاتجاه الزمني
pareto التركّز والـ ABC (٨٠/٢٠)
waterfall جسور الربح والانحرافات
scatter تحديد المحفظة (إيراد × هامش × حجم)
stacked / grouped تطور المزيج
combo القيمة × النسبة (مبيعات × نسبة الخصم)
heatmap المصفوفات (فرع × شهر)
donut الحصة من الإجمالي

كل رسم بيبقى معاه عنوان + Takeaway تنفيذي بجملة (مش زخرفة).

🚀 إزاي تستخدمها

الطريقة الأولى — Claude.ai (الأسهل)

انسخ فولدر السكل ده في مكان مهاراتك الشخصية، وClaude هيفعّلها تلقائياً لما ترفع أي ملف Excel أو CSV.

الطريقة الثانية — Claude Code

git clone https://github.com/YOUR_USERNAME/business-analysis-skill.git ~/.claude/skills/business-analysis

بعدها، أول مرة ترفع فيها ملف بيانات، Claude هيشغّل السكل تلقائياً.

الطريقة الثالثة — استدعاء مباشر

/business-analysis
[ارفع ملف Excel أو CSV]

مافيش أسئلة توضيحية. السكل مصمم إنه يفهم الملف لوحده ويشتغل من غير ما يسأل عن أسماء الأعمدة أو الوحدات — لأن ده اللي بيميّز أدوات الاستشارات الحقيقية عن الشات بوت.

📁 هيكل الريبو

business-analysis-skill/
├── SKILL.md                    # المهارة كاملة (٥٠٠+ سطر)
├── README.md                   # اللي بتقراه دلوقتي
├── LICENSE                     # MIT
├── CHANGELOG.md                # سجل الإصدارات
└── assets/
    ├── profile_data.py         # Profiler للملفات
    ├── template.html           # قالب التقرير (٥٠KB)
    └── build_report.py         # Assembler حتمي

🎨 الفلسفة اللي وراها

لا تقرأ مؤشر لوحده. الخصم لازم يتقرا مع الحجم، والعائد مع العميل، والتحصيل مع شروط الائتمان. أي توصية مبنية على مؤشر واحد معزول = نصيحة غلط.

FACT / LIKELY / HYPOTHESIS. كل استنتاج بيتوسم بمستوى الثقة. مش كل حاجة "علينا فوراً نعمل" — الثقة جزء من الرسالة.

اذكر السبب واذكر الرافعة. كل نتيجة تقول: هل السعر ولا الحجم ولا المزيج ولا التغطية ولا الائتمان هو اللي حرّكها؟

اقتصاد العميل مش بس الإيراد. العملاء بيتصنفوا على أساس: الإيراد، الربح الإجمالي والصافي، الخصم، العائد، أيام التحصيل، مخاطر الائتمان، تكلفة النقل، وتأثير التدفق النقدي — مش الإيراد لوحده.

🛠️ المتطلبات

  • Python 3.8+
  • pandas, openpyxl (للـ Excel)
  • Claude Opus 4.5+ أو Sonnet 4.6+ (الموديل بيحدد جودة التوصيات)

بدون مكتبات خارجية في التقرير النهائي — كل CSS و JS مضمّنين في ملف HTML واحد بينفتح على أي متصفح Offline.

📄 الرخصة

MIT License — استخدم، عدّل، وزّع بحرية. لو استخدمت السكل في مشروع تجاري أو محتوى منشور، إشارة للمصدر بتبقى محل تقدير.

👤 عن المطوّر

م. عبدالرحمن محمود علي بسيوني

محلل بيانات ومطوّر أعمال متخصص في FMCG المصرية، صاحب خبرة في تحليل التوزيع متعدد الفروع، الموسمية، ونماذج Volume-Price-Mix. مطوّر أنظمة ERP و BI مخصصة على Google Apps Script و Power BI و Python.

🤝 المساهمة

أي اقتراح، مشكلة، أو تحسين → افتح Issue أو Pull Request. السكل ده حي وبيتطور، وأي إضافة من مجتمع محللي البيانات محل ترحيب.

⭐ لو السكل ساعدك، اديها Star على GitHub — ده بيوصلها لناس تانية محتاجاها.