# المهارات (Skills) (/ar/docs/verdent-manager/core-features/skills)

> وسّع قدرات Verdent عبر حزم معرفية قابلة لإعادة الاستخدام لسير العمل المتخصص والخبرة المتخصصة في المجال



Verdent **المهارات (Skills)** هي حزم معرفية قابلة لإعادة الاستخدام توسّع خبرة الوكيل. تحتوي كل مهارة على prompts مخصصة للمجال، وسكربتات، ومراجع، وأفضل الممارسات. ما عليك سوى استدعاء المهارة باسمها، ليقوم الوكيل بتحميل السياق المقابل واتباع سير العمل المحدد مسبقًا.

***

## ما هي المهارات؟ [#ما-هي-المهارات]

### المفهوم الأساسي [#المفهوم-الأساسي]

**المهارة** هي حزمة معرفية منظمة محفوظة في مجلد. تحتوي كل مهارة على ملف `SKILL.md` يحدد اسمها ووصفها والـ prompt التفصيلي الخاص بها. عندما تستدعي مهارة في المحادثة، يقرأ Verdent هذا الملف ويحقن محتواه في سياق الوكيل.

### كيف تختلف المهارات عن الوكلاء الفرعيين وعن MCP [#كيف-تختلف-المهارات-عن-الوكلاء-الفرعيين-وعن-mcp]

| البُعد              | المهارات                                         | الوكلاء الفرعيون                         | MCP                                                           |
| ------------------- | ------------------------------------------------ | ---------------------------------------- | ------------------------------------------------------------- |
| **آلية التشغيل**    | استدعاء يدوي عبر `@skill` أو الإشارة             | يُنشأ تلقائيًا من قِبل الوكيل الرئيسي    | يُستدعى تلقائيًا أو يُطلب بشكل صريح                           |
| **التنفيذ**         | يوسّع سياق المحادثة الرئيسية                     | يعمل كمهمة فرعية مستقلة بسياق منفصل      | يستدعي أدوات خارجية عبر JSON-RPC 2.0                          |
| **الغرض**           | توجيه خاص بالمجال (مثل "كيفية كتابة الاختبارات") | عمليات مستقلة (مثل "تشغيل مراجعة الكود") | الوصول إلى بيانات/أدوات خارجية (مثل استعلامات قاعدة البيانات) |
| **دورة الحياة**     | حقن سياق لمرة واحدة                              | ينهي المهمة الفرعية ثم يعيد النتائج      | عملية خادم مستمرة طوال الجلسة                                 |
| **التنفيذ البرمجي** | ملفات Markdown + سكربتات اختيارية                | منطق مدمج في الوكيل                      | عمليات خادم قابلة للتنفيذ                                     |

باختصار: **المهارات توفر المعرفة والتوجيه لسير العمل**، و**الوكلاء الفرعيون ينفذون مهامًا مستقلة**، و**MCP يربط الأدوات ومصادر البيانات الخارجية**.

***

## كيفية استخدام المهارات [#كيفية-استخدام-المهارات]

### استدعاء مهارة [#استدعاء-مهارة]

يمكنك استدعاء مهارة بطريقتين:

**1. الإشارة إلى اسم المهارة في المحادثة**

```
Use the skill-creator skill to help me create a new Skill
```

**2. استخدام صيغة الإشارة بـ @**

```
@skill-creator help me create a Skill for API documentation generation
```

عندما يتم تشغيل مهارة:

1. يستدعي الوكيل أداة `skill` لقراءة ملف `SKILL.md` الخاص بالمهارة
2. يُحقن محتوى الملف في سياق المحادثة الحالية
3. يستمر الوكيل في العمل وفقًا لتوجيه المهارة

### استعراض المهارات المتاحة [#استعراض-المهارات-المتاحة]

يمكنك الوصول إلى لوحة المهارات من خلال الإعدادات:

1. افتح قائمة **الإعدادات**
2. حدد تبويب **المهارات**
3. استعرض المهارات المثبَّتة والمهارات المتاحة في متجر المهارات

يمكنك أيضًا كتابة `@` في مربع الإدخال لتشغيل الإكمال التلقائي واختيار مهارة متاحة بسرعة.

***

## المهارات المدمجة [#المهارات-المدمجة]

