دليل مهارات Claude Code (SKILL.md)

أنشئ مهارات Claude Code واستخدمها: بنية SKILL.md، وحقول البيانات الأمامية، ومواضع التحميل، والاستدعاء التلقائي والاستدعاء عبر /skill-name، والمهارات المرفقة (2026).

تحتاج مفتاح API؟ أنشئ حسابًا ←·نقاط النهاية وعناوين Base URL ←

آخر تحقق: 2026-10-20 · 📄 وفق الوثائق الرسمية (Claude Code Skills)

المهارة ملف SKILL.md: بيانات YAML أمامية بين علامتي --- تخبر Claude متى يستخدمها، إضافةً إلى تعليمات Markdown يتبعها Claude عند تشغيلها. يستخدم Claude المهارات عندما تكون ذات صلة، أو يمكنك استدعاء إحداها مباشرةً عبر /skill-name.

المهارات مكوّنات في طبقة المعرفة داخل Claude Code توفّر لـ Claude خبرة وإرشادًا في مجالات محددة. ويحمّلها Claude تلقائيًا عند الحاجة، ويمكنك أيضًا استدعاء إحداها مباشرةً عبر /skill-name.

ما هي المهارات؟¶

المهارات وحدات معرفية احترافية مخزّنة في ملفات SKILL.md:

• التفعيل التلقائي: يستخدم Claude المهارات ذات الصلة تلقائيًا بناءً على سياق المهمة

• المعرفة المتخصصة: توفّر أفضل الممارسات والإرشادات لمجالات محددة

• قابلة للتوسعة: أنشئ مهارات مخصصة لتلبية احتياجات محددة

• مدركة للسياق: تُستدعى فقط في السيناريوهات ذات الصلة

المهارات مقابل الأوامر مقابل الوكلاء¶

المهارات والأوامر و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 معرفة تلك المهارة تلقائيًا للمراجعة.

عرض المهارات المتاحة¶

تُثبّت المهارات عادةً مع الإضافات:

# Install plugin (plugins may contain multiple Skills)
/plugin install plugin-name@marketplace

إنشاء مهارات مخصصة¶

البنية الأساسية¶

لا تحتاج أبسط مهارة إلا إلى ملف SKILL.md:

my-skill/
└── SKILL.md

تنسيق SKILL.md¶

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

version ليس حقلًا في هذا الجدول: يتجاهل Claude Code أي حقل لا يتعرف عليه، دون الإبلاغ عن خطأ (تم التحقق في 2026-10-20).

كتابة أوصاف فعّالة¶

يحدد حقل description وقت تفعيل المهارة، وينبغي أن يتضمن عبارات تفعيل محددة:

مثال جيد:

description: Use this skill when the user asks to "create a hook", "add a PreToolUse hook", "validate tool use", or mentions hook events

مثال سيئ:

description: Guide about hooks  # Too vague

بنية المهارة الكاملة¶

للمهارات المعقدة، يمكنك تضمين مزيد من الموارد:

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:

---
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-name>/SKILL.md.
• مهارات المشروع توجد في .claude/skills/<skill-name>/SKILL.md داخل المستودع.
• مهارات الإضافة توجد في <plugin>/skills/<skill-name>/SKILL.md داخل الإضافة.

استخدام المهارات في الإضافات¶

بنية الدليل¶

تُوضع المهارات في دليل skills/ الخاص بالإضافة:

my-plugin/
├── .claude-plugin/
│   └── plugin.json
├── commands/          # Command layer
├── agents/            # Agent layer
└── skills/            # Knowledge layer
    ├── code-style/
    │   └── SKILL.md
    └── api-docs/
        ├── SKILL.md
        └── references/

الإشارة إلى المهارات في الأوامر¶

يمكن للأوامر الإشارة صراحةً إلى معرفة المهارة:

---
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: مهارة معايير المشروع¶

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

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

\`\`\`
<type>(<scope>): <subject>

<body>

<footer>
\`\`\`

### Type Values

- `feat`: New feature
- `fix`: Bug fix
- `docs`: Documentation update
- `style`: Code formatting
- `refactor`: Refactoring
- `test`: Testing
- `chore`: Build/tooling

المثال 3: مهارة مراجعة الأمان¶

---
name: Security Review
description: Use when the user asks about "security check", "vulnerability scan", "security best practices", or reviewing code security
---

# Security Review Guide

## Common Vulnerability Checks

### SQL Injection

- Check for parameterized queries
- Avoid string concatenation in SQL

### XSS Attacks

- Check if user input is escaped
- Use CSP headers

### Sensitive Data

- Ensure passwords are not stored in plaintext
- Don't hardcode API keys
- Check logs for sensitive data leaks

## Review Checklist

- [ ] Input validation
- [ ] Output encoding
- [ ] Authentication mechanism
- [ ] Authorization checks
- [ ] Encryption usage
- [ ] Error handling

أفضل الممارسات¶

1. أوصاف واضحة للمحفّزات¶

استخدم عبارات محفّزة محددة، لا أوصافًا غامضة:

# Good
description: Use when the user asks about "create component", "React component template", "component best practices"

# Bad
description: React component related

2. معرفة منظّمة¶

نظّم المعرفة في تسلسلات هرمية واضحة:

• استخدم مستويات العناوين

• قدّم أمثلة برمجية

• ضمّن قوائم تحقق

3. أبقِها محدّثة¶

• حدّث محتوى المهارة بانتظام

• تعكس أرقام الإصدارات التغييرات

• وثّق التحديثات المهمة

4. تصميم معياري¶

• تركّز كل مهارة على مجال واحد

• استخدم مجلد references للمواد التفصيلية

• قدّم أمثلة عملية

تصحيح أخطاء المهارات¶

إذا لم تنشط المهارة كما هو متوقع:

1. تحقّق من الوصف: تأكد من تطابق عبارات المحفّز مع إدخال المستخدم

2. تحقّق من التنسيق: تأكد من تنسيق البيانات الأمامية YAML بشكل صحيح

3. اختبر المحفّزات: جرّب استخدام عبارات مطابقة تمامًا من الوصف

الخطوات التالية¶

• نظام الإضافات - تعلّم تطوير الإضافات بشكل كامل

• خوادم MCP - وسّع قدرات أدوات Claude

• نصائح CLI - حسّن كفاءة سطر الأوامر

المؤسسات ←