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

مهارة 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 هو الملف الوحيد المطلوب:

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 يعتمد عليه ليقرر متى تنطبق المهارة. الحقول الشائعة:

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

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

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

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

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

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

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

---
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) دون استئذان:

---
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

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

/fix-issue 123

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

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

---
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 تشغيل المهارة. حقلان في الترويسة يغيّران ذلك:

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

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

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

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

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

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

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

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

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

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

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

• لا يحمّلها 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:

{
  "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، والأسعار في Claude API.

بالاشتراك: يفعّل تطبيق 5abeer AI أداة Claude Code على اشتراكك بضغطة واحدة، دون مفتاح ودون تعديل ملفات. ويعمل الاشتراك بحد كل خمس ساعات وحد أسبوعي، كما في حدود الاشتراك. الباقات مخصصة للتطبيقات المدعومة، ولاستخدام النماذج من الكود الخاص بك تحتاج إلى مفتاح API. راجع ما الذي تشغّله كل باقة وصفحة الأسعار.

أسئلة شائعة#

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

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

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

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

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

نعم. الحقل model يبدّل النموذج لبقية الدور الذي يشغّل المهارة. وبمفتاح API يُحسب كل نموذج بسعره: النموذج الافتراضي claude-sonnet-5.5، وclaude-opus-5.5 أو claude-fable-5.1 يناسبان أصعب المسائل. القائمة الكاملة مع الأسعار في صفحة النماذج.

هل أستطيع استخدام مهارة 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
• توثيق Claude Code: Extend Claude Code

ابدأ#

لتقارن تكلفة Claude Code بالاشتراك وبمفتاح API، اقرأ أرخص طريقة لاستخدام Claude Code، أو جهّز Claude Code الآن.