> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

> حِزم تعليمات قابلة لإعادة الاستخدام في ClickHouse Agents

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>Beta</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                ميزة Beta. 
                <u>
                    <a href="/docs/docs/beta-and-experimental-features#beta-features">
                        مزيد من المعلومات.
                    </a>
                </u>
            </span>
        </div>;
};

<BetaBadge />

المهارة هي حزمة تعليمات قابلة لإعادة الاستخدام، ويمكن للوكيل تطبيقها عند الحاجة. استخدم المهارات للإجراءات المتكررة عبر الوكلاء — مثل دليل أسلوب للعلامة التجارية، أو قائمة مراجعة لمراجعة الشيفرة، أو دليل تشغيل لسير عمل محدد — بدلًا من تكرار هذه التعليمات في التوجيه النظامي لكل وكيل.

<div id="anatomy-of-a-skill">
  ## بنية مهارة
</div>

المهارة عبارة عن ملف Markdown يتضمن ترويسة frontmatter صغيرة:

```markdown theme={null}
---
name: revenue-report
description: Generates the weekly revenue report using our standard segments
always-apply: false
user-invocable: true
---

When asked to generate a revenue report:
1. Filter to the requested period.
2. Apply the standard MRR formula:
     SUM(CASE
       WHEN billing_cycle = 'monthly' THEN amount
       WHEN billing_cycle = 'yearly'  THEN amount / 12
       ELSE 0
     END)
3. Break down by segment: Enterprise, Mid-Market, SMB.
4. Render the result as a Markdown table.
```

أهم حقول frontmatter:

* **`name`** - معرّف بصيغة kebab-case.
* **`description`** - وصف موجز يستخدمه النموذج لتحديد متى تكون هذه المهارة مناسبة. اعتبره أهم حقل. اكتبْه بدقة؛ لأن الأوصاف المبهمة تؤدي إلى استدعاء المهارة غير المناسبة.
* **`always-apply`** - عندما تكون القيمة `true`، تُضمَّن المهارة تلقائيًا في كل دور بدلًا من اختيارها. استخدمه بحذر؛ فالمهارات التي تستخدم `always-apply` تستهلك السياق مع كل رسالة.
* **`user-invocable`** - عندما تكون القيمة `true` (وهي القيمة الافتراضية)، تظهر المهارة في النافذة المنبثقة الخاصة بـ `$` للاختيار اليدوي.

يمكنك تجميع الملفات الداعمة إلى جانب المهارة — مثل المستندات المرجعية، والاستعلامات النموذجية، والبرامج النصية الصغيرة — وذلك برفع ملف `.zip` يحتوي على `SKILL.md` وموارده.

<div id="use-a-skill">
  ## استخدام مهارة
</div>

هناك ثلاث طرق يستعين بها الوكيل بمهارة ضمن المحادثة:

* **استدعاء المستخدم** - اضغط `$` في حقل الإدخال واختر المهارة من النافذة المنبثقة. ويُدرَج محتوى المهارة مسبقًا في الدور التالي.
* **الاختيار التلقائي للنموذج** - استنادًا إلى `description` الخاصة بالمهارة، يقرّر الوكيل من تلقاء نفسه متى يطبّقها.
* **التطبيق دائمًا** - يُدرَج محتواها مسبقًا في كل دور للمهارات المُعدّة بهذه الطريقة.

<div id="manage-skills">
  ## إدارة المهارات
</div>

تتيح لك لوحة المهارات في وحدة تحكم Cloud إنشاء مهارات مباشرةً، ورفع ملفات `.md` أو `.zip`، وإدارة المهارات المفعّلة لحسابك. تكون المهارات التي تملكها مفعّلة افتراضيًا؛ عطّل أيًّا منها لإزالته من النافذة المنبثقة ومن كتالوج النموذج دون حذفه.

يمكن مشاركة المهارات مع مستخدمين آخرين (راجع [المشاركة وإمكانية الوصول](/docs/ar/products/cloud/features/ai-ml/agents/sharing-and-access)).

<div id="skills-vs-instructions">
  ## المهارات مقابل التعليمات
</div>

* **تعليمات الوكيل** تحدد ماهية الوكيل وكيفية سلوكه بشكل عام. وهي مفعّلة دائمًا لهذا الوكيل.
* **المهارات** تكون ظرفية — تُطبَّق عند الحاجة، وتقتصر على مسارات عمل محددة.

الجأ إلى مهارة عندما تتكرر المجموعة نفسها من التعليمات خطوة بخطوة عبر عدة وكلاء، أو عندما تريد تفعيلها فقط لطلبات مستخدم محددة بدلًا من كل تفاعل.