Techsy
اتصل بنا
ابدأ
العودة للمدونة
ai-machine-learning

دليل Claude Skills: ابنِ أول مهارة SKILL.md في 10 دقائق (2026)

بقلم Techsy Editorial Team
May 1, 2026
13 قراءة
جدول المحتويات
دليل Claude Skills: ابنِ أول مهارة SKILL.md في 10 دقائق (2026)

دليل Claude Skills: ابنِ أول مهارة SKILL.md في 10 دقائق (2026)

المهارات هي الميزة الأهم في Claude Code التي لا يستخدمها معظم الناس بعد. مهارة Claude هي مجلد يحتوي على ملف SKILL.md يُحمِّله Claude تلقائياً فور تطابق طلبك مع وصفه — لا نسخ للأوامر ولصقها، ولا نظام CLAUDE.md منتفخ، ولا حاجة إلى تذكر القالب الصحيح. شحنّا 4 مهارات داخل مجلد .claude/skills/agent/ في هذا المستودع، ومع Skills 2.0 وسوق Anthropic القادم مطلع 2026، بلغ التنسيق ذروته. إليك النمط الذي يعمل بعد تجاوز الأخطاء الشائعة.

النقاط الرئيسية

  • مهارة Claude هي مجلد يحتوي على SKILL.md بواجهة YAML يُحمِّلها Claude تلقائياً عند الحاجة.
  • المهارات تُوضع في ~/.claude/skills/ (شخصية) أو .claude/skills/ (للمشروع) — يفحص Claude كليهما عند الإقلاع.
  • استخدم المهارات لسير العمل المتكررة؛ استخدم MCP للبيانات الخارجية الحية؛ استخدم الوكلاء الفرعيين للتخطيط المتعدد الخطوات؛ استخدم الخطافات للأحداث الحتمية.
  • أسرع طريق إلى أول مهارة هو أن تطلب من Claude تفعيل مهارة skill-creator المدمجة — وستكتب ملف SKILL.md عنك.

ما هي مهارات Claude؟

مهارة Claude هي مجلد يحتوي على ملف SKILL.md بواجهة YAML (name، description، وallowed-tools اختياريًا) يُحمِّله Claude Code تلقائياً في السياق حين يتطابق طلبك مع الوصف. تُعبِّئ المهارات سير العمل القابلة لإعادة الاستخدام — كـ /commit أو /explain-code — دون تضخيم موجِّه النظام.

وفق التوثيق الرسمي من Anthropic، كل مجلد مهارة يحتوي ثلاثة أشياء: ملف SKILL.md إلزامي، سكريبتات مُرفقة اختيارية (من مساعد Python إلى ملف JSON)، ومستندات مرجعية اختيارية تُحمَّل مع الجسم. هذا كل شيء. لا خطوة بناء، لا تثبيت، لا ملف manifest.

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

فكر في المهارات كوصفات في كتاب طبخ يتصفحها Claude حين يرى المكونات في طلبك. المهارة مجلد يقرأه Claude عند الطلب — لا أمر تتذكر لصقه. هذا هو جوهر الفكرة.

ملف SKILL.md الأدنى يبدو هكذا:

markdown
---
name: Summarize file
description: Use when the user asks for a 3-sentence summary of a file or function.
---

Read the file at $ARGUMENTS. Summarize purpose, key dependencies, and the
single most surprising thing about it. Three sentences max.

عشرة أسطر. مهارة حقيقية. جاهزة للتفعيل.

البداية السريعة: ابنِ أول مهارة في 10 دقائق

لبناء أول مهارة Claude في 10 دقائق: (1) أنشئ مجلد ~/.claude/skills/explain-code/، (2) أضف ملف SKILL.md يحتوي على name وdescription وجسم سير العمل، (3) أعد تشغيل Claude Code كي يفحص المجلد الجديد، (4) فعِّلها بطلب يتطابق مع الوصف.

إليك التدفق الكامل.

الخطوة 1: أنشئ المجلد

bash
mkdir -p ~/.claude/skills/explain-code

المهارات الشخصية (لك وحدك) تذهب إلى ~/.claude/skills/. مهارات المشروع (مشتركة عبر git مع فريقك) تذهب إلى .claude/skills/ في جذر المستودع. اختر الشخصية لسير العمل اليومية؛ واختر المشروع حين تريد أن يرثها كل مساهم.

الخطوة 2: اكتب SKILL.md

ضع هذا الملف في ~/.claude/skills/explain-code/SKILL.md:

markdown
---
name: Explain code
description: Use when the user asks for a plain-English walkthrough of a code snippet, function, or file. Use $ARGUMENTS for the path or snippet.
---

You are explaining code to a developer who is new to this codebase.

1. Read the file or snippet at $ARGUMENTS.
2. State the file's purpose in one sentence.
3. Walk through the control flow line by line in plain English.
4. Flag any non-obvious dependencies or side effects.
5. End with one question the reader should ask before changing this code.

