# مهارات Claude Code: كيف تكتبها وتستخدمها وتشاركها

> ما مهارة Claude Code، وكيف تكتب ملف SKILL.md، وأين تُحفظ المهارات، ومن يشغّلها، وكيف تشاركها مع فريقك، مع الإعداد بمفتاح API.

آخر تحديث: 2026-11-01

مهارة Claude Code مجلد فيه ملف `SKILL.md`: وصف قصير والتعليمات التي تقف خلفه. يحمّل Claude المهارة عندما يطابق طلبك وصفها، أو تشغّلها أنت بكتابة `/skill-name`. استخدم المهارات لقوائم المراجعة، وقواعد مشروعك، والإجراءات متعددة الخطوات التي كنت ستلصقها في المحادثة مرة بعد مرة.

## ما مهارة Claude Code؟

المهارة حزمة تعليمات لا يقرؤها Claude Code إلا عند الحاجة إليها. تنصح Anthropic بإنشاء مهارة عندما تجد نفسك تلصق التعليمات نفسها في المحادثة مرة بعد مرة، أو عندما يتحول جزء من `CLAUDE.md` إلى إجراء. يُحمَّل `CLAUDE.md` في كل جلسة، أما نص المهارة فلا يُحمَّل إلا عند استخدامها، فلا يكلفك المرجع الطويل شيئًا يُذكر حتى تحتاج إليه.

أصبحت الأوامر المخصصة جزءًا من المهارات: الملف `.claude/commands/deploy.md` والمهارة `.claude/skills/deploy/SKILL.md` كلاهما ينشئ الأمر `/deploy`، وتستمر ملفات الأوامر القديمة في العمل. ويأتي Claude Code أيضًا بمهارات مدمجة مثل `/code-review` و`/debug` و`/loop`، ويوقفها الإعداد `disableBundledSkills`.

## كيف تُبنى المهارة؟

المهارة مجلد يصبح اسمه هو الأمر، والملف `SKILL.md` هو الملف الوحيد المطلوب:

```text
my-skill/
├── SKILL.md           # instructions and frontmatter (required)
├── reference.md       # detailed docs, read only when needed
├── examples.md        # sample output
└── scripts/
    └── helper.py      # a script Claude runs, not loads
```

يبدأ `SKILL.md` بترويسة YAML بين سطرين من `---`، ثم تعليمات Markdown. أهم حقل هو `description`، لأن Claude يعتمد عليه ليقرر متى تنطبق المهارة. الحقول الشائعة:

| الحقل | وظيفته |
| --- | --- |
| `name` | اسم الأمر في قائمة `/`. يأخذ اسم المجلد إذا لم تحدده. |
| `description` | ما تفعله المهارة ومتى تُستخدم. ضع حالة الاستخدام الأساسية أولًا. |
| `argument-hint` | تلميح يظهر في الإكمال التلقائي، مثل `[issue-number]`. |
| `disable-model-invocation` | القيمة `true` تجعلك وحدك من يشغّل المهارة. |
| `allowed-tools` | أدوات يستخدمها Claude دون أن يستأذنك خلال الدور الذي يشغّل المهارة، وينتهي الإذن مع رسالتك التالية. |
| `paths` | أنماط glob. لا يحمّل Claude المهارة من تلقاء نفسه إلا للملفات التي تطابقها. |
| `model` و`effort` | النموذج ومستوى الجهد لبقية الدور الحالي. |

تقطع قائمة المهارات `description` و`when_to_use` معًا عند 1,536 حرفًا، لذلك ابدأ بالكلمات التي يكتبها الناس فعلًا. أبقِ `SKILL.md` أقصر من 500 سطر، وانقل المراجع الطويلة إلى ملفات مساندة يذكرها بالاسم.

## أين تُحفظ المهارات؟

مكان حفظ المهارة يحدد من يستطيع استخدامها:

| المستوى | المسار | من يستخدمها |
| --- | --- | --- |
| شخصي | `~/.claude/skills/skill-name/SKILL.md` | أنت، في كل مشاريعك |
| المشروع | `.claude/skills/skill-name/SKILL.md` | كل من يعمل في المستودع، بعد أن تضيفها إليه |
| إضافة | `skills/skill-name/SKILL.md` داخل الإضافة | حيثما تكون الإضافة مفعّلة، باسم `/plugin-name:skill-name` |
| المؤسسة | الإعدادات المُدارة | كل من في مؤسستك |

