skill
business-analysis-skill
Executive business analysis skill for Claude — Big Four-grade consulting from any Excel/CSV file (Arabic RTL)
Set up
Skills are installed by placing their folder where your agent loads skills.
The download comes from github.com/AbdoBasyioni/business-analysis-skill itself, not from our server, so what you get is exactly what its author published.
Install instructions come from the README
README
synced Oct 17, 2026🎯 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 — ده بيوصلها لناس تانية محتاجاها.