هذه هي المهارة بكاملها. الواجهة هي العقد؛ والجسم هو دليل التشغيل.

الخطوة 3: أعد تشغيل Claude Code

الاكتشاف الحي ميزة من Skills 2.0 — الإصدارات القديمة من Claude Code تحتاج إعادة تشغيل كاملة لاستيعاب المجلد الجديد. إن لم تكن متأكداً من إصدارك، إعادة التشغيل لا تكلف شيئاً.

الخطوة 4: فعِّلها

افتح مشروعاً واكتب:

text
walk me through what auth/middleware.ts does

يطابق Claude طلبك مع حقل description، يجد explain-code، ويُحمِّل جسم SKILL.md في السياق بصمت. ستظهر رسالة "Using skill: explain-code" في سجل الأدوات. انتهى.

نصيحة احترافية: لا تريد كتابة الملف بنفسك؟ افتح Claude Code وقل Use the skill-creator skill to scaffold an explain-code skill for me. مهارة skill-creator المُرفقة من Anthropic هي ميتا-مهارة تُجري معك مقابلة، تختار allowed-tools المناسبة، وتكتب SKILL.md في المجلد الصحيح. أسرع طريق إلى أول مهارة، نقطة.

هذا هو وعد العشر دقائق — خمس دقائق كتابة، إعادة تشغيل واحدة، طلب اختبار واحد.

مخطط يوضح كيف يكتشف Claude Code المهارات عبر فحص مجلدَي ~/.claude/skills/ و.claude/skills/ عند الإقلاع، وتحميل كل SKILL.md في درج المهارات المتاحة.

داخل SKILL.md: مرجع الواجهة الأمامية

واجهة SKILL.md هي YAML محاطة بمحددات ---. حقلان إلزاميان: name (≤64 حرفاً، يُستخدم اسماً لأمر الشرطة) وdescription (النص المحرِّك الذي يطابقه Claude مع طلبك). الحقول الاختيارية تتحكم في وصول الأدوات، استدعاء النموذج، نمط الملفات، وسياق التنفيذ.

إليك المرجع الكامل، مصدره توثيق مهارات Anthropic:

الحقلإلزامي؟النوعمتى تستخدمه
nameنعمنص ≤64 حرفاًدائماً — يصبح اسم أمر الشرطة
descriptionنعمنص ≤1024 حرفاًدائماً — يفحصه Claude ليقرر تطابق المهارة
allowed-toolsلامصفوفة أنماط الأدواتتقييد المهارة بأدوات محددة (مثلاً: Bash(git *), Read, Grep)
disable-model-invocationلاقيمة منطقيةجعل المهارة قابلة للاستدعاء من المستخدم فقط (أمر شرطة، لا تفعيل تلقائي)
user-invocableلاقيمة منطقيةالإشارة إلى أن المهارة ستظهر كـ /skill-name في قائمة أوامر الشرطة
argument-hintلانصإعطاء المستخدم تلميحاً حول ما يجب أن يحتويه $ARGUMENTS
modelلانصتثبيت المهارة على نموذج محدد (مثلاً: claude-opus-4-7)
contextلاdefault أو fork(Skills 2.0) تشغيل المهارة في نافذة سياق منفصلة حتى لا تُلوِّث الخيط الرئيسي
globsلامصفوفة أنماط globاقتراح المهارة تلقائياً حين تكون الملفات المطابقة في النطاق
referencesلامصفوفة مسارات ملفاتربط مستندات مرجعية تُحمَّل مع جسم المهارة
bundled-filesلامصفوفة مسارات ملفاتربط سكريبتات يمكن للمهارة تنفيذها
tagsلامصفوفة نصوصتنظيم المهارات في قوائم السوق

صف context: fork يستحق إيضاحاً. إنه عنصر أساسي من Skills 2.0 يُشغِّل المهارة داخل نافذة سياق معزولة — مفيد لمهارات البحث الطويلة أو أي شيء ينتج رموزاً وسيطة كثيرة لا تريدها تُلوِّث خيطك الرئيسي. إن كنت جديداً على هذه الفكرة، دليلنا عن هندسة السياق يغطي المقايضات.

واجهة SKILL.md تعظيمية، كل حقل مملوء:

yaml
---
name: Deploy preview
description: Use when the user wants to deploy a preview build of the current branch to staging.
allowed-tools: ["Bash(git status:*)", "Bash(npm run build:*)", "Bash(vercel:*)"]
disable-model-invocation: true
user-invocable: true
argument-hint: <branch-name or 'current'>
model: claude-opus-4-7
context: fork
globs: ["package.json", "vercel.json"]
references: ["./deploy-runbook.md"]
bundled-files: ["./scripts/preflight.sh"]
tags: ["deploy", "vercel", "preview"]
---