ويحمّل Claude Code أيضًا المجلدات المتداخلة مثل `packages/web/.claude/skills/` عندما يعمل على ملفات داخلها. وعندما تحمل مهارتان الاسم نفسه، تتقدم مهارة المؤسسة على الشخصية، والشخصية على مهارة المشروع، أما مهارات الإضافات فتحمل اسم الإضافة في أولها، فلا تتعارض مع غيرها.

## ثلاث مهارات للتجربة

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

مهارة مرجع لقواعد الواجهة البرمجية. مع الحقل `paths` لا يحمّلها Claude من تلقاء نفسه إلا داخل `src/api/`:

```text
---
name: api-conventions
description: REST API conventions for this project. Use when writing or reviewing endpoints.
paths: "src/api/**"
---

When writing API endpoints:
- Use RESTful naming with plural nouns, such as /users and /orders
- Return errors in the shared format from src/api/errors.ts
- Validate the request body before any database call
```

مهارة مهمة تأخذ معطى. يمنع `disable-model-invocation: true` أن يشغّلها Claude من تلقاء نفسه، ويسمح `allowed-tools` بقراءة التذكرة (issue) دون استئذان:

```text
---
name: fix-issue
description: Fix a GitHub issue by number
argument-hint: "[issue-number]"
disable-model-invocation: true
allowed-tools: Bash(gh issue view *)
---

Fix GitHub issue $ARGUMENTS following our coding standards.

1. Read the issue with gh issue view
2. Find the code it describes
3. Implement the fix
4. Write or update tests
5. Summarize the change for the commit message
```

تشغّلها مع رقم التذكرة:

```text
/fix-issue 123
```

يُستبدل `$ARGUMENTS` بكل ما كتبته بعد الاسم، أما المعطيات المنفصلة فيختارها `$0` و`$1`.

مهارة شخصية تقرأ تغييراتك في الكود قبل أن يرى Claude التعليمات:

```text
---
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---

## Current changes

!`git diff HEAD`

## Instructions

Summarize the changes above in two or three bullet points, then list any risks you notice such as missing error handling, hardcoded values, or tests that need updating. If the diff is empty, say there are no uncommitted changes.
```

يشغّل Claude Code أولًا `` !`git diff HEAD` `` ويضع مخرجات الأمر مكانه، فتصل التعليمات ومعها التغييرات الفعلية. اسأل «ماذا غيّرت؟» فيحمّل Claude المهارة، أو شغّل `/summarize-changes` بنفسك.

## من يشغّل المهارة: أنت أم Claude؟

افتراضيًا تستطيع أنت ويستطيع Claude تشغيل المهارة. حقلان في الترويسة يغيّران ذلك:

| الترويسة | تشغّلها أنت | يشغّلها Claude | تناسب |
| --- | --- | --- | --- |
| دون أي من الحقلين | نعم | نعم | أغلب المهارات |
| `disable-model-invocation: true` | نعم | لا | الإجراءات ذات الأثر، مثل `/commit` أو `/deploy` |
| `user-invocable: false` | لا | نعم | معرفة خلفية لا تستدعيها يدويًا |

مع `disable-model-invocation: true` لا يدخل الوصف في سياق Claude، فلا تكلّف المهارة شيئًا حتى تستدعيها. وكتابة `/skill-name` في بداية الرسالة تشغّل المهارة، أما في موضع لاحق منها فتسمح لـ Claude باستخدامها فقط.

## مهارة أم CLAUDE.md أم خطاف أم وكيل فرعي؟

لكل أداة مشكلة مختلفة تحلها:

| الأداة | متى تُحمَّل | استخدمها من أجل |
| --- | --- | --- |
| `CLAUDE.md` | في كل جلسة | قواعد المشروع والأعراف التي تنطبق دائمًا |
| المهارة | الوصف دائمًا، والنص عند الاستخدام | المراجع والمهام المتكررة |
| الخطاف | خارج النموذج، عند وقوع حدث | خطوات يجب أن تعمل كل مرة، مثل ESLint بعد كل تعديل |
| الوكيل الفرعي | في سياقه الخاص، ثم يعيد ملخصًا | مهام جانبية كانت ستملأ المحادثة الرئيسية |

