# دليل مهارات Claude Code (SKILL.md) > **آخر تحقق**: 2026-10-20 · 📄 وفق الوثائق الرسمية (Claude Code Skills) المهارة ملف `SKILL.md`: بيانات YAML أمامية بين علامتي `---` تخبر Claude متى يستخدمها، إضافةً إلى تعليمات Markdown يتبعها Claude عند تشغيلها. يستخدم Claude المهارات عندما تكون ذات صلة، أو يمكنك استدعاء إحداها مباشرةً عبر `/skill-name`. المهارات مكوّنات في طبقة المعرفة داخل Claude Code توفّر لـ Claude خبرة وإرشادًا في مجالات محددة. ويحمّلها Claude تلقائيًا عند الحاجة، ويمكنك أيضًا استدعاء إحداها مباشرةً عبر `/skill-name`. ## ما هي المهارات؟ المهارات وحدات معرفية احترافية مخزّنة في ملفات `SKILL.md`: - **التفعيل التلقائي**: يستخدم Claude المهارات ذات الصلة تلقائيًا بناءً على سياق المهمة - **المعرفة المتخصصة**: توفّر أفضل الممارسات والإرشادات لمجالات محددة - **قابلة للتوسعة**: أنشئ مهارات مخصصة لتلبية احتياجات محددة - **مدركة للسياق**: تُستدعى فقط في السيناريوهات ذات الصلة ### المهارات مقابل الأوامر مقابل الوكلاء | المكوّن | المُشغّل | الغرض | |-----------|---------|---------| | **الأوامر** | يستدعيها المستخدم يدويًا (`/command`) | تنفيذ مهام محددة | | **المهارات** | تُفعّل تلقائيًا أو عبر `/skill-name` | توفير معرفة متخصصة | | **الوكلاء** | استدعاءات مُفوّضة | التعامل مع سير عمل معقد | ### المهارات والأوامر وCLAUDE.md (تم التحقق في 2026-10-20) تتبع مهارات Claude Code معيار Agent Skills المفتوح، الذي يعمل عبر أدوات ذكاء اصطناعي متعددة. جرى دمج الأوامر المخصصة في المهارات: إذ ينشئ كل من ملف في `.claude/commands/deploy.md` ومهارة في `.claude/skills/deploy/SKILL.md` الأمر `/deploy`، ويعملان بالطريقة نفسها. وخلافًا لمحتوى `CLAUDE.md`، لا يُحمّل متن المهارة إلا عند استخدامها، لذا فإن المواد المرجعية الطويلة لا تكاد تكلّف شيئًا إلى أن تحتاجها. ## استخدام المهارات المدمجة تتضمن إضافات Claude Code عادةً عدة مهارات مدمجة. وعندما تتطابق مهمتك مع وصف مهارة، يستخدمها Claude تلقائيًا. يتضمن Claude Code أيضًا مجموعة من المهارات المرفقة، مثل `/doctor` و`/code-review` و`/batch` و`/debug` و`/loop` و`/claude-api` (تم التحقق في 2026-10-20). وتستدعي مهارة مرفقة بالطريقة نفسها كأي مهارة أخرى: اكتب `/` متبوعًا باسم المهارة. ### مثال: مراجعة الشيفرة عندما تقول «ساعدني في مراجعة هذه الشيفرة بحثًا عن مشكلات أمنية»، فإذا كانت إضافة تتضمن مهارة مراجعة أمنية مثبّتة، فسيطبّق Claude معرفة تلك المهارة تلقائيًا للمراجعة. ### عرض المهارات المتاحة تُثبّت المهارات عادةً مع الإضافات: ```bash # Install plugin (plugins may contain multiple Skills) /plugin install plugin-name@marketplace ``` ## إنشاء مهارات مخصصة ### البنية الأساسية لا تحتاج أبسط مهارة إلا إلى ملف `SKILL.md`: ```bash my-skill/ └── SKILL.md ``` ### تنسيق SKILL.md ```markdown --- name: Code Style Guide description: Use this skill when the user asks about "code style", "naming conventions", "code formatting", or discusses coding standards --- # Code Style Guide ## Naming Conventions - Variables use camelCase - Constants use UPPER_SNAKE_CASE - Classes use PascalCase - Private members use underscore prefix ## Formatting Rules - Use 2 spaces for indentation - Line width should not exceed 80 characters - Use trailing commas ## Best Practices - Functions should have single responsibility - Avoid deep nesting - Use meaningful variable names ``` ### حقول البيانات الأمامية جميع الحقول اختيارية. يُوصى بحقل `description` فقط، حتى يعرف Claude متى يستخدم المهارة؛ ويمكن حذف `name`، وتكون قيمته الافتراضية اسم الدليل. يجب أن يطابق اسم الحقل مرجع البيانات الأمامية الرسمي تمامًا، بما في ذلك الشرطات (يسرد الجدول أدناه الحقول الشائعة فقط؛ كما تغطي الوثائق الرسمية `model` و`effort` و`hooks` و`user-invocable` وغيرها): يتجاهل Claude Code أي حقل لا يتعرف عليه دون الإبلاغ عن خطأ (تم التحقق في 2026-10-20). | الحقل | مطلوب | الوصف | |-------|----------|-------------| | `name` | لا | اسم الأمر الظاهر في قائمة `/`؛ القيمة الافتراضية هي اسم الدليل | | `description` | موصى به | ما تفعله المهارة ومتى تُستخدم؛ يستخدم Claude هذا لتحديد وقت تطبيق المهارة | | `when_to_use` | لا | سياق إضافي يوضح متى ينبغي أن يستدعي Claude المهارة، مثل عبارات التفعيل أو أمثلة على الطلبات؛ يُضاف إلى `description` في قائمة المهارات | | `argument-hint` | لا | تلميح يظهر أثناء الإكمال التلقائي لبيان الوسائط المتوقعة، مثل `[issue-number]` أو `[filename] [format]` | | `disable-model-invocation` | لا | اضبطه على `true` لمنع Claude من تحميل هذه المهارة تلقائيًا؛ استخدمه في مسارات العمل التي تشغّلها يدويًا باستخدام `/name` | | `allowed-tools` | لا | الأدوات التي يمكن لـ Claude استخدامها دون طلب إذن خلال الدور الذي يستدعي هذه المهارة | | `paths` | لا | أنماط Glob التي تقيّد وقت تفعيل هذه المهارة، بحيث لا يحمّلها Claude تلقائيًا إلا عند العمل بملفات مطابقة | | `context` | لا | اضبطه على `fork` للتشغيل في سياق وكيل فرعي متفرع | `version` ليس حقلًا في هذا الجدول: يتجاهل Claude Code أي حقل لا يتعرف عليه، دون الإبلاغ عن خطأ (تم التحقق في 2026-10-20). ### كتابة أوصاف فعّالة يحدد حقل description وقت تفعيل المهارة، وينبغي أن يتضمن عبارات تفعيل محددة: **مثال جيد**: ```yaml description: Use this skill when the user asks to "create a hook", "add a PreToolUse hook", "validate tool use", or mentions hook events ``` **مثال سيئ**: ```yaml description: Guide about hooks # Too vague ``` ## بنية المهارة الكاملة للمهارات المعقدة، يمكنك تضمين مزيد من الموارد: ```bash my-skill/ ├── SKILL.md # Main knowledge document ├── references/ # Detailed references │ ├── patterns.md # Design patterns │ └── advanced.md # Advanced techniques ├── examples/ # Example code │ ├── basic.ts # Basic example │ └── advanced.ts # Advanced example └── scripts/ # Helper scripts └── validate.sh # Validation script ``` ### الإشارة إلى الموارد أشِر إلى موارد أخرى في SKILL.md: ```markdown --- name: API Development Guide description: Use when the user asks about "API design", "REST interfaces", "API best practices" --- # API Development Guide See @references/patterns.md for detailed API design patterns ## Quick Example See @examples/basic.ts for basic usage ``` ### حقن السياق الديناميكي يستخدم سطر مثل `` !`git diff HEAD` `` حقن السياق الديناميكي: يشغّل Claude Code الأمر ويستبدل السطر بإخراجه قبل أن يرى Claude محتوى المهارة، بحيث تصل التعليمات وقد أُدرج الفرق الحالي فيها مسبقًا (تم التحقق في 2026-10-20). ### مواضع تحميل المهارات - **المهارات الشخصية** توجد في `~/.claude/skills//SKILL.md`. - **مهارات المشروع** توجد في `.claude/skills//SKILL.md` داخل المستودع. - **مهارات الإضافة** توجد في `/skills//SKILL.md` داخل الإضافة. ## استخدام المهارات في الإضافات ### بنية الدليل تُوضع المهارات في دليل `skills/` الخاص بالإضافة: ```bash my-plugin/ ├── .claude-plugin/ │ └── plugin.json ├── commands/ # Command layer ├── agents/ # Agent layer └── skills/ # Knowledge layer ├── code-style/ │ └── SKILL.md └── api-docs/ ├── SKILL.md └── references/ ``` ### الإشارة إلى المهارات في الأوامر يمكن للأوامر الإشارة صراحةً إلى معرفة المهارة: ```markdown --- description: Generate standards-compliant API documentation argument-hint: [api-file] --- Generate API documentation for @$1. Use the api-docs skill to ensure documentation includes: - Complete endpoint descriptions - Parameter specifications - Response formats - Error codes - Usage examples ``` ## أمثلة عملية ### المثال 1: مهارة معايير المشروع ```markdown --- name: Project Standards description: Use when the user asks about "project structure", "file organization", "directory conventions" --- # Project Standards ## Directory Structure \`\`\` src/ ├── components/ # React components ├── hooks/ # Custom Hooks ├── services/ # API services ├── utils/ # Utility functions └── types/ # TypeScript types \`\`\` ## File Naming - Components: PascalCase (e.g., `UserProfile.tsx`) - Utilities: camelCase (e.g., `formatDate.ts`) - Constants: UPPER_SNAKE_CASE (e.g., `API_ENDPOINTS.ts`) ## Import Order 1. React related 2. Third-party libraries 3. Internal modules 4. Type definitions 5. Style files ``` ### المثال 2: مهارة سير عمل Git ```markdown --- name: Git Workflow description: Use when the user asks about "branch strategy", "commit conventions", "Git process" --- # Git Workflow Standards ## Branch Naming - Features: `feature/description` - Fixes: `fix/description` - Hotfixes: `hotfix/description` ## Commit Message Format \`\`\` ():