نصيحة احترافية: الخطأ الأكبر في description: كتابته للبشر. اكتبه لـ Claude — عبارات تشغيل واضحة، لا نص تسويقي. سيئ: "مهارة أتمتة Git قوية." جيد: "Use when the user wants to commit changes, write a commit message, or open a PR."

مهارتان حقيقيتان من البداية إلى النهاية

نمطان من المهارات يغطيان 80% من حالات الاستخدام الواقعية: (1) مهارة /commit قابلة للاستدعاء من المستخدم مع disable-model-invocation: true وallowed-tools: Bash(git *) للإجراءات الحتمية؛ (2) مهارة /explain-code يُفعِّلها النموذج تلقائياً بالواجهة الافتراضية حين تتطابق الطلبات مع وصفها.

معظم الدروس تعرض مقتطفات. هنا ملفان كاملان يمكنك نسخهما إلى ~/.claude/skills/ الآن.

مهارة /commit (قابلة للاستدعاء من المستخدم)

markdown
---
name: Commit
description: Use when the user wants to stage and commit code changes with an AI-written conventional-commit message.
disable-model-invocation: true
user-invocable: true
allowed-tools:
  - "Bash(git status:*)"
  - "Bash(git diff:*)"
  - "Bash(git add:*)"
  - "Bash(git commit:*)"
---

1. Run `git status` and `git diff` to see what's staged and unstaged.
2. Group changes into one logical commit. If there are multiple unrelated
   changes, ask the user which to include.
3. Draft a Conventional Commits message: `type(scope): subject` (≤72 chars),
   blank line, body explaining *why*, not *what*.
4. Show the message to the user. Ask "Commit this?" Wait for explicit yes.
5. On confirmation, run `git add` for the included files and `git commit -m`.
6. Print the resulting commit hash.

طلب الاختبار: /commit

ما يحدث: يفحص Claude حالة git، يصيغ رسالة، يطلب موافقتك، ثم يُنفِّذ git commit. الخيار disable-model-invocation: true يعني أنه لن يُفعَّل تلقائياً على طلب غامض كـ "احفظ تغييراتي" — يعمل فقط حين تكتب /commit. قائمة allowed-tools تقيِّده بأوامر git فرعية محددة؛ لا يستطيع ماديًا تشغيل rm -rf أو الدفع إلى remote. هذه مهارة نستخدمها فعلياً في مسار عملنا.

للإجراءات الحتمية بعد الـ commit (تشغيل lint، إعادة توليد الأنواع، إرسال إشعار Slack)، الجأ إلى خطافات Claude Code — المهارات احتمالية، والخطافات تُطلق في كل مرة.

مهارة /explain-code (يُفعِّلها النموذج)

markdown
---
name: Explain code
description: Use when the user asks for a plain-English walkthrough of a code snippet, function, or file. Use $ARGUMENTS for the path or snippet.
argument-hint: <file path or pasted snippet>
model: claude-opus-4-7
---

1. Read the file or snippet at $ARGUMENTS. If $ARGUMENTS is empty, ask
   the user which file to explain.
2. State the file's purpose in one sentence.
3. Walk through the control flow line by line in plain English.
4. Flag any non-obvious dependencies, side effects, or hidden assumptions.
5. End with one question the reader should ask before modifying this code.

طلب الاختبار: walk me through what auth/middleware.ts does

ما يحدث: لاحظ أن المستخدم لم يكتب /explain-code. يطابق Claude عبارة "walk me through" مع حقل description، يجد المهارة، ويستدعيها تلقائياً. هذا هو السحر — حقل description هو الذي يقوم بالتوجيه. حقل model: claude-opus-4-7 يثبِّت هذه المهارة على Opus بصرف النظر عن النموذج الافتراضي لديك، لتحصل شروح الكود العميقة دائماً على النموذج الأذكى. (المزيد عن تشغيل Claude Code مع نماذج مختلفة.)

لماذا نمطان؟ المهارة الأولى قابلة للاستدعاء من المستخدم ومقيَّدة بأدوات محددة — متوقعة، آمنة، مثالية لـ git أو النشر. الثانية يفعِّلها النموذج تلقائياً — سحر المهارات الحقيقي، لكنه يعتمد على حقل description. المهارات القابلة للاستدعاء توفر القدرة على التنبؤ؛ المهارات التي يفعِّلها النموذج توفر السحر. اختر لكل مهارة على حدة، لا على مستوى المستودع.

لمزيد من أمثلة المهارات الحقيقية، راجع مستودع anthropics/skills الرسمي وقائمة awesome-claude-skills التي يصونها المجتمع.

المهارات مقابل MCP مقابل الوكلاء الفرعيين مقابل الخطافات: متى تستخدم ماذا؟