قواعد Anthropic العملية: إذا أخطأ Claude في عُرف مرتين، فأضِفه إلى `CLAUDE.md`. وإذا لصقت التعليمات نفسها للمرة الثالثة، فحوّلها إلى مهارة. وإذا كان شيء يجب أن يحدث كل مرة، فاكتب خطافًا: قد يتجاوز Claude تعليمة، أما الخطاف فيعمل عند كل حدث مطابق.

## هل تزيد المهارات التكلفة؟

قليلًا، ويمكنك قياس ذلك. يبقى اسم كل مهارة ووصفها في السياق، في حدود ميزانية قدرها واحد في المئة من نافذة سياق النموذج. أما النص الكامل فلا يُحمَّل إلا عند تشغيل المهارة، ثم يبقى في المحادثة.

للتحقق، افتح `/context` وانظر إلى صف المهارات، أو شغّل `/skill-doctor` (في Claude Code v2.1.252 أو أحدث) لترى تكلفة كل مهارة وعدد مرات استخدامها.

بمفتاح API يُحسب نص المهارة مدخلات عادية، تُدفع بسعر النموذج لكل توكن. السعر الحالي للنموذج الافتراضي:

Claude Sonnet 5.5 (`claude-sonnet-5.5`) لكل مليون توكن: الإدخال 0.60 US$ (الرسمي 2 US$)، الإخراج 3 US$ (الرسمي 10 US$). آخر مراجعة للسعر الرسمي: 19 أكتوبر 2026.

## كيف تشارك المهارات مع فريقك؟

- أضف `.claude/skills/` إلى المستودع، فيحصل كل من ينسخه على مهارات المشروع.
- اجمع المهارات في إضافة، فتعمل باسم `/plugin-name:skill-name`.
- وزّع المهارات على مؤسسة كاملة عبر الإعدادات المُدارة.

> ثقة مساحة العمل لا تقيّد `allowed-tools`: أذونات مهارة المشروع تسري حتى في مجلد لم تمنحه ثقتك قط. راجع `allowed-tools` في أي مستودع تنسخه، وأبقِ أذوناتك ضيقة، مثل `Bash(git status *)` بدل `Bash` كلها.

## عندما لا تعمل المهارة

- **لا يحمّلها Claude:** تأكد أن الوصف يحتوي الكلمات التي تستخدمها، أو شغّل `/skill-name` مباشرة.
- **الأمر `/skill-name` يعمل لكن Claude لا يختارها أبدًا:** غالبًا في YAML الترويسة خطأ في الصيغة، ويُظهر `claude --debug` خطأ القراءة.
- **مهارة فيها `paths` لا تعمل أبدًا:** الأنماط نسبية إلى مجلد عمل Claude.
- **تعمل أكثر مما ينبغي:** اجعل الوصف أدق، أو اضبط `disable-model-invocation: true`.
- **يتوقف Claude عن اتباعها في جلسة طويلة:** ضع التعليمات الأساسية في أولها، وشغّل المهارة مرة أخرى بعد ضغط المحادثة. والقاعدة التي يجب أن تتحقق كل مرة مكانها خطاف.

## مهارات Claude Code عبر 5abeer

5abeer خدمة مستقلة لا تتبع Anthropic. واجهتها البرمجية تتبع صيغة Anthropic Messages، لذلك يعمل معها Claude Code كما يصدر، والطريقان بسعر أقل من السعر الرسمي.

المهارات ملفات على جهازك، لذلك تعمل بالطريقة نفسها مع مفتاح 5abeer؛ لا يتغير إلا عنوان الأساس والمفتاح.

**بمفتاح API:** أنشئ مفتاحًا لنماذج Claude، ثم ضع عنوان الأساس والمفتاح في إعدادات Claude Code:

| الصيغة | العنوان الأساسي | ترويسة المفتاح |
| --- | --- | --- |
| OpenAI | `https://api.5abeer.ai/v1` | `Authorization: Bearer <KEY>` |
| Anthropic | `https://api.5abeer.ai` | `x-api-key: <KEY>` |
| Gemini | `https://api.5abeer.ai/v1beta` | `x-goog-api-key: <KEY>` |