يأتي Verdent مع مجموعة من المهارات المدمجة التي تغطي سير العمل الشائع:

| المهارة             | الوصف                                                                               |
| ------------------- | ----------------------------------------------------------------------------------- |
| **docx**            | قراءة أو إنشاء أو تحرير مستندات Word (`.docx`) مع فحوصات بصرية أمينة للتنسيق        |
| **find-skills**     | اكتشاف وتثبيت المهارات — تُستخدم عند طرح سؤال "كيف أفعل X؟" أو البحث عن قدرات جديدة |
| **frontend-design** | إنشاء واجهات أمامية مميزة بجودة إنتاجية عالية                                       |
| **pdf**             | قراءة أو إنشاء أو مراجعة ملفات PDF مع عرض بصري واستخراج محتوى                       |
| **pptx**            | قراءة أو إنشاء أو تحرير عروض تقديمية PowerPoint (`.pptx`)                           |
| **skill-creator**   | سير عمل موجَّه لإنشاء مهارات مخصصة وتطويرها تدريجيًا                                |
| **xlsx**            | قراءة وتحليل وتصور جداول بيانات Excel وتحريرها بشكل ذكي                             |

<Tip>
  تتوفر مهارات إضافية في **متجر المهارات**. افتح **الإعدادات ← المهارات ← المتجر** لاستعراض وتثبيت مهارات إضافية.
</Tip>

***

## إنشاء مهارات مخصصة [#إنشاء-مهارات-مخصصة]

يمكنك إنشاء مهارات مخصصة لتضمين خبرة فريقك في مجال معين أو سير عمل خاص بمشروعك.

### بنية دليل المهارة [#بنية-دليل-المهارة]

يبدو مجلد المهارة القياسي كما يلي:

```
my-custom-skill/
├── SKILL.md              # Required: Skill definition file
├── agents/
│   └── verdent.yaml      # Optional: UI configuration (icons, display name)
├── scripts/              # Optional: helper scripts
└── references/           # Optional: reference docs or examples
```

### تنسيق SKILL.md [#تنسيق-skillmd]

`SKILL.md` هو ملف المهارة الأساسي، ويحتوي على YAML frontmatter وجسم Markdown:

```markdown
---
name: my-custom-skill
description: A concise description shown in the Skill list
metadata:
  version: "1.0.0"
  author: "Your Name"
  license: "MIT"
---

# Detailed Instructions

This is the detailed prompt content the Agent reads.

## Workflow

1. Step one
2. Step two
3. ...

## Best Practices

- Practice suggestion 1
- Practice suggestion 2
```

**متطلبات حقول Frontmatter:**

* `name` (مطلوب): يجب أن يتطابق مع اسم المجلد. يُسمح فقط بالحروف الصغيرة والأرقام والشرطات (`a-z0-9-`). الطول: من 1 إلى 64 حرفًا. بلا شرطات متتالية أو شرطات في البداية/النهاية.
* `description` (مطلوب): وصف مختصر، بحد أقصى 1024 حرفًا.
* `metadata` (اختياري): الإصدار، المؤلف، الترخيص، ومعلومات وصفية أخرى.

### تثبيت المهارات المخصصة [#تثبيت-المهارات-المخصصة]

**الطريقة 1: الاستيراد عبر الإعدادات**

1. افتح **الإعدادات ← المهارات**
2. حدد **استيراد مهارة**
3. اختر مجلد المهارة (أو أرشيف `.zip` / `.skill`)
4. يتحقق Verdent من صحة `SKILL.md` ويثبّته في `~/.verdent/skills/`

**الطريقة 2: النسخ اليدوي**

```bash
cp -r my-custom-skill ~/.verdent/skills/
```

تصبح المهارة متاحة بعد إعادة تشغيل Verdent أو تحديث قائمة المهارات.

**الطريقة 3: مهارة على مستوى المشروع**

ضع المهارة داخل دليل مشروعك:

```bash
cp -r my-custom-skill /path/to/your/project/.verdent/skills/
```

تكون المهارات على مستوى المشروع مرئية فقط داخل ذلك المشروع، وتأخذ الأولوية على المهارات العامة التي تحمل الاسم نفسه.

***

## نطاقات المهارات [#نطاقات-المهارات]

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