استخدم المهارات لسير العمل القابلة لإعادة الاستخدام التي يجب أن يُفعِّلها Claude تلقائياً أو تستدعيها كأوامر شرطة. استخدم خوادم MCP حين تحتاج بيانات خارجية حية (قواعد بيانات، APIs، أنظمة ملفات خارج مجلد العمل). استخدم الوكلاء الفرعيين للخطط متعددة الخطوات التي يجب أن يفوِّضها Claude إلى سياق جديد. استخدم الخطافات للأحداث الحتمية (قبل الـ commit، بعد استخدام الأداة) التي يجب أن تُطلق دائماً — لا احتمالياً.

إطار سريع: المهارات سير عمل، بروتوكول سياق النموذج هو بيانات، الوكلاء الفرعيون خطط، الخطافات أحداث. كل منها يعيش في طبقة مختلفة من Claude Code، والطبقة الخطأ هي الأداة الخطأ. وفق منشور Anthropic الخاص بـ شرح المهارات، هذا هو الإطار الذي يريدون منك استيعابه.

السؤالالمهاراتMCPالوكلاء الفرعيونالخطافات
يُفعَّل بواسطةتطابق الطلب أو /slashcmdالنموذج يقرر استدعاء أداةالنموذج يفوِّض مهمةحدث في Claude Code (ما قبل الأداة، ما بعد التعديل)
يعيش في.claude/skills/خادم خارجي (stdio أو SSE).claude/agents/كتلة hooks في settings.json
الأفضل لـسير العمل المتكررة، قوالب الطلبات ذات المنطقالبيانات الحية، APIs الخارجية، الوصول للملفات خارج cwdالتخطيط متعدد الخطوات، العمل المتوازي، السياقات المعزولةالأحداث الحتمية التي يجب أن تُطلق دائماً
الحتميةاحتمالية (Claude يختار)احتمالية (Claude يختار)احتمالية (Claude يختار)حتمية (تُطلق دائماً)
تكلفة الرموزمنخفضة (فقط description يُحمَّل عند الفحص)متوسطة-عالية (تعريفات الأدوات + الردود)عالية (سياق جديد لكل تفويض)لا شيء (تنفيذ shell خارجي)
متى لا تستخدمالبيانات الحية، الأحداث الحتميةسير العمل الثابتة، منطق الطلباتالإجراءات الحتمية أحادية الخطوةالمنطق المتفرع، أي شيء احتمالي

تتآلف هذه الأدوات. يمكن لمهارة استدعاء أداة MCP عبر allowed-tools. يمكن لخطاف أن يُطلق بعد اكتمال مهارة. يمكن لوكيل فرعي استخدام المهارات الممنوحة له. النموذج الذهني الأوضح: اختر الطبقة الصحيحة أولاً، ثم دعها تتراص. المهارات هي عنصر هندسة السياق الذي تلجأ إليه حين تريد سير عمل يختار Claude تفعيلها؛ وتؤتمت مع الخطافات حين تريد شيئاً لا يستطيع Claude تجاوزه.

أسوأ طريقة لإساءة استخدام كل منها: المهارات للبيانات الحية (استخدم MCP)؛ MCP لقوالب الطلبات أحادية الاستخدام (استخدم المهارات)؛ الوكلاء الفرعيون لتعديلات الملفات الحتمية (استخدم الخطافات)؛ الخطافات للمنطق المتفرع (استخدم المهارات). المهارات سير عمل، MCP بيانات، الوكلاء الفرعيون خطط، الخطافات أحداث. اختر بالطبقة لا بالمصطلح.

أين تعيش المهارات: الشخصي، المشروع، الإضافة، المؤسسة

تُثبَّت مهارات Claude في أربعة نطاقات: الشخصي (~/.claude/skills/، لك وحدك)، المشروع (.claude/skills/ في جذر المستودع، فريقك عبر git)، الإضافة (موزَّعة عبر سوق Anthropic أو أي رابط إضافة)، والمؤسسة (تدفعها تقنية المعلومات عبر MDM/سياسة المشرف). يفحص Claude الأربعة عند الإقلاع.

النطاقالمسارالمشاركةالأنسب لـ
الشخصي~/.claude/skills/غير مشتركسير عملك اليومية (commit، review، PR-write)
المشروع.claude/skills/ (جذر المستودع)git، كل مساهماصطلاحات الفريق، الأنماط الخاصة بقاعدة الكود
الإضافةتُثبَّت عبر /plugin install <url>سوق Anthropic أو رابطإعادة الاستخدام عبر المستودعات، التوزيع على المجتمع
المؤسسةيدفعها مشرف المؤسسة (إعدادات مُدارة)مُطبَّقة على مستوى المؤسسةسير العمل المفروضة للامتثال، الأدوات المقيَّدة أمنياً
المدمجة (مُرفقة)تأتي مع Claude Codeلامهارات المستندات (pdf, docx, pptx, xlsx)، /debug، /simplify

