الإجابة المختصرة
- 1ضع مجلد المهارة في
~/.claude/skills/لاستخدامها في جميع المشاريع، أو في.claude/skills/لحصرها في مستودع واحد. - 2هل تثبّت باستخدام Skillry CLI؟ أضف
--agent claude-code. بدونه، توضع المهارة في~/.agents/skills/، وهو مجلد لا يقرأه Claude Code. - 3اكتب
/skillsللتأكد من وجودها، ثم اكتب/skill-nameمتبوعاً بطلبك لتشغيلها. - 4تبحث عن مهارات جاهزة؟ تصفح مهارات Claude Code التي يمكنك تثبيتها بأمر واحد.
كيفية إضافة مهارات إلى Claude Code
يمكنك لصق موجّه تثبيت في Claude Code، أو تشغيل Skillry CLI بنفسك، أو نسخ المجلد يدوياً. تؤدي الطرق كلها إلى النتيجة نفسها: وجود مجلد المهارة داخل ~/.claude/skills/.
الخيار الذي يغفل عنه كثيرون
يثبّت Skillry CLI في ~/.agents/skills/ افتراضياً لأن Codex وCursor يقرآن هذا المجلد. أما Claude Code فيقرأ مجلده الخاص ~/.claude/skills/. إذا أغفلت --agent claude-code، سيظل التثبيت يعلن نجاحه، لكن Claude Code لن يرى المهارة.
- 1
افتح المهارة على Skillry، واختر نسخ موجّه التثبيت، ثم اختر نسخ في مربع الحوار.
- 2
الصقه في Claude Code وأرسله. يقرأ الوكيل تعليمات التثبيت من Skillry ويشغّل الأمر المناسب بنفسه.
موجّه التثبيت Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill. - 3
عندما يطلب المتصفح الموافقة على رمز الجهاز، وافق عليه.
يُفترض أن ترى: أن يذكر Claude Code الإصدار الذي ثبّته والمجلد الذي استخدمه ضمن
~/.claude/skills/.
- 1
سجّل الدخول مرة واحدة. ستفتح نافذة متصفح تعرض رمز جهاز لتوافق عليه.
الطرفية npx --yes skillry-cli@latest login - 2
ثبّت المهارة مع إضافة
--agent claude-codeفي النهاية.الطرفية npx --yes skillry-cli@latest install <slug> --agent claude-codeيُفترض أن ترى:
Installed <slug> <version> to ~/.claude/skills/<slug>
اختر تنزيل ZIP في صفحة المهارة، أو استخدم مجلد مهارة حصلت عليه من مصدر آخر. اقرأ SKILL.md وما في scripts/ قبل التثبيت، لأن الوكيل يتبع هذه التعليمات ويمكنه تشغيل تلك السكربتات. ثم انقل المجلد كاملاً:
mkdir -p ~/.claude/skills
mv ~/Downloads/my-skill ~/.claude/skills/غالباً ما يُنشئ فك ZIP مستوى إضافياً، مثل my-skill/my-skill/SKILL.md. يجب أن يكون SKILL.md داخل مجلد المهارة مباشرة، وإلا فلن يجدها الوكيل.

