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

# Skills

> Skills حزم ذات إصدارات من تعليمات Markdown وملفات داعمة. أنشئها وأدرها عبر MCP، وحمّلها في وكيلك، وابدأ من قالب، واستخدمها داخل Automations.

Skills هي حزم قابلة لإعادة الاستخدام من التعليمات والملفات الداعمة الاختيارية. تتيح لفريقك تحديد طريقة قابلة للتكرار لإنجاز مهمة مرة واحدة، ثم تطبيقها باتساق عبر Flowglad.

لكل Skill اسم، وslug لأمر الشرطة المائلة، ووصف، وتعليمات مكتوبة بتنسيق Markdown. يمكن أن توفر الملفات الداعمة سياقًا أو موارد إضافية لازمة لاتباع تلك التعليمات.

## استخدم Flowglad كمكتبة Skills لفريقك

يحتفظ Flowglad بكل Skill كحزمة ذات إصدارات. يؤدي نشر تغيير إلى إنشاء مراجعة جديدة بدلًا من استبدال الحزمة السابقة في مكانها. يمكن لمسؤولي المؤسسة فتح **History** الخاص بـ Skill لفحص مراجعاتها، ومقارنة التغييرات، واستعادة مراجعة سابقة، أو تجاهل مسودة عندما تكون هذه الإجراءات متاحة.

يمنح هذا فريقك مكانًا واحدًا خاضعًا للحوكمة لصيانة التعليمات القابلة لإعادة الاستخدام مع الحفاظ على معرفة الإصدار الذي كان نشطًا في وقت معين. لا تحل المراجعات المسودة والمرفوضة محل الإصدار النشط.

### إدارة Skills عبر MCP

بعد توصيل خادم Flowglad MCP، يمكن للوكيل فحص مكتبة Skills الخاصة بمؤسستك وإدارتها نيابةً عنك:

* يُرجع `skills.list` الـ Skills المرئية للاتصال.
* يُرجع `skills.get` أحدث بيانات وصفية للمراجعة والمراجعة النشطة لـ Skill واحدة.
* يرسل `skills.create` حزمة Skill جديدة.
* يرسل `skills.create_candidate` مراجعة جديدة لـ Skill موجودة.
* يتحقق `skills.publish_revision` من مراجعة مؤجلة وينشرها.
* ينقل `skills.create_package_upload_session` و`skills.finalize_package_upload_session` الحزم الأكبر من أن تُرسل مضمّنة.
* يُبلغ `skills.get` عن نتيجة التحقق والترقية للطلب المقبول.

يتطلب إنشاء Skills أو تحديثها إذن `skills:write` على كلٍّ من عضوية زميل الفريق في المؤسسة ومنحة اتصال MCP. إذا أضفت الإذن بعد توصيل الخادم، فأعد توصيل Flowglad MCP وامنح التفويض لـ `skills:write` حتى تصبح أدوات الكتابة متاحة.

**الأذونات:** يمتلك المسؤولون صلاحية تأليف Skills افتراضيًا. لمنح Contributor الصلاحية نفسها، افتح **Settings** → **Team**، واختر زميل الفريق، وفعّل **Skill Authoring**. يمنح هذا إذنًا لإنشاء Skills المؤسسة وتحديثها دون جعل زميل الفريق مسؤولًا.

## تحميل Skills من Flowglad MCP إلى وكيلك

يعلن خادم Flowglad MCP عن `io.modelcontextprotocol/skills` أثناء تهيئة MCP. يخبر هذا العملاء المتوافقين بأن الخادم ينفّذ أساليب Skill الخاصة بالوكيل `skills/list` و`skills/get`. تتضمن كل Skill مُرجعة معرّفات موارد `skill://` وملخصات المحتوى؛ ويمكن للعملاء استرداد الملفات باستخدام `resources/read`.

لا يضمن توصيل الخادم أن يستدعي العميل `skills/list` أو يثبّت الحزم المُرجعة. يختلف دعم العملاء. أضف تعليمة بدء تشغيل إلى ChatGPT / Codex أو Claude عندما تريد أن يحدّث الوكيل سجل Flowglad في بداية كل جلسة.