المهارات المستندية المدمجة سهل نسيانها — Claude Code يأتي مسبقاً بمهارات pdf وdocx وpptx وxlsx، إضافة إلى مكتبة صغيرة من /debug و/simplify وما شابهها. (الأداة الشقيقة Claude Design تأتي بمهارات سير عمل مدمجة لتوليد التصميم؛ نفس النموذج، مجال مختلف.)

متى تشحن عبر إضافة بدلاً من المشروع؟ الإضافات تفوز حين يستفيد نفس سير العمل من مستودعات متعددة — مهارة /release تستخدمها عبر خمسة مستودعات تنتمي لإضافة، لا نسخها في .claude/skills/ لكل مستودع. مهارات المشروع تفوز للاصطلاحات الخاصة بقاعدة الكود (قالب PR لفريقك، مشغِّل الاختبار المخصص). سوق Anthropic، مع /plugin install من أي رابط، يجعل الإضافات الخيار الأمثل لإعادة الاستخدام عبر المستودعات. وفق توثيق الإضافات، الاكتشاف والتحديثات تلقائية.

مخطط معمارية Claude Code يُظهر أربع طبقات: المهارات (قوالب سير العمل)، MCP (طائرة البيانات)، الوكلاء الفرعيون (التفويض)، الخطافات (الأحداث). أسهم تُشير إلى كيفية تكاملها في وقت التشغيل.

الأنماط المتقدمة: $ARGUMENTS والحقن الديناميكي للـ Shell وcontext: fork

ثلاثة أنماط متقدمة في المهارات تستحق الاهتمام: $ARGUMENTS يتيح للمستخدمين تمرير معاملات للمهارات القابلة للاستدعاء (/translate $ARGUMENTS)؛ الحقن الديناميكي للـ shell (مع allowed-tools: Bash(...)) يتيح للمهارة تشغيل سكريبتات وتمرير مخرجاتها إلى السياق؛ وcontext: fork (Skills 2.0) يُشغِّل المهارة في نافذة سياق معزولة. ورقة الدليل الشامل من Anthropic هي المرجع الرسمي لـ context: fork اعتباراً من مايو 2026.

$ARGUMENTS للمهارات ذات المعاملات

yaml
---
name: Translate
description: Translate the most recent message into the target language.
user-invocable: true
argument-hint: <target-language, e.g. spanish, japanese, brazilian portuguese>
---

Translate the user's previous message into $ARGUMENTS. Preserve tone,
preserve markdown formatting, return only the translation.

طلب الاختبار: /translate spanish. يستبدل Claude spanish بـ $ARGUMENTS في وقت التشغيل. أنظف طريقة لجعل المهارة متعددة الأغراض دون كتابة نسخ متعددة.

الحقن الديناميكي للـ shell عبر allowed-tools

yaml
---
name: Review last commit
description: Use when the user wants a code review of the last git commit.
allowed-tools: ["Bash(git diff HEAD~1:*)", "Bash(git log -1:*)"]
---

Run `git diff HEAD~1` and `git log -1`. Review the diff for bugs, security
issues, and style violations. Output a 5-bullet review.

تُشغِّل المهارة shell، تمرر diff في السياق، وتراجعه. قيِّد allowed-tools بأوامر محددة (Bash(git diff HEAD~1:*)), لا Bash مجرداً — إذن Bash المجرد هو النسخة الخطرة أمنياً من هذا النمط.

context: fork (Skills 2.0)

yaml
---
name: Deep research
description: Use when the user wants a multi-source research summary on a topic.
context: fork
---

Research the topic in $ARGUMENTS using available web tools. Produce a
2-page summary with citations. Do not pollute the main thread.

الـ Fork يمنح المهارة نافذة سياق خاصة بها، لكي لا تتسرب 50 ألف رمز من ملاحظات البحث الوسيطة إلى جلستك الرئيسية. مفيد للبحث الطويل، تخطيط إعادة الهيكلة الكبيرة، أو أي شيء ينتج رموزاً مؤقتة كثيرة. متاح في Skills 2.0 فقط — الإصدارات القديمة من Claude Code تتجاهل هذا الحقل.

استكشاف الأخطاء: لماذا لا تُفعَّل مهارتك؟

عادةً تفشل المهارات في التفعيل لأحد أربعة أسباب: (1) description عام جداً لا يستطيع Claude مطابقته مع طلبك، (2) المجلد في مسار خاطئ (.claude/skills/ لا claude/skills/)، (3) لم تُعِد تشغيل Claude Code بعد إضافة المهارة (قبل Skills 2.0 فقط)، أو (4) اسم المهارة يتعارض مع مهارة مدمجة أو ذات أولوية أعلى. وفق أكثر أوضاع الفشل بحثاً في متتبع مشاكل Claude Code على GitHub، هذه الأربعة تغطي ~95% من تقارير "لماذا لا يعمل هذا".

