كيف تستخدم مهارات AI من المكتبة في Claude وChatGPT وGemini
أين تضع ملف SKILL.md في Claude وChatGPT وGemini: رفع المهارة، أو لصقها في تعليمات مشروع أو Gem، مع الملحق العربي وقواعد حماية بيانات عملائك.
مهارة ذكاء اصطناعي مفتوحة المصدر تحلل مكالمات البيع ومحادثات واتساب لتعرف لماذا تكسب صفقاتك أو تخسرها، بالعدد والاقتباس الحرفي، مع إضافة عربية.
هذه المهارة تجعل المساعد يقرأ نصوص مكالمات البيع ويستخرج لماذا تكسب صفقاتك ولماذا تخسرها، وكذلك لماذا يجدد العملاء أو يغادرون. يصنّف كل مكالمة (كسب، أو خسارة، أو تجديد، أو مغادرة)، ويسحب اقتباسات حرفية منسوبة لقائلها في ستة محاور: المنتج، والرسالة التسويقية، وأداء فريق البيع، والسعر، والمنافسة، وظرف العميل. ثم يجمع الأنماط ويعدّها بصيغة «3 من 5 صفقات خاسرة»، ويضع لكل نمط مستوى ثقة، ويفصل مشكلات المنتج عن مشكلات التنفيذ البيعي.
استخدمها بعد ربع سنة أو موسم بيع، عندما يكون لديك عدد معقول من الصفقات المغلقة في الاتجاهين. قوتها في قواعدها: لا نمط بلا اقتباس، والذكر الواحد «غير مؤكد»، ونقول «مرتبط بـ» لا «تسبّب في». وحدودها في بياناتك: في شركات عربية كثيرة تُدار الصفقة على واتساب وفي مكالمات غير مسجلة، فستعمل المهارة على ملاحظات المندوبين ورسائل العملاء، وهذا دليل أضعف يجب أن يُكتب بجانب كل نتيجة. النص الأصلي من إعداد Genesys Growth Ltd بترخيص MIT، وننشره كما هو مع إضافة عربية.
حمّل ملف SKILL.md من القالب الأول، وأضف الإضافة العربية (القالب الثاني) في آخره أو في تعليمات المشروع. خطوات كل أداة في دليل إعداد المهارات.
المهارة تحيل تفاصيلها إلى سبعة ملفات في مجلد references/: خطوات المراحل الثلاث (process.md)، وقالب التقرير وأسئلة المتابعة (output-format.md)، وقائمة الجودة ومثال جيد (quality.md)، وبروتوكول «التحديث التلقائي» (auto-update.md)، وعبارات الإشارة في كل محور (extraction-patterns.md)، وقالب قديم، ومثالًا محلولًا على 5 مكالمات. ملفات references/ لم تعد في المستودع العام منذ 31 يوليو 2026 (نقلها المؤلف إلى مادة مدفوعة)، لذلك لا نربطها هنا؛ بدونها تعمل المهارة بما في SKILL.md وتسألك عن التفاصيل الناقصة.
المهارة تبدأ بتوحيد شكل النصوص (من يتكلم، ومتى) وإخفاء البيانات الشخصية. قبل ذلك اكتب فهرسًا بسيطًا، لأن نوع المصدر يغيّر قوة الدليل:
| رقم الصفقة | العميل (رمز) | النتيجة | نوع المصدر | المنافس المذكور | المرحلة وحجم الصفقة |
|---|---|---|---|---|---|
| 01 | ع-01 | خسارة | تسجيل مفرغ | [الاسم] | عرض سعر، 60,000 جنيه |
| 02 | ع-02 | كسب | ملاحظات المندوب | لا يوجد | تجربة، 24,000 جنيه |
المهارة فيها ثلاثة أنماط: تحليل مكالمة واحدة بعمق، وتحليل مجمّع لعدة مكالمات (من 3 إلى 20)، ومصفوفة مقارنة بين الكسب والخسارة أو بين التجديد والمغادرة.
مثال طلب: «حلّل الـ 12 صفقة دي win/loss. الفهرس فوق والنصوص تحت. عايز مصفوفة مقارنة بين الكسب والخسارة في المحاور الستة، وكل نمط بالعدد والاقتباس».
عرّف نسبة الكسب قبل أن تبدأ، ليقيس الجميع بالطريقة نفسها: الصفقات المكسوبة ÷ الصفقات المغلقة بكسب أو خسارة في الفترة نفسها. الصفقات التي ما زالت مفتوحة لا تدخل في المقام.
قواعد المهارة نفسها هي قائمة المراجعة:
ملف auto-update.md يصف مهارة «تتعلم» من استخدامك: تلتقط إشارات مثل «هذا النمط خطأ» أو تعديلاتك الكثيرة على التقرير أو موافقتك السريعة، وتحفظ التقرير المعتمد كمثال في مجلد examples/، وتقترح تعديل نص المهارة إذا تكررت الملاحظة نفسها 3 مرات. وقسم «Data integration» في المهارة يطلب سحب النصوص «دائمًا» من أدوات تسجيل الاجتماعات (Granola وGong وFireflies وغيرها) ومن محادثات Slack.
هذا يحتاج أمرين:
في محادثة عادية لا يُحفظ شيء بين محادثة وأخرى، ولا يصل المساعد إلى تسجيلاتك. المهارة نفسها تذكر البديل: النصوص أو التسجيلات التي تعطيها أنت. لذلك تطلب الإضافة العربية من المساعد أن يطلب منك النصوص بدل أن يفترض وجودها، وأن يكتب في آخر التقرير «سجل ملاحظات» قصيرًا تحفظه أنت، وألا يقول «حفظت» أو «تعلمت» ما لم تر الملف بنفسك.
مثال افتراضي للتعليم — ليس عميلًا حقيقيًا، والأرقام مفترضة لشرح الطريقة
شركة افتراضية في القاهرة تبيع نظام نقاط بيع (POS) للمطاعم والكافيهات باشتراك سنوي. في ربع واحد أُغلقت 12 صفقة: 7 كسب و5 خسارة، فنسبة الكسب 7 ÷ 12 = 58%. ست صفقات لها تسجيل مفرغ، وثلاث لها محادثة واتساب، وثلاث لها ملاحظات مندوب فقط. الطلب:
«حلّل الـ 12 صفقة دي win/loss. الفهرس فوق فيه نوع المصدر لكل صفقة. عايز مصفوفة مقارنة كسب وخسارة في المحاور الستة، باللهجة المصرية في الاقتباسات زي ما هي».
الإجابة الجيدة يجب أن تحتوي على:
علامات إجابة سيئة: «معظم العملاء يرون السعر مرتفعًا» من مكالمة واحدة، أو نسب مئوية بلا أعداد، أو كلام المندوب منقول كأنه كلام العميل، أو «السعر تسبّب في الخسارة».
النص بالإنجليزية عن قصد: النماذج تتبع التعليمات الأصلية بدقة أكبر، والإضافة العربية (القالب التالي) تتولى اللغة والسوق. لم نعدّل حرفًا من نص المؤلف، وفي آخر الملف نص ترخيص MIT كاملًا داخل تعليق. ملفات references/ لم تعد في المستودع العام منذ 31 يوليو 2026 (نقلها المؤلف إلى مادة مدفوعة)، لذلك لا نربطها هنا؛ بدونها تعمل المهارة بما في SKILL.md وتسألك عن التفاصيل الناقصة.
--- name: win-loss-analysis version: "2.0" author: genesys-growth last_updated: 2026-06-08 description: > Win/loss analysis for B2B SaaS. Analyzes sales call transcripts across 6 dimensions (product, messaging, GTM/sales, pricing, competition, customer context) to extract why deals are won, lost, retained, or churned. Produces aggregate patterns with verbatim-quote evidence, frequency counts, confidence levels, and strategic recommendations. Includes process steps, output template, quality checklist, extraction patterns, and a worked 5-transcript example. --- <!-- COMMUNITY SKILL — included under its original MIT license. Source: https://github.com/matteotitta/genesys-skills by Matteo Titta (MIT). License text: ../LICENSE-genesys-skills.txt Curated into Growth Marketing OS by Mahmoud Omar (mahmoudomar.com) — this file is NOT original work by the repo author; see /skills/community/README.md. --> # Win/loss analysis Analyze sales call transcripts to extract actionable insights on why deals are won, lost, retained, or churned. Cross-reference findings with ICP, firmographics, and competitive context to produce strategic recommendations. **Knowledge type:** `win-loss-analysis` **Maturity on first run:** emergent → validated after team review --- ## Claude Code triggers **Invoke when user says:** - "Win/loss analysis" - "Analyze sales calls" - "Why did we win/lose" - "Churn analysis" - "Retention analysis" - "Sales call insights" - "Deal outcome patterns" - "Customer feedback synthesis" - "Analyze these transcripts" - "What patterns in our sales calls" **Do NOT invoke when:** - User wants general transcript analysis → use a generic transcript skill - User wants competitor research → use `competitor-research` - User wants a single customer interview write-up → use a transcript skill - User wants sales enablement assets → use a sales-enablement skill --- ## Input requirements ### Required | Input | Description | Source | |-------|-------------|--------| | **Transcripts** | Sales call transcripts with customer name and outcome | User provides | | **Outcome** | Win/Loss/Retention/Churn for each call | User specifies or infer | ### Optional (improve quality) | Input | How it helps | |-------|--------------| | Website URL per customer | Firmographics cross-reference | | Product/ICP document | Define in-scope product capabilities | | Market/GTM document | Positioning and competitive landscape | | Sales notes column | Additional context (stage, deal size) | | Competitor names | Pre-identify competitors to watch for | ### Validation Before proceeding: at least one transcript provided; outcome known or inferable from transcript; customer name identifiable. If inputs are missing: ask the user for transcripts. Clarify if outcome should be inferred from transcript signals. ### Transcript intake — normalize, redact, bind to evidence Transcripts arrive in many shapes (Gong, Fireflies, Otter, Grain, Zoom/Avoma VTT, SRT, recorder JSON, or plain pasted text). Before Phase 1, normalize whatever you're handed into one shape — speaker-attributed turns with timestamps where present. Two rules apply to every transcript before analysis: - **Redact PII first.** Mask end-client names, emails, and account numbers before processing; keep roles, company, and deal context. (Load-bearing for regulated industries.) - **Bind every claim to evidence.** Every extracted pattern cites a verbatim quote plus the speaker; normalized, speaker-attributed turns make that attribution reliable. --- ## Process The analysis runs in 3 phases. Read [`references/process.md`](./references/process.md) for the full step-by-step (4 transcript-processing steps, 4 aggregation steps, 4 synthesis steps, plus per-phase checkpoints and the process flowchart). Phase summary: 1. **Transcript processing** — classify outcome, identify speakers, extract customer context, pull verbatim quotes for the 6 dimensions 2. **Pattern aggregation** — group by outcome, count frequency, rank patterns (3+ mentions), cross-reference by ICP/competitor/persona 3. **Insight synthesis** — state pattern, provide evidence with frequency + confidence, identify opportunity, generate executive summary --- ## Core frameworks ### Analysis modes | Mode | When to use | Output | |------|-------------|--------| | **Single call** | Deep analysis of one transcript | Full insight extraction per dimension | | **Batch analysis** | Multiple transcripts (3-20 calls) | Aggregated patterns with frequency counts | | **Comparison matrix** | Win vs. loss OR retention vs. churn | Side-by-side pattern comparison | **Default to batch analysis mode** when multiple transcripts are provided. ### 6 analysis dimensions | # | Dimension | Win signals | Loss signals | |---|-----------|-------------|--------------| | 1 | **Product** | "Exactly what we need," feature praised | "Missing [feature]," "Doesn't do [X]" | | 2 | **Messaging** | "Now I understand why this matters" | "What does it actually do?" | | 3 | **GTM/Sales** | "You really understand our problem" | "Demo didn't address our needs" | | 4 | **Pricing** | "Fair price," "good value" | "Too expensive," "over budget" | | 5 | **Competition** | "Chose you over [competitor]" | "Going with [competitor]" | | 6 | **Customer context** | "Need this now," deadline-driven | "No rush," "maybe next year" | ### Confidence scoring | Level | Definition | When to apply | |-------|------------|---------------| | **High** | 3+ calls with consistent pattern | Clear recurring theme | | **Medium** | 2 calls or inferred from strong signals | Emerging pattern | | **Low** | Single mention or indirect reference | Possible outlier | ### Outcome classification | Outcome | Definition | Key signals | |---------|------------|-------------| | **Win** | Deal closed, contract signed | "We're moving forward," pricing confirmed | | **Loss** | Deal lost to competitor or no-decision | "Going with [competitor]," "Not right now" | | **Retention** | Existing customer renewing/expanding | Renewal discussion, expansion | | **Churn** | Existing customer leaving/reducing | Cancellation, "not getting value" | --- ## Output Produce a single win/loss report markdown file. Template + iteration prompts library: [`references/output-format.md`](./references/output-format.md). Pre-delivery quality checklist + worked example + anti-examples: [`references/quality.md`](./references/quality.md). Auto-update protocol (feedback signals, pattern detection, skill-update template): [`references/auto-update.md`](./references/auto-update.md). --- ## Anti-hallucination guardrails 1. **Quote verbatim.** All insights must trace to specific transcript quotes. 2. **Never invent patterns.** If a pattern appears in only one call, label it "Single mention — pattern unconfirmed." 3. **State frequency.** Always note how many calls support each finding (e.g., "4 of 7 calls"). 4. **Acknowledge gaps.** If a dimension has no data, mark "Not discussed in transcripts." 5. **Distinguish roles.** Tag who said what — prospect vs. sales rep vs. champion. --- ## Gotchas - **Correlation as causation.** Reports "deals with longer sales cycles were lost" as if cycle length caused the loss → always distinguish patterns from causes. Use "associated with" not "caused by". - **Small sample bias.** Draws conclusions from 2-3 deals instead of waiting for sufficient data → flag sample size prominently. Minimum 5 wins and 5 losses for reliable patterns. - **Missing verbatim quotes.** Summarizes what buyers said instead of extracting exact quotes → verbatim quotes are the primary deliverable. Summaries are secondary. - **Single-dimension analysis.** Only looks at win/loss by competitor, missing dimensions like deal size, ICP segment, or sales cycle stage → cross-tabulate across at least 3 dimensions. - **Conflates product feedback with sales insights.** Mixes "they wanted feature X" with "they didn't trust our team" → separate product gaps from sales execution issues. They feed into different downstream work. --- ## Integration with other skills | Skill | Relationship | Usage | |-------|--------------|-------| | **transcript analysis** | Related | Use for general transcripts, not sales calls | | **sales enablement** | Downstream | Feed insights into battlecards and objection handlers | | **product messaging** | Downstream | Update messaging based on win patterns | | **competitor research** | Related | Cross-reference competitor mentions | --- ## Reference files | File | Purpose | |------|---------| | [`references/process.md`](./references/process.md) | Full 3-phase step-by-step + flowchart | | [`references/output-format.md`](./references/output-format.md) | Win/loss report template + iteration prompts | | [`references/quality.md`](./references/quality.md) | Pre-delivery checklist + worked example + anti-examples | | [`references/auto-update.md`](./references/auto-update.md) | Feedback signal detection + pattern rules | | [`references/extraction-patterns.md`](./references/extraction-patterns.md) | Signal patterns for each dimension | | [`references/output-template.md`](./references/output-template.md) | Legacy report template (kept for reference) | | [`references/example-analysis.md`](./references/example-analysis.md) | Worked example with 5 transcripts | --- ## Data integration **Level:** 0 — Context (heavy pulls) If you run win/loss inside a connected environment, pull transcripts and deal context fresh: | Source | What to pull | When | |--------|-------------|------| | **Meeting recorder** (Granola, Gong, Fireflies, etc.) | Sales call transcripts and deal discussions | Always | | **Team chat** (Slack, etc.) | Deal discussion threads and competitive intel | Always | **Fallback (no integrations):** user-provided call transcripts or recordings; manual deal review notes. --- ## Changelog | Version | Date | Changes | |---------|------|---------| | 2.0 | 2026-01-16 | Refactored to v2.0 template: structured phases, evidence-ready insights, iteration prompts, auto-update rules | | 1.0 | Previous | Initial skill creation with 6 dimensions | <!-- MIT License Copyright (c) 2026 Genesys Growth Ltd Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. -->
الصقها في آخر SKILL.md أو في تعليمات المشروع، واملأ الأقواس. عند التعارض تغلب هذه القواعد في اللغة والسوق والأمانة فقط.
## Arabic add-on — إضافة عربية (Growth Hack Academy) اتبع المهارة أعلاه كما هي، مع القواعد التالية. ### اللغة - اكتب التقرير بالعربية الفصحى المبسطة. - انقل الاقتباسات بلهجتها كما وردت في النص: [مصرية / سعودية / خليجية / غيرها]. لا تصحح لغتها ولا تترجمها إلى الفصحى. - اترك أسماء المنتجات والمزايا والمنافسين كما هي. ### السوق والمصادر - السوق: [مصر / السعودية / الإمارات / ...]. العملة: [جنيه / ريال / درهم]. - الصفقات عندنا تأتي من ثلاثة أنواع مصادر، وعاملها بشكل مختلف: - تسجيل مفرغ أو محادثة واتساب: كلام العميل بنصه، يصلح للاقتباس. - ملاحظات المندوب: رواية المندوب، لا تُنقل كاقتباس للعميل. علّمها «رواية مندوب». - اذكر في رأس التقرير عدد الصفقات من كل نوع مصدر. ### البيانات والأدوات - لا تفترض أنك تصل إلى أدوات التسجيل أو Slack أو أي نظام. إن لم يكن لديك موصل ظاهر، اطلب مني النصوص. - إن وجدت في النص أسماء أشخاص أو أرقام هواتف أو بريدًا، استبدلها برموز قبل التحليل، ونبهني. - ملفات references/ إن لم تكن متاحة لك، أكمل من نص المهارة ولا تتظاهر بقراءتها. - لا تقل إنك حفظت مثالًا أو «تعلمت» من ملاحظاتي إلا إذا فعلت ذلك بأداة ظاهرة. في آخر التقرير اكتب «سجل ملاحظات» من 3 أسطر: ما ينقص، وما يحتاج تأكيدًا، وماذا نجمع في الفترة القادمة. ### الأمانة - قبل التحليل، اسألني عن أي بيانات ناقصة (النتيجة، نوع المصدر، المنافس). لا تخترعها. - لا تخترع اقتباسات أو أرقامًا أو أنماطًا أو أسماء عملاء أو مصادر. كل نمط بعدد صريح «X من Y». - افصل في كل محور بين «الدليل» (اقتباس ومن قاله ورقم الصفقة) و«الاستنتاج المحتمل» (تحليلك). لا تقدم الاستنتاج كسبب مؤكد. - إن كانت الصفقات أقل من 5 كسب و5 خسارة، ابدأ التقرير بهذا التنبيه، ولا تستخدم مستوى ثقة «High».
بعد تثبيت المهارة والإضافة، ابدأ بأحد هذه الطلبات واستبدل ما بين الأقواس.
حلّل الـ [عدد] صفقة دي win/loss. الفهرس فوق فيه النتيجة ونوع المصدر لكل صفقة، والنصوص تحت. اعمل مصفوفة مقارنة كسب وخسارة في المحاور الستة. دي مكالمة واحدة مع عميل خسرناه لصالح [المنافس]: [لصق]. حللها بعمق في المحاور الستة، وفرّق بين كلام العميل وكلام المندوب. دي محادثات واتساب مع [عدد] عملاء مجددوش الاشتراك: [لصق بعد حذف الأرقام]. استخرج أسباب المغادرة بالعدد والاقتباس، وقولي إيه اللي محتاج مكالمة متابعة نتأكد منه. الإدارة شايفة إننا بنخسر بسبب السعر. راجع التقرير ده [لصق]: كام صفقة خاسرة ذكرت السعر فعلًا؟ وكام مرة كان في سبب تاني جنبه؟ من التقرير ده [لصق]، طلّع لي المدخلات اللي محتاجها لبطاقة منافسة ضد [المنافس]: متى نكسب، متى نخسر، وأهم 3 اعتراضات بالاقتباس.
المهارة تساعدك إذا تحققت هذه الأمور:
لاحظت خطأ أو رقمًا تغيّر؟ أرسل لنا التصحيح.