**تسمية MCP:** الأسماء مختلفة عمدًا. `skills.list` بنقطة هي أداة Flowglad لسجلات Skills ذات الإصدارات في مؤسستك. أما `skills/list` بشرطة مائلة فهي أسلوب امتداد لبروتوكول MCP لاكتشاف حزم Skills الموجهة للوكلاء.

### إضافة تعليمة بدء التشغيل

أنشئ مجلد الوجهة مرة واحدة قبل بدء جلسة جديدة، ثم أضف كتلة التعليمات المطابقة أدناه.

#### ChatGPT / Codex

أنشئ مجلد الوجهة لـ ChatGPT / Codex باستخدام `mkdir -p ~/.agents/skills`.

ضع الكتلة التالية في `~/.codex/AGENTS.md` لتطبيقها على كل مشروع، أو في ملف `AGENTS.md` الخاص بمستودع لمشاركتها مع فريق ذلك المستودع.

```markdown AGENTS.md theme={null}
## Flowglad MCP Skill bootstrap

At the start of every new session, before handling the first task:

1. Confirm that the Flowglad MCP server is connected.
2. Refresh the agent Skill catalog from Flowglad. Prefer the advertised `skills/list` MCP extension method. If the client does not expose that method directly, use the Flowglad server's `resources/list` method and select resources whose URIs begin with `skill://flowglad/`.
3. For every returned Skill, retrieve its manifest with `skills/get` when available, then read each listed resource with `resources/read`, beginning with `SKILL.md`.
4. Synchronize the package into `~/.agents/skills/<skill-name>/`. Compare the returned content digests and rewrite only new or changed Flowglad-managed files. Never overwrite or delete unrelated local Skills.
5. Treat the refreshed Flowglad package as the source of truth for this session. Make the synchronized Skills available for automatic matching and explicit `$skill-name` invocation.
6. If this ChatGPT / Codex client cannot call the Skill or resource methods, report that limitation once and continue without claiming that the registry was refreshed.
```

#### Claude

أنشئ مجلد الوجهة لـ Claude باستخدام `mkdir -p ~/.claude/skills`.

ضع الكتلة التالية في `~/.claude/CLAUDE.md` لتطبيقها على كل مشروع، أو في ملف `CLAUDE.md` الخاص بمستودع لمشاركتها مع فريق ذلك المستودع.

```markdown CLAUDE.md theme={null}
## Flowglad MCP Skill bootstrap

At the start of every new session, before handling the first task:

