الجمعة السوداء تبدأ مبكرًا: وفّر 50% على Pro.استكشف الخطط

كيفية إضافة المهارات إلى Claude Code وتشغيلها وإصلاحها

يقرأ Claude Code المهارات من ~/.claude/skills/، وكثير من حالات «ثبّتّها ولم يحدث شيء» سببها وجود المهارة في مكان آخر. إليك كيفية إضافة مهارة من Skillry وتشغيلها بأمر يبدأ بشرطة مائلة والتحكم في وقت تشغيلها.

لمن
مستخدمي Claude Code
الوقت
8 دقائق للإكمال

الإجابة المختصرة

  1. 1ضع مجلد المهارة في ~/.claude/skills/ لاستخدامها في جميع المشاريع، أو في .claude/skills/ لحصرها في مستودع واحد.
  2. 2هل تثبّت باستخدام Skillry CLI؟ أضف --agent claude-code. بدونه، توضع المهارة في ~/.agents/skills/، وهو مجلد لا يقرأه Claude Code.
  3. 3اكتب /skills للتأكد من وجودها، ثم اكتب /skill-name متبوعاً بطلبك لتشغيلها.
  4. 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 لن يرى المهارة.

الأسهل إذا كان Claude Code مفتوحاً بالفعل
  1. 1

    افتح المهارة على Skillry، واختر نسخ موجّه التثبيت، ثم اختر نسخ في مربع الحوار.

  2. 2

    الصقه في Claude Code وأرسله. يقرأ الوكيل تعليمات التثبيت من Skillry ويشغّل الأمر المناسب بنفسه.

    موجّه التثبيت
    Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill.
  3. 3

    عندما يطلب المتصفح الموافقة على رمز الجهاز، وافق عليه.

    يُفترض أن ترى: أن يذكر Claude Code الإصدار الذي ثبّته والمجلد الذي استخدمه ضمن ~/.claude/skills/.

Skillry Skill page for Notion Style OG Image with the Copy install prompt and Download ZIP buttons
خيارا التثبيت في كل صفحة مهارة على Skillry.

تأكد من أن Claude Code يرى المهارة

اكتب /skills. تعرض القائمة مهاراتك وبعض المهارات المضمنة في Claude Code، مثل /code-review. اضغط t لترتيبها بحسب مقدار السياق الذي تشغله كل مهارة.

لا تحتاج إلى إعادة التشغيل. يلتقط Claude Code المهارات الجديدة والمعدّلة في الجلسة الحالية. الاستثناء الوحيد: إذا لم يكن ~/.claude/skills/ موجوداً عند بدء الجلسة، شغّل /reload-skills مرة واحدة.

تشغيل مهارة بأمر شرطة مائلة في Claude Code

تظهر كل مهارة تثبّتها كأمر شرطة مائلة يحمل اسمها. اكتب الأمر ثم اذكر ما تريده في السطر نفسه:

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/، ويوجه هذا الخيار التثبيت إلى ذلك المجلد.

المصادر

هل ساعدك هذا الدليل؟