`~/.claude/settings.json`

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.5abeer.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_5ABEER_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5.5"
  }
}
```

المهارات المتزامنة من حساب claude.ai لا تُحمَّل إلا عندما تسجّل الدخول بذلك الحساب، لذلك احفظ مهاراتك مع المفتاح في `~/.claude/skills/` أو `.claude/skills/`.

يُخصم كل طلب من رصيدك بحسب النموذج وعدد التوكنات، وتتحكم في كل مفتاح بحد إنفاق وتاريخ انتهاء وقائمة عناوين IP مسموح بها. الإعداد الكامل في [إعداد Claude Code](https://5abeer.ai/ar/docs/apps/claude-code.md)، والأسعار في [Claude API](https://5abeer.ai/ar/api/claude).

**بالاشتراك:** يفعّل تطبيق 5abeer AI أداة Claude Code على اشتراكك بضغطة واحدة، دون مفتاح ودون تعديل ملفات. ويعمل الاشتراك بحد كل خمس ساعات وحد أسبوعي، كما في [حدود الاشتراك](https://5abeer.ai/ar/docs/subscriptions/limits.md). الباقات مخصصة للتطبيقات المدعومة، ولاستخدام النماذج من الكود الخاص بك تحتاج إلى مفتاح API. راجع [ما الذي تشغّله كل باقة](https://5abeer.ai/ar/docs/subscriptions/plan-apps.md#claude-code) و[صفحة الأسعار](https://5abeer.ai/ar/pricing).

## أسئلة شائعة

### ما الفرق بين الأوامر والمهارات؟

دُمجت الأوامر المخصصة في المهارات، وملف الأمر في `.claude/commands/` ما زال ينشئ الأمر `/name` نفسه. وتضيف المهارة ملفات مساندة، والتحكم في من يشغّلها، وإمكانية أن يحمّلها Claude من تلقاء نفسه، لذلك اكتب الجديد مهارات.

### هل تعمل المهارات بمفتاح API؟

نعم. المهارات الشخصية ومهارات المشروع ملفات على جهازك، لذلك تعمل بالطريقة نفسها باشتراك أو بمفتاح. وحدها المهارات المتزامنة من حساب claude.ai تحتاج إلى تسجيل الدخول بذلك الحساب.

### هل تستطيع المهارة اختيار النموذج؟

نعم. الحقل `model` يبدّل النموذج لبقية الدور الذي يشغّل المهارة. وبمفتاح API يُحسب كل نموذج بسعره: النموذج الافتراضي [`claude-sonnet-5.5`](https://5abeer.ai/ar/models/claude-sonnet-5.5)، و[`claude-opus-5.5`](https://5abeer.ai/ar/models/claude-opus-5.5) أو [`claude-fable-5.1`](https://5abeer.ai/ar/models/claude-fable-5.1) يناسبان أصعب المسائل. القائمة الكاملة مع الأسعار في [صفحة النماذج](https://5abeer.ai/ar/models).

### هل أستطيع استخدام مهارة Claude Code خارج Claude Code؟

جزئيًا. تتبع المهارات المعيار المفتوح Agent Skills، لكن رفع المهارات إلى claude.ai وواجهة Skills API لا يقبلان إلا ستة حقول في الترويسة: `name` و`description` و`license` و`compatibility` و`metadata` و`allowed-tools`. وميزات Claude Code مثل أسطر الأوامر `!` لا تعمل هناك.

### هل أنقل محتوى CLAUDE.md إلى مهارات؟

انقل الإجراءات لا القواعد. ما يحتاجه Claude في كل جلسة يبقى في `CLAUDE.md`، الذي تقترح Anthropic إبقاءه أقصر من 200 سطر، والإجراءات الطويلة تصبح مهارات.

## المصادر

راجعنا هذه المصادر في 1 نوفمبر 2026.

- [توثيق Claude Code: Extend Claude with skills](https://code.claude.com/docs/en/skills)
- [توثيق Claude Code: Extend Claude Code](https://code.claude.com/docs/en/features-overview)

## ابدأ

لتقارن تكلفة Claude Code بالاشتراك وبمفتاح API، اقرأ [أرخص طريقة لاستخدام Claude Code](https://5abeer.ai/ar/guides/claude-code-cheapest-way)، أو جهّز Claude Code الآن.