1. Confirm that the Flowglad MCP server is connected.
2. Refresh the agent Skill catalog from Flowglad. Prefer the advertised `skills/list` MCP extension method. If the client does not expose that method directly, use the Flowglad server's `resources/list` method and select resources whose URIs begin with `skill://flowglad/`.
3. For every returned Skill, retrieve its manifest with `skills/get` when available, then read each listed resource with `resources/read`, beginning with `SKILL.md`.
4. Synchronize the package into `~/.claude/skills/<skill-name>/`. Compare the returned content digests and rewrite only new or changed Flowglad-managed files. Never overwrite or delete unrelated local Skills.
5. Treat the refreshed Flowglad package as the source of truth for this session. Make the synchronized Skills available for automatic matching and explicit `/skill-name` invocation.
6. If this Claude client cannot call the Skill or resource methods, report that limitation once and continue without claiming that the registry was refreshed.
```

يمكنك أن تطلب من ChatGPT / Codex أو Claude إضافة الكتلة المناسبة إلى ملف التعليمات الخاص بالمستخدم لديه. راجع التعديل المقترح قبل قبوله لأن ذلك الملف يؤثر على الجلسات المستقبلية. التعليمة هي تهيئة وكيل بأفضل جهد؛ إذا كانت بيئتك يجب أن تحدّث Skills بشكل حتمي، فنفّذ المزامنة نفسها في hook موثوق من نوع `SessionStart` أو في تكامل عميل MCP الخاص بك.

## أين تُستخدم Skills

لـ Skills مستهلكان حاليان:

* تكتشف الوكلاء الخارجية المتوافقة الحزم المفعّلة وتزامنها عبر Flowglad MCP، ثم تطابقها تلقائيًا أو تستدعيها بالاسم.
* تثبّت Automations مراجعة Skill منشورة محددة بدقة كمورد شيفرة OWS من نوع `skill-revision`. تختار Automation مسار حزمة ونقطة دخول؛ ولا تتلقى خطوات الوكيل إلا Skills المصرّح بها بموجب مجموعة قدرات التشغيل المختومة.

يوفّر المسار الأول تعليمات قابلة لإعادة الاستخدام لوكيل خارجي. ويوفّر الثاني شيفرة غير قابلة للتغيير وملفات داعمة لتشغيل Automation قابل للتكرار. Skills المنشورة على مستوى المؤسسة، لذا يمكن لـ Automation مصرّح بها اختيار مراجعة Skill نفسها في أي Space. تظل Automation المستهلِكة وعمليات تشغيلها مملوكة لـ Space الخاصة بها؛ واختيار Skill لا يغيّر هذا الحد.

## إنشاء Skills وصيانتها

افتح **organization menu** → **Skills** → **New Skill**. في علامة التبويب **Skill**، أدخل **Name** و**Slug** و**Description** الاختياري والتعليمات القابلة لإعادة الاستخدام في **Markdown**. استخدم علامة التبويب **Files** لأي ملفات حزمة داعمة، ثم اختر **Create Skill**.

يستخدم الـ Slug أحرفًا إنجليزية صغيرة وأرقامًا وشرطات، ويبدأ بحرف أو رقم، وهو ما يكتبه المستخدمون بعد `/`.

يؤدي إنشاء Skill أو تعديلها إلى إنتاج مسودة. في صفحة تفاصيل Skill، تُحفظ التعديلات تلقائيًا؛ اختر **Publish Draft** للتحقق من المسودة ونشرها. إذا فشل التحقق، فاستخدم التشخيصات المعروضة لتصحيح المسودة والنشر مرة أخرى.

استخدم **History** لفحص المراجعات، أو استعادة مراجعة مُستبدلة، أو تجاهل مسودة قابلة للتعديل عندما تكون هذه الإجراءات متاحة. يزيل **Disable Skill** الـ Skill من اكتشاف الوكلاء الخارجيين ومن تحليل Automation دون حذف سجل المراجعات؛ ويجعلها **Enable Skill** متاحة مرة أخرى.

## إنشاء Skill أو تعديلها باستخدام MCP

استخدم عميل MCP خارجيًا متصلًا للتأليف القائم على الحزم أولًا. استدعِ `skills.get` قبل تعديل Skill موجودة. استخدم `skills.create` لحزمة جديدة أو `skills.create_candidate` لمراجعة مبنية على المراجعة النشطة الحالية.

يمكن توفير الحزم الصغيرة مضمّنة. بالنسبة للحزم الأكبر، استدعِ `skills.create_package_upload_session`، وارفع الكائنات المطلوبة، وأنهِ باستخدام `skills.finalize_package_upload_session`. إذا كان التحقق مؤجلًا، فاستدعِ `skills.publish_revision`. استطلع `skills.get` للحصول على طلب دورة الحياة المقبول ونتيجة التحقق أو الترقية الخاصة به.

لا يؤدي نشر Skill إلى إنشاء Automation أو مراجعتها أو تفعيلها؛ استخدم دورة حياة Automation في MCP صراحةً عند الحاجة إليها.

## البدء من قالب Skill

تتضمن صفحة **Skills** قسم **Skill Templates**. ابحث في الكتالوج أو صفِّه، واعرض قالبًا مسبقًا، واختر **Copy Skill**. تصبح النسخة Skill خاصة بالمؤسسة يمكن تعديلها ونشرها مثل أي Skill أخرى.

## Skills وAutomations

تحدد Skill كيفية أداء عمل قابل لإعادة الاستخدام. ولا تقرر متى يُنفَّذ ذلك العمل.

استخدم Automation عندما يحتاج العمل إلى التشغيل يدويًا، أو وفق جدول زمني، أو استجابةً لحدث. يمكن لـ Automation تثبيت مراجعة Skill واحدة أو أكثر بحيث يُعاد استخدام التنفيذ نفسه عبر عمليات التشغيل.


## Related topics

- [مرحبًا بك](/docs/ar/agents/introduction.md)
- [MCP](/docs/ar/mcp-server.md)
- [الأتمتات](/docs/ar/automations.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.