وضع الفشل 1: "مهارتي لا تظهر أصلاً"

السبب الأول هو المسار الخاطئ — .claude/skills/ (بنقطة) مقابل claude/skills/ (بدون نقطة) خطأ مطبعي ارتكبناه جميعاً في منتصف الليل. شغِّل ls -la ~/.claude/skills/ للتأكد من وجود المجلد بالنقطة. إن كان موجوداً ولا يزال Claude لا يراه، أعد تشغيل Claude Code مرة واحدة. الإصدارات القديمة من Skills 2.0 تفحص عند الإقلاع فقط.

وضع الفشل 2: "Claude لا يُفعِّل مهارتي تلقائياً"

حقل description غامق للغاية أو كُتب للبشر لا لـ Claude. أعد كتابته بعبارات تشغيل واضحة تعكس أسلوب طلبات المستخدمين الفعلية. بعد بناء 4 مهارات لهذا المستودع، الخطأ الذي وقعت فيه كان ترك أوصاف كـ "مهارة مفيدة لـ SEO". عديمة الفائدة. أعد الكتابة إلى: "Use when the user wants to add JSON-LD schema, meta tags, or SEO frontmatter to a Markdown post." ارتفعت دقة التفعيل من ~30% إلى ~95%. دقة التفعيل تُحدَّد بحقل description. اكتبه لـ Claude، لا لسيرتك الذاتية.

وضع الفشل 3: "اقتُطع الوصف في قائمة أوامر الشرطة"

إما أن description تجاوز 1024 حرفاً أو name تجاوز 64 حرفاً. كلاهما له حد صارم. الحل: قسِّم المهارة إلى مهارتين أضيق، أو انقل التفاصيل الطويلة إلى جسم SKILL.md. الواجهة للتوجيه، لا للتوثيق.

وضع الفشل 4: "كشف التغييرات الحي لا يعمل"

Claude Code قبل Skills 2.0 يتطلب إعادة تشغيل كاملة بعد أي تعديل على SKILL.md. إن كنت تكرر تطوير مهارة ولا تظهر تغييراتك، فأنت على الأرجح على إصدار قديم. إما الترقية إلى إصدار Claude Code يأتي مع Skills 2.0 (الاكتشاف الحي) أو تعوَّد إعادة التشغيل بعد كل حفظ. مزعج، لكن غير مكلف.

المهارات خارج Claude: معيار Agent Skills المفتوح

نعم — المهارات معيار مفتوح. معيار Agent Skills على agentskills.io يُعرِّف تنسيق SKILL.md بشكل مستقل عن أي بائع. اعتمد Codex CLI من OpenAI وChatGPT Desktop هذا المعيار في ديسمبر 2025؛ نفس SKILL.md الذي تكتبه لـ Claude Code يعمل في Codex مع تعديلات طفيفة في الواجهة.

إليك مصفوفة دعم الأدوات حتى مايو 2026: Claude Code له دعم كامل لـ Agent Skills (التطبيق المرجعي). Codex CLI من OpenAI له دعم كامل. ChatGPT Desktop له دعم جزئي — name وdescription والجسم تعمل، لكن تعادل allowed-tools لم يكتمل بعد. أعلن Gemini CLI عن دعمه في مطلع 2026 لكنه لم يشحن حتى وقت كتابة هذا المقال. Cursor هو الاستثناء — يستخدم تنسيق Cursor rules الخاص به ولا يقرأ SKILL.md نواةً، وإن وُجدت shims مجتمعية.

ما تكتبه اليوم ليعمر سنة: أبقِ name وdescription نظيفَين ومستقلَّين عن أي بائع. عزِّل أي واجهة خاصة بالبائع خلف namespace (claude: أو codex:) إن ذهبت عبر الأدوات. السطح المحمول — name، description، الجسم، $ARGUMENTS — يعمل في كل مكان؛ الحقول المتقدمة كـ context: fork خاصة بـ Claude حتى يشحن بائعون آخرون ما يعادلها. تدفع Anthropic أيضاً نحو تكامل أعمق مع السوق وفق خريطة الطريق المسرَّبة لـ Claude Code، لذا قابلية النقل ستزداد سهولة فقط.

الأماكن الثلاثة للعثور على أمثلة مهارات: anthropics/skills (رسمي)، awesome-claude-skills (مجتمعي)، وagentskills.io (صفحة مواصفات المعيار). المهارات لم تعد ميزة Claude. إنها معيار مفتوح أطلقه Claude أولاً.

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

ما الفرق بين مهارة Claude وخادم MCP؟

مهارة Claude هي ملف SKILL.md يحتوي تعليمات سير عمل يُحمِّلها Claude حين يتطابق طلبك مع وصفها. خادم MCP هو عملية منفصلة يستدعيها Claude لجلب بيانات حية (قواعد بيانات، APIs، أنظمة ملفات خارج مجلد العمل). استخدم المهارات لسير العمل؛ استخدم MCP للبيانات. يمكن للمهارات استدعاء أدوات MCP.