| المستوى               | الموقع                       | الظهور                        |
| --------------------- | ---------------------------- | ----------------------------- |
| **عام (Global)**      | `~/.verdent/skills/`         | جميع المشاريع ومساحات العمل   |
| **المشروع (Project)** | `<project>/.verdent/skills/` | مساحات عمل المشروع الحالي فقط |

**قواعد الأولوية:**

عند وجود مهارات بالاسم نفسه في نطاقات متعددة:

* المشروع يتفوق على العام

***

## متجر المهارات [#متجر-المهارات]

يوفر Verdent **متجر مهارات** لاستعراض وتثبيت المهارات المجتمعية والرسمية.

### استعراض متجر المهارات [#استعراض-متجر-المهارات]

1. افتح **الإعدادات ← المهارات**
2. انتقل إلى تبويب **المتجر**
3. استعرض المهارات المتاحة أو استخدم مربع البحث

### التثبيت من المتجر [#التثبيت-من-المتجر]

1. اعثر على المهارة المطلوبة في المتجر
2. حدد **تثبيت**
3. يتم تنزيل المهارة تلقائيًا وتثبيتها في `~/.verdent/skills/`

**التحقق الأمني:**

تخضع المهارات المثبَّتة من المتجر لتحقق باستخدام دالة التجزئة SHA256 لضمان سلامة الملفات وأمانها.

***

## أمثلة عملية [#أمثلة-عملية]

### مثال 1: إنشاء مهارة جديدة باستخدام `skill-creator` [#مثال-1-إنشاء-مهارة-جديدة-باستخدام-skill-creator]

```
@skill-creator help me create a Skill for guiding the team on writing Go unit tests
```

سيقوم الوكيل بما يلي:

1. قراءة محتوى مهارة `skill-creator`
2. توجيهك خلال تعبئة اسم المهارة ووصفها والـ prompt الأساسي
3. توليد ملف `SKILL.md` قياسي
4. اقتراح مسار التثبيت وخطوات التحقق

### مثال 2: تحليل البيانات باستخدام `spreadsheet` [#مثال-2-تحليل-البيانات-باستخدام-spreadsheet]

```
@spreadsheet read sales-2025.xlsx from the project root, analyze Q1 sales trends, and generate a chart
```

سيقوم الوكيل بما يلي:

1. تحميل مهارة `spreadsheet`
2. استخدام `pandas` و `openpyxl` لقراءة ملف Excel
3. تحليل البيانات وتوليد تصورات مرئية
4. حفظ النتائج أو عرضها في المحادثة

### مثال 3: إصلاح CI باستخدام `gh-fix-ci` [#مثال-3-إصلاح-ci-باستخدام-gh-fix-ci]

```
@gh-fix-ci my PR #123 GitHub Actions tests are failing, help me debug
```

سيقوم الوكيل بما يلي:

1. استخدام واجهة سطر الأوامر `gh` لاسترجاع سجلات CI لطلب السحب رقم 123
2. تحليل سبب الفشل (مثل أخطاء حالات الاختبار، مشكلات التبعيات)
3. اقتراح إصلاح
4. بعد موافقتك، تعديل الكود ودفع الإصلاح

***

## الأسئلة الشائعة [#الأسئلة-الشائعة]

<Accordion title="هل تستهلك المهارات أرصدة؟">
  عند استدعاء مهارة، يقرأ الوكيل ملف `SKILL.md`، الذي يُحسب ضمن استخدام الرموز (tokens) وبالتالي يستهلك أرصدة. لكن المهارة نفسها لا تُجري استدعاءات إضافية لـ API.
</Accordion>

<Accordion title="هل يمكنني مشاركة مهارات مخصصة عبر مشاريع متعددة؟">
  نعم. ثبّت المهارة في `~/.verdent/skills/` (النطاق العام) وستكون متاحة في جميع المشاريع.
</Accordion>

<Accordion title="كيف أحذف مهارة لا أحتاجها بعد الآن؟">
  في **الإعدادات ← المهارات**، انقر بزر الفأرة الأيمن على المهارة وحدد **حذف**. المهارات المدمجة المعلَّمة بـ `undeletable` لا يمكن حذفها وستُعاد تثبيتها عند بدء التشغيل التالي.