تأكد من أن Claude Code يرى المهارة
اكتب /skills. تعرض القائمة مهاراتك وبعض المهارات المضمنة في Claude Code، مثل /code-review. اضغط t لترتيبها بحسب مقدار السياق الذي تشغله كل مهارة.
لا تحتاج إلى إعادة التشغيل. يلتقط Claude Code المهارات الجديدة والمعدّلة في الجلسة الحالية. الاستثناء الوحيد: إذا لم يكن ~/.claude/skills/ موجوداً عند بدء الجلسة، شغّل /reload-skills مرة واحدة.
تشغيل مهارة بأمر شرطة مائلة في Claude Code
تظهر كل مهارة تثبّتها كأمر شرطة مائلة يحمل اسمها. اكتب الأمر ثم اذكر ما تريده في السطر نفسه:
/launch-page Parcelo, a parcel-tracking dashboard for small online shopsيصل كل ما بعد الاسم إلى المهارة عبر $ARGUMENTS. بعد التأكد من أنها تعمل، يمكنك عادة تجاوز الأمر ووصف المهمة بالكلمات العادية. يحمّل Claude المهارة تلقائياً عندما يطابق طلبك وصفها. تجد المزيد عن تحسين النتائج في كيفية استخدام المهارات.
أين يبحث Claude Code عن المهارات، وأي نسخة لها الأولوية؟
يجمع Claude Code المهارات من خمسة أماكن. يستخدم معظم الناس المجلدين الشخصي والخاص بالمشروع فقط؛ أما البقية فتظهر في العمل الجماعي أو عند تثبيت الإضافات.
| المصدر | الموقع | الأمر |
|---|---|---|
| المؤسسة | إعدادات مُدارة | /skill-name |
| شخصي | ~/.claude/skills/<name>/ | /skill-name |
| المشروع | .claude/skills/<name>/ | /skill-name |
| إضافة | <plugin>/skills/<name>/ | /plugin-name:skill-name |
| حسابك على claude.ai | تتم المزامنة إلى ~/.claude/skills/synced/ | /name أو /anthropic-skills:name |
عندما يوجد الاسم نفسه في مكانين، تتقدم نسخة المؤسسة على الشخصية، والشخصية على نسخة المشروع. تُحمّل مهارات .claude/skills/ في المجلد الفرعي عندما يعمل Claude لأول مرة مع ملفات ذلك المجلد؛ وهكذا لا تزاحم مهارات حزمة واحدة في مستودع كبير بقية العمل قبل الحاجة إليها.
إعدادات SKILL.md التي تتحكم في وقت التشغيل
توضع هذه الحقول في الترويسة أعلى SKILL.md. تحتاج إليها فقط عندما تعمل المهارة أكثر من اللازم، أو أقل من المطلوب، أو تتوقف لطلب الإذن في كل خطوة.
| الحقل في SKILL.md | وظيفته |
|---|---|
description | ما يقرأه Claude ليقرر استخدام المهارة. يُختصر مع when_to_use إلى 1,536 حرفاً في قائمة المهارات. |
allowed-tools | الأدوات التي يمكن لـClaude استخدامها دون سؤال، خلال الدور الذي يستدعي المهارة. |
paths | أنماط الملفات. لا يحمّل Claude المهارة تلقائياً إلا عند العمل مع ملفات مطابقة. |
مهارة Claude Code لا تعمل؟ افحص هذه الأمور أولاً
ابدأ من أعلى القائمة. السبب الأكثر شيوعاً هو الصف الأول: وجود المهارة في المجلد الخطأ.
غير موجودة في /skills
المجلد خطأ، أو يوجد مستوى إضافي بعد فك ZIP. انقلها ليصبح المسار ~/.claude/skills/<name>/SKILL.md، أو أعد التثبيت باستخدام --agent claude-code.
المجلد أُنشئ للتو
شغّل /reload-skills.
غير موجودة في جلسة سحابية
أضفها إلى .claude/skills/ في المستودع وثبّت التغيير، أو فعّلها على claude.ai.
غير موجودة في Cowork
فعّلها في حسابك على claude.ai.
مدرجة ولكن لا تُختار أبداً
استدعها باستخدام /name للتأكد من أنها تعمل، ثم اجعل وصفها أكثر تحديداً. راجع تشغيل المهارات.
تجد بقية الحالات في استكشاف الأخطاء وإصلاحها.
أسئلة شائعة
هل تعمل المهارات في Claude Code؟
نعم. يتبع Claude Code معيار Agent Skills المفتوح، ويحمّل المهارات من مجلدك الشخصي والمشروع الحالي والإضافات ومؤسستك وحسابك على claude.ai.
أين تُخزن مهارات Claude Code؟
توضع مهاراتك الشخصية في ~/.claude/skills/<name>/SKILL.md. وتوضع مهارات مشروع واحد في .claude/skills/<name>/SKILL.md داخل ذلك المستودع.
ماذا حدث لأوامر الشرطة المائلة المخصصة؟
ما زالت تعمل. الملف .claude/commands/deploy.md والمهارة المسماة deploy يتيحان كلاهما /deploy. إذا وجدا معاً، تكون الأولوية للمهارة.
لماذا يحتاج Skillry CLI إلى --agent claude-code؟
مجلده الافتراضي هو ~/.agents/skills/ الذي يتشاركه Codex وCursor. يقرأ Claude Code بدلاً منه ~/.claude/skills/، ويوجه هذا الخيار التثبيت إلى ذلك المجلد.
المصادر
هل ساعدك هذا الدليل؟