هل مهارات Claude مجانية؟

نعم — المهارات ميزة مدمجة في Claude Code، لا رسوم إضافية. تدفع فقط مقابل رموز النموذج المُستهلكة حين تعمل مهارة. المهارات التي تثبِّتها من سوق Anthropic قد تكون مدفوعة (نادرة اليوم)، لكن المستودع الرسمي anthropics/skills والقوائم المجتمعية كلها مجانية للنسخ والاستخدام.

أين تُثبَّت مهارات Claude؟

المهارات الشخصية في ~/.claude/skills/{skill-name}/، ومهارات المشروع في .claude/skills/{skill-name}/ في جذر المستودع. المهارات الإضافية تُثبَّت عبر /plugin install <url> وتعيش في مجلد الإضافات. المهارات المؤسسية تدفعها تقنية المعلومات في مؤسستك عبر الإعدادات المُدارة. يفحص Claude Code الأربعة عند الإقلاع.

كيف أنشئ مهارة Claude من الصفر؟

أنشئ مجلداً في ~/.claude/skills/، أضف ملف SKILL.md بواجهة YAML (name، description) يتبعها تعليمات سير العمل، وأعد تشغيل Claude Code. أسرع طريق: افتح Claude Code واطلب منه تفعيل مهارة skill-creator المدمجة — ستبني SKILL.md لك في أقل من دقيقة.

لماذا لا تُفعَّل مهارتي؟

أكثر أربعة أسباب شيوعاً: (1) description غامض جداً لـ Claude لمطابقته مع طلبك — أعد كتابته بعبارات تشغيل واضحة؛ (2) المهارة في المسار الخاطئ (.claude/skills/ لا claude/skills/)؛ (3) Claude Code يحتاج إعادة تشغيل على الإصدارات قبل Skills 2.0؛ (4) اسم المهارة يتعارض مع مهارة مدمجة. تحقق بـ ls -la ~/.claude/skills/.

هل يمكن لـ ChatGPT أو Cursor استخدام مهارات Claude؟

ChatGPT Desktop وCodex CLI يدعمان نفس معيار Agent Skills مثل Claude — نفس SKILL.md يعمل في كليهما مع تعديلات طفيفة في الواجهة. Cursor يستخدم تنسيق Cursor rules الخاص به ولا يقرأ SKILL.md نواةً. أعلن Gemini CLI عن دعمه في مطلع 2026 لكنه لم يشحن حتى مايو 2026.

ما هي مهارة skill-creator؟

skill-creator هي ميتا-مهارة مُرفقة في مستودع anthropics/skills تساعد Claude على كتابة ملفات SKILL.md جديدة لك. أخبر Claude بما تريد أن تفعله المهارة؛ ستجري معك skill-creator مقابلة للوصف، تختار allowed-tools المناسبة، وتكتب SKILL.md في المجلد الصحيح. أسرع scaffold ممكن.

ما الذي يفعله disable-model-invocation؟

ضبط disable-model-invocation: true في واجهة مهارتك يمنع Claude من تفعيلها تلقائياً بناءً على مطابقة الطلبات. تصبح المهارة قابلة للاستدعاء من المستخدم فقط — تظهر في قائمة أوامر الشرطة كـ /skill-name وتعمل فقط حين تستدعيها صراحةً. استخدمها للإجراءات المدمِّرة أو الحتمية مثل /commit أو /deploy.


ابنِ بضع مهارات، اشحنها في مشروع، وانظر ما يستمر. إن كان فريقك يعاني من أخطاء "المهارة لا تُفعَّل" عبر مستودعات متعددة وتريد رأياً ثانياً في إعداد .claude/skills/، تواصل معنا — يسعدنا مراجعته معك.

الوسوم

claude skillsclaude codeSKILL.mdagent skills standardMCPدليل claude

شارك هذا المقال

مقالات ذات صلة

المزيد في ai-machine-learning

ai-machine-learning
Aug 4, 2026

مراجعة Gitar للذكاء الاصطناعي: ماذا اشترت Sonar فعليًا؟ (تقييم 2026)

استحوذت Sonar على Gitar في 21 مايو 2026. تغطي هذه المراجعة ما تفعله ميزة الإصلاح التلقائي المُتحقَّق منها عبر CI فعليًا، وباقتي 20 و40 دولارًا، والحالات التي تتفوق فيها Gitar على CodeRabbit وGreptile، والأسباب الصادقة لتجاوزها.

10 دقائق قراءة قراءة
اقرأ
ai-machine-learning
Aug 3, 2026

أفضل ممارسات استدعاء الأدوات للوكلاء: لماذا يختار وكيلك الأداة الخطأ

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