</Accordion>

<Accordion title="هل يمكنني استيراد مهارات من Cursor أو Claude Desktop أو Codex؟">
  نعم. يكتشف Verdent تلقائيًا المهارات في `~/.cursor/skills` و `~/.claude/skills` و `~/.codex/skills`، ويطلب منك استيرادها. حدد **استيراد من مصادر خارجية** في **الإعدادات ← المهارات**.
</Accordion>

<Accordion title="ما الفرق بين المهارة وقاعدة المشروع؟">
  * **قاعدة المشروع**: تعليمات نشطة دائمًا تُحقن تلقائيًا في كل محادثة
  * **المهارة**: حزم معرفية عند الطلب تُحقن فقط عند استدعائها

  استخدم القواعد لمعايير الكود العامة؛ واستخدم المهارات لسير العمل الخاص بمجال معين.
</Accordion>

<Accordion title="كيف أحدّث مهارة مثبَّتة؟">
  يتم فحص المهارات المثبَّتة من متجر المهارات تلقائيًا في الخلفية للتحقق من وجود تحديثات. المهارات المثبَّتة يدويًا تحتاج إلى إعادة الاستيراد (مع استبدال النسخة القديمة) للتحديث.
</Accordion>

***

## استخدام متقدم [#استخدام-متقدم]

### تضمين سكربتات في المهارات [#تضمين-سكربتات-في-المهارات]

أضف دليل `scripts/` إلى مهارتك وأشِر إلى السكربتات في `SKILL.md`:

```markdown
## Data Processing Script

Run the following command to process data:

\`\`\`bash
python scripts/process_data.py --input data.csv --output results.json
\`\`\`
```

يقرأ الوكيل هذا التوجيه وينفذ السكربت عند الحاجة.

### الإشارة إلى الوثائق [#الإشارة-إلى-الوثائق]

خزّن وثائق API أو المواصفات أو نماذج الكود في دليل `references/` واربطها في `SKILL.md`:

```markdown
## Reference Documentation

See [references/api-spec.md](references/api-spec.md) for the detailed API specification.
```

يمكن للوكيل قراءة هذه ملفات المراجع بناءً على توجيهات المهارة.

***

## أفضل الممارسات [#أفضل-الممارسات]

<Tip>
  **حافظ على تركيز المهارات.** يجب أن تستهدف كل مهارة مجالًا أو سير عمل واحدًا. تجنب إنشاء مهارات "تفعل كل شيء" — بل قسّمها إلى مهارات أصغر ومتخصصة.
</Tip>

<Tip>
  **استخدم تسميات واضحة.** يجب أن تكون أسماء المهارات مختصرة ووصفية، مثل `api-doc-generator` بدلًا من `my-skill-1`.
</Tip>

<Tip>
  **قدّم أمثلة ومراجع.** ضمّن أمثلة ملموسة وروابط مرجعية في `SKILL.md` لمساعدة الوكيل على فهم النتيجة المتوقعة بشكل أفضل.
</Tip>

<Tip>
  **حافظ على أرقام الإصدارات.** استخدم حقل `metadata.version` لتتبع التحديثات والتوافق.
</Tip>

<Tip>
  **اختبر قبل المشاركة.** تحقق من صحة مهارتك في مشروع تجريبي قبل طرحها للفريق أو نشرها في متجر المهارات.
</Tip>

***

## راجع أيضًا [#راجع-أيضًا]

<CardGroup cols="2">
  <Card title="إدارة الوكلاء الفرعيين" icon="robot" href="/docs/verdent-manager/configuration/subagents">
    كيف تعمل الوكلاء الفرعيون وكيفية إدارتهم
  </Card>

  <Card title="تكامل MCP" icon="plug" href="/docs/verdent-manager/configuration/mcp">
    ربط الأدوات والخدمات الخارجية عبر MCP
  </Card>

  <Card title="القواعد" icon="book" href="/docs/verdent-manager/configuration/rules">
    تكوين قواعد المشروع والمستخدم النشطة دائمًا
  </Card>

  <Card title="مراجعة الكود" icon="magnifying-glass" href="/docs/verdent-manager/advanced-features/code-review">
    مراجعة تغييرات الكود باستخدام المراجع المدمج
  </Card>
</CardGroup>