14 دقيقة قراءة قراءة
اقرأ
ai-machine-learning
Aug 3, 2026

RAG أم الضبط الدقيق: متى تستخدم كلا منهما (بأرقام حقيقية)

RAG يسترجع الحقائق وقت الاستعلام، والضبط الدقيق يثبّت المعرفة داخل أوزان النموذج. دراسة arXiv استُشهد بها 162 مرة شغّلت كلا النهجين على المهمة نفسها، والفائز يفاجئ معظم الفرق. إليك إطار القرار مع حسابات تكلفة حقيقية بالأسعار المعلنة.

14 دقيقة قراءة قراءة
اقرأ
عرض جميع المقالات
ابدأ مشروعك

هل أنت مستعد لبناء شيء استثنائي؟

دعنا نحول رؤيتك إلى واقع. فريقنا جاهز لمساعدتك في إنشاء برمجيات تصنع الفرق.

احجز مكالمة استكشاف لمدة 30 دقيقةشاهد أعمالنا

الأحدث من المكتبة

Claude Skills

عرض الكل
  • New Post

    Full SEO blog pipeline: research, brief, write, validate, image, translate, publish to Sanity. Autonomous from start to finish.

  • Content Refresh

    Audit a stale post, find decay drivers, and ship a SERP-aligned refresh without losing existing rankings.

  • SEO Audit

    Site-wide SEO audit with prioritized fix list: technical, on-page, and EEAT signals.

أتمتة الذكاء الاصطناعي

عرض الكل
  • مُدقّق الأمن

    فحص SCA وIaC أسبوعي مع PRs إصلاح مرتّبة الأولوية.

  • كاتب البريد البارد

    ينشئ رسائل أول تواصل مبنية على تفصيل عام واحد محدّد.

  • وكيل بحث العملاء المحتملين

    يثري بريداً إلكترونياً إلى ملف، ويقيّم الملاءمة، وينبّه في Slack.

الأحدث من المكتبة

Claude Skills

عرض الكل
  • New Post

    Full SEO blog pipeline: research, brief, write, validate, image, translate, publish to Sanity. Autonomous from start to finish.

  • Content Refresh

    Audit a stale post, find decay drivers, and ship a SERP-aligned refresh without losing existing rankings.

  • SEO Audit

    Site-wide SEO audit with prioritized fix list: technical, on-page, and EEAT signals.

أتمتة الذكاء الاصطناعي

عرض الكل
  • مُدقّق الأمن

    فحص SCA وIaC أسبوعي مع PRs إصلاح مرتّبة الأولوية.

  • كاتب البريد البارد

    ينشئ رسائل أول تواصل مبنية على تفصيل عام واحد محدّد.

  • وكيل بحث العملاء المحتملين

    يثري بريداً إلكترونياً إلى ملف، ويقيّم الملاءمة، وينبّه في Slack.

الخدمات

  • حلول المؤسسات
  • تطبيقات الجوال
  • تطبيقات الويب

الحلول

  • أنظمة إدارة علاقات العملاء
  • تكامل الذكاء الاصطناعي
  • حلول تخطيط الموارد
  • المساعدون الصوتيون
  • أتمتة العمليات
  • الأمن السيبراني

المكتبة

  • المدونة
  • أعمالنا

المجتمع

  • أتمتة الذكاء الاصطناعي
  • Claude Skills

الأدوات

  • حاسبة تكلفة تطبيق الجوال
  • حاسبة تكلفة OpenAI / LLM API
  • حاسبة تكلفة MVP
  • حاسبة تكلفة الوكيل الصوتي بالذكاء الاصطناعي

الشركة

  • من نحن
  • الشركاء
  • اتصل بنا

قانوني

  • سياسة الخصوصية
  • شروط الخدمة
  • سياسة ملفات تعريف الارتباط

الخدمات

  • حلول المؤسسات
  • تطبيقات الجوال
  • تطبيقات الويب

الحلول

  • أنظمة إدارة علاقات العملاء
  • تكامل الذكاء الاصطناعي
  • حلول تخطيط الموارد
  • المساعدون الصوتيون
  • أتمتة العمليات
  • الأمن السيبراني

المكتبة

  • المدونة
  • أعمالنا

المجتمع

  • أتمتة الذكاء الاصطناعي
  • Claude Skills

الأدوات

  • حاسبة تكلفة تطبيق الجوال
  • حاسبة تكلفة OpenAI / LLM API
  • حاسبة تكلفة MVP
  • حاسبة تكلفة الوكيل الصوتي بالذكاء الاصطناعي

الشركة

  • من نحن
  • الشركاء
  • اتصل بنا
قانونيسياسة الخصوصيةشروط الخدمةسياسة ملفات تعريف الارتباط
TECHSY
© 2026 Techsy. جميع الحقوق محفوظة.