دليل مهارات Claude Code

مهارات Claude Code — يتيح لك بناء مهارات Claude Code تجميع أوامر ذكاء اصطناعي قابلة لإعادة الاستخدام. تعلّم ملفات SKILL.md، والكشف التدريجي (progressive disclosure)، والاستدعاء التلقائي، وأفضل ممارسات الملفات المرجعية.

مهارات Claude Code: ماذا ستتعلّم

في هذا الدليل حول مهارات Claude Code، ستعمل عبر خطوات عملية تطبيقية مع أمثلة واقعية. تُشرح هذه المهارات من الأساس حتى تتمكن من تطبيقها فورًا في مشاريعك الخاصة.

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

كيف تُحمَّل المهارات

يُبقي Claude تحميل المهارات فعّالًا. تُحمَّل أوصاف المهارات فقط مسبقًا حتى يعرف Claude ما هو متاح. أما محتوى SKILL.md الكامل فيُحمَّل فقط عند استدعاء المهارة فعليًا، وتُقرأ الملفات المساندة عند الحاجة.

هذا يعني أنه يمكنك تثبيت العديد من المهارات دون إغراق نافذة السياق. يتعرّف Claude على وجودها من خلال أوصافها، ثم يحمّل التعليمات الفعلية فقط للمهارات التي يقرر استخدامها.

توجد المهارات في .claude/skills/<name>/SKILL.md للنطاق على مستوى المشروع (المُودَع في git) أو في ~/.claude/skills/<name>/SKILL.md للنطاق الشخصي. تستخدم مهارات الإضافات (plugins) مساحة أسماء بصيغة plugin-name:skill-name لتجنّب التعارض مع مهارات المشروع أو المهارات الشخصية. وعندما تتشارك المهارات غير التابعة للإضافات الاسم نفسه، يكون ترتيب الأولوية: المؤسسة (enterprise) > الشخصية > المشروع.

كما يكتشف Claude المهارات تلقائيًا من أدلة .claude/skills/ المتداخلة في الأدلة الفرعية لجذر المشروع. فعلى سبيل المثال، إذا كنت تعمل داخل packages/frontend/، فسيعثر Claude على المهارات المعرّفة في packages/frontend/.claude/skills/. هذا يجعل من السهل وضع المهارات بجوار حزم أو خدمات محددة في إعدادات الـ monorepo.

.claude/skills/code-review/
├── SKILL.md              # Instructions (required)
├── templates/
│   └── review-checklist.md
└── scripts/
    └── analyze-metrics.py

كتابة أوصاف مهارات فعّالة

يُعَدّ حقل الوصف (description) أهم جزء في المهارة على الأرجح. فهو يتحكم في وقت استدعاء Claude للمهارة تلقائيًا، ويجب أن يحتوي على إشارة كافية للمطابقة مع طلبات المستخدمين الحقيقية. الوصف الغامض مثل “يساعد في الشيفرة” لن يُفعَّل أبدًا. أما الوصف المحدد بمصطلحات تفعيل ملموسة فينجح:

---
name: security-review
description: Scan code for security vulnerabilities including injection flaws, authentication issues, and data exposure. Use when reviewing code changes, preparing a PR, or when the user mentions security, vulnerabilities, or audit.
---

ضمّن نوع المهمة (“scan”، “generate”، “analyze”)، ومجال الموضوع (“security”، “API”، “database”)، وعبارات التفعيل الصريحة (“when the user mentions”، “use when”). تقتطع قائمة المهارات النص المدمج لكل مدخل من description زائد when_to_use عند 1,536 حرفًا، لذا ضع حالة الاستخدام الأساسية في المقدمة وادفع عبارات التفعيل الزائدة إلى when_to_use:

---
name: security-review
description: Scan code for security vulnerabilities including injection flaws, authentication issues, and data exposure.
when_to_use: When reviewing code changes, preparing a PR, or when the user mentions security, vulnerabilities, or audit.
---

يخصّص Claude إجمالي مساحة أوصاف المهارات بنحو 1% من نافذة سياق النموذج افتراضيًا. ارفعها باستخدام إعداد skillListingBudgetFraction (مثلًا 0.02 = 2%) أو متغيّر البيئة SLASH_COMMAND_TOOL_CHAR_BUDGET لعدد أحرف ثابت. شغّل /doctor للتحقق مما إذا كانت الميزانية تتجاوز الحد وأي المهارات يجري إسقاطها.

تمدّ الملفات المساندة المهارة دون تضخيم السياق. أشِر إليها من SKILL.md بمسارات نسبية:

For the full review checklist, see [templates/review-checklist.md](templates/review-checklist.md).

يقرأ Claude الملفات المساندة عبر bash عند الحاجة. أبقِ SKILL.md أقل من 500 سطر؛ وضع المواد المرجعية التفصيلية في ملفات منفصلة.

السياق الديناميكي والتحكم في الاستدعاء

تنفّذ صيغة !command أوامر الصدفة قبل أن يصل محتوى المهارة إلى Claude. يُدرَج الناتج ضمنيًا — فلا يرى Claude سوى النتيجة، لا الأمر نفسه. هكذا تمنح المهارات سياقًا حيًّا:

---
name: pr-summary
description: Summarize pull request changes. Use when asked to review or summarize a PR.
context: fork
agent: Explore
---

## PR context
- Diff: !`gh pr diff`
- Comments: !`gh pr view --comments`
- Changed files: !`gh pr diff --name-only`

Summarize the intent and key changes in this pull request.

يحدّد حقل shell أي صدفة تُستخدم لكتل !command. اضبطه على powershell بدلًا من الافتراضي bash عند تمكين أداة PowerShell عبر CLAUDE_CODE_USE_POWERSHELL_TOOL=1. على Linux وmacOS، يتطلب تمكينها أيضًا وجود pwsh في مسار PATH لديك:

---
name: windows-helper
description: Manage Windows services and configurations
shell: powershell
---

يتحكم حقلان في الـ frontmatter في مَن يمكنه استدعاء المهارة. disable-model-invocation: true يعني أن المستخدم وحده يمكنه استدعاؤها عبر /skill-name — ولن يُفعّلها Claude تلقائيًا أبدًا. استخدم هذا لأي مهارة ذات آثار جانبية (عمليات النشر، والدفع، والإرسال). أما user-invocable: false فيُخفي المهارة من قائمة / مع السماح لـ Claude باستدعائها تلقائيًا — وهو مثالي لمهارات المعرفة الخلفية التي لا تصلح كأوامر قابلة للتنفيذ.

يقبل paths: قائمة YAML من أنماط الـ globs التي تحدّد نطاق انطباق المهارة. وعند ضبطه، تُحمَّل المهارة فقط عندما يطابق دليل العمل أحد الأنماط. هذا يمنع المهارات الخاصة بالمشروع من التسرّب إلى جلسات غير ذات صلة:

---
name: api-generator
description: Generate REST API endpoints from schema definitions.
paths: ["src/**/*.ts", "tests/**"]
---

يتحكم effort في عمق التفكير للمهارة. القيم هي low وmedium وhigh وxhigh وmax (للجلسة فقط). استخدم low للبحث السريع أو توليد القوالب الجاهزة، وmedium لمعظم المهام، وhigh للتحليل العميق الذي يتطلب تفكيرًا دقيقًا:

---
name: security-review
description: Scan code for security vulnerabilities.
effort: high
---

يشغّل context: fork المهارة في وكيل فرعي معزول بنافذة سياق خاصة به. يحدّد حقل agent نوع الوكيل: Explore للبحث للقراءة فقط، وPlan للتخطيط، وgeneral-purpose لأي شيء يحتاج إلى جميع الأدوات. تبقى المحادثة الرئيسية نظيفة بينما يتولى الوكيل الفرعي العبء الثقيل.

يحدّد حقل model أي نموذج يُستخدم عندما تكون المهارة نشطة. هذا مفيد عندما تستفيد مهمة ما من نقاط قوة نموذج معيّن (مثل opus للتفكير المعقّد، وsonnet للتنفيذ السريع):

---
name: deep-analysis
description: Thoroughly analyze the codebase for a specific pattern or issue
context: fork
agent: Explore
model: opus
disable-model-invocation: true
---

Analyze $ARGUMENTS across the entire codebase:
1. Use Glob and Grep to find all occurrences
2. Read each file and understand context
3. Summarize patterns, inconsistencies, and recommendations

الوسائط والوصول إلى الأدوات

تقبل المهارات الوسائط بطريقتين. $ARGUMENTS يلتقط كل ما يلي اسم الأمر كسلسلة واحدة. أما $0 و$1 و$2 فتلتقط الوسائط الفردية المفصولة بمسافات. يمكنك أيضًا التصريح بوسائط مُسمّاة عبر حقل arguments في الـ frontmatter — تُربط الأسماء بالمواضع، فيتوسّع $issue إلى الوسيط الأول و$branch إلى الثاني. تجري جميع عمليات الاستبدال قبل أن يصل المُوجِّه إلى Claude. ويُحسّن argument-hint الإكمال التلقائي في قائمة الأوامر المائلة بإظهار الوسائط التي تتوقعها المهارة:

---
name: review-pr
description: Review a GitHub PR by number
argument-hint: "<pr-number> <priority>"
allowed-tools: Bash(gh *), Read, Grep, Glob
---

Review PR #$0 with priority $1. Focus on security and performance.

Reference our standards in [standards/code-review.md](standards/code-review.md).

الاستخدام: /review-pr 456 high — يصبح $0 هو 456، ويصبح $1 هو high.

يمنح allowed-tools إذنًا للأدوات المدرجة أثناء نشاط المهارة — وهو لا يقيّد الأدوات المتاحة. تظل إعدادات الأذونات لديك هي التي تحكم الأدوات غير المدرجة.

إلى جانب الوسائط الموضعية، تدعم المهارات متغيّرات استبدال مدمجة: ${CLAUDE_SESSION_ID} لمعرّف الجلسة الحالية (مفيد للتسجيل)، و${CLAUDE_EFFORT} لمستوى الجهد النشط، و${CLAUDE_SKILL_DIR} للدليل الذي يحتوي ملف SKILL.md الخاص بالمهارة (استخدمه للإشارة إلى السكربتات المرفقة بصرف النظر عن دليل العمل).

لا تزال ملفات الأوامر القديمة في .claude/commands/*.md تعمل، لكن المهارات هي الصيغة المُوصى بها. وإذا وُجد كلاهما بالاسم نفسه، فإن المهارة تأخذ الأولوية.

تجاوزات ظهور المهارات

يتحكم إعداد skillOverrides في settings.json في ظهور المهارات دون تعديل الـ frontmatter الخاص بالمهارة نفسها. هذا مفيد لمهارات المشروع المشتركة أو المهارات المقدَّمة من الإضافات التي لا يمكنك تعديلها. تتيح لك قائمة /skills تبديل الحالات تفاعليًا — ظلّل مهارة، واضغط Space للتبديل، ثم Enter للحفظ في .claude/settings.local.json:

{
  "skillOverrides": {
    "legacy-context": "name-only",
    "deploy": "off"
  }
}

القيم: "on" (افتراضي — قائمة كاملة)، "name-only" (الاسم ظاهر لكن الوصف مخفي)، "user-invocable-only" (مخفي عن Claude لكنه في قائمة /)، "off" (مخفي في كل مكان).

المهارات المدمجة

يأتي Claude Code مزوّدًا بمجموعة من المهارات المرفقة المتاحة في كل جلسة، منها /code-review و/batch و/debug و/loop و/claude-api. وتتطلب ثلاث مهارات مرفقة إضافية — /run و/verify و/run-skill-generator — الإصدار v2.1.145+ وتعمل معًا لإطلاق تطبيقك والتأكد من التغييرات على التطبيق الفعلي بدلًا من الاختبارات وحدها:

يستنتج /run و/verify طريقة الإطلاق من نوع مشروعك (CLI، خادم، TUI، مُشغَّل بالمتصفح) ومن package.json أو Makefile أو ملف README الخاص بك. وبالنسبة للمشاريع التي تحتاج إلى أي شيء يتجاوز الإطلاق القياسي — قاعدة بيانات، أو ملف بيئة، أو بناء متعدد الخطوات — شغّل /run-skill-generator مرة واحدة. فهو يشغّل تطبيقك من بيئة نظيفة، ويلتقط ما نجح، ويودِعه كمهارة خاصة بالمشروع في .claude/skills/run-<name>/. بعد ذلك، يتبع /run و/verify الوصفة المسجّلة بدلًا من التخمين.

يفحص /fewer-permission-prompts نصوص محادثاتك بحثًا عن استدعاءات أدوات Bash وMCP الشائعة للقراءة فقط، ثم يقترح قائمة سماح مرتّبة حسب الأولوية لملف .claude/settings.json الخاص بك. شغّله بعد بضع جلسات لتوليد تهيئة أذونات مصمّمة وفق سير عملك الفعلي:

/fewer-permission-prompts

أمثلة مهارات من الواقع

المثال 1: مهارة اتساق الصوت العلامي (Brand Voice)

تضمن هذه المهارة أن تحافظ جميع المراسلات على صوت علامي متسق:

---
name: brand-voice-consistency
description: Ensure all communication matches brand voice and tone guidelines. Use when creating marketing copy, customer communications, public-facing content, or when users mention brand voice, tone, or writing style.
---

# Brand Voice Skill

## Tone of Voice
- Friendly but professional — approachable without being casual
- Clear and concise — avoid jargon, explain technical concepts simply
- Confident — we know what we're doing

## Writing Guidelines
### Do's ✅
- Use "you" when addressing readers
- Use active voice: "Claude generates reports" not "Reports are generated"
- Start with value proposition

### Don'ts ❌
- Don't use corporate jargon ("leverage", "synergize", "paradigm shift")
- Don't patronize or oversimplify

المثال 2: مهارة أخصائي مراجعة الشيفرة

مهارة شاملة لمراجعة الشيفرة مع ملفات مرجعية:

---
name: code-review-specialist
description: Comprehensive code review with security, performance, and quality analysis. Use when users ask to review code, analyze code quality, or evaluate pull requests.
---

# Code Review Skill

Focus areas:
1. **Security Analysis** — injection vulnerabilities, data exposure risks
2. **Performance Review** — algorithm efficiency, memory optimization
3. **Code Quality** — SOLID principles, design patterns
4. **Maintainability** — readability, cyclomatic complexity

## Reference Files
- templates/review-checklist.md — Structured review checklist
- templates/finding-template.md — Standard finding documentation format
- scripts/analyze-metrics.py — Code metrics calculator

المثال 3: مهارة مولّد توثيق الـ API

---
name: api-documentation-generator
description: Generate comprehensive API documentation from source code. Use when creating or updating API documentation or generating OpenAPI specs.
---

# API Documentation Generator

Generates:
- OpenAPI/Swagger specifications
- API endpoint documentation
- SDK usage examples
- Error code references

نصائح احترافية

• اجعل الأوصاف محددة مع مصطلحات التفعيل — “يساعد في المستندات” عديم الفائدة. أما “استخراج النصوص والجداول من ملفات PDF، وملء النماذج، ودمج المستندات. استخدمها عند العمل مع ملفات PDF أو النماذج أو استخراج المستندات” فيُمكّن الاستدعاء التلقائي.
• أبقِ SKILL.md أقل من 500 سطر — انقل المواد المرجعية التفصيلية والأمثلة الكبيرة والمواصفات إلى ملفات منفصلة تُحمَّل عند المستوى 3 (عند الحاجة). هذا يقلّل استهلاك السياق.
• المهارة الواحدة تساوي قدرة واحدة — “ملء نماذج PDF” مهارة جيدة. أما “معالجة المستندات” فواسعة جدًا وستُفعَّل على طلبات غير ذات صلة أو تفوّت الطلبات ذات الصلة.
• استخدم context: fork لمهام التحليل الثقيلة — يحافظ تشغيل المهارة في وكيل فرعي على نظافة المحادثة الرئيسية. استخدم agent: Explore للبحث للقراءة فقط أو agent: general-purpose للمهام التي تحتاج إلى جميع الأدوات.
• دقّق المهارات من المصادر غير الموثوقة جيدًا — يمكن لمهارة خبيثة أن توجّه Claude لاستدعاء أدوات أو تنفيذ شيفرة بطرق ضارة. تعامل مع تثبيت مهارة كتثبيت برنامج.

تحدٍّ تطبيقي

ابنِ مهارة كاملة جاهزة للإنتاج تُظهِر الكشف التدريجي.

المهمة: إنشاء مهارة أخصائي مراجعة الشيفرة

صمّم مهارة تُجري مراجعات شيفرة شاملة مع تحليل للأمان والأداء والجودة باستخدام ملفات مساندة للكشف التدريجي.

الخطوات

1. أنشئ بنية دليل المهارة: .claude/skills/code-review-specialist/ مع الدليلين الفرعيين templates/ وreferences/.
2. اكتب SKILL.md بوصف محدد يحتوي كلمات تفعيل مثل “review code” و”analyze code quality” و”security analysis” و”pull request”.
3. أنشئ templates/review-checklist.md بفحوصات مصنّفة (الأمان، الأداء، مبادئ SOLID، أعراف التسمية).
4. أنشئ references/finding-template.md يُظهِر صيغة الإخراج المتوقعة لكل نتيجة (Issue، Location، Impact، Severity، Fix).
5. أبقِ SKILL.md أقل من 500 سطر — انقل قوائم الفحص التفصيلية إلى الملفات المساندة.
6. أشِر إلى الملفات المساندة من SKILL.md باستخدام مسارات نسبية مثل [review checklist](templates/review-checklist.md).
7. اختبر الاستدعاء التلقائي بأن تسأل Claude “Can you review this code for security issues?” دون استدعاء المهارة صراحةً.

النتيجة المتوقعة

عندما تطلب من Claude مراجعة الشيفرة، تُفعَّل المهارة تلقائيًا بناءً على كلمات الوصف. يحمّل Claude التعليمات من SKILL.md، ثم يسحب قالب قائمة الفحص عند الحاجة. ويتبع ناتج المراجعة صيغة نتائجك المنظّمة بمستويات خطورة مصنّفة.

تلميح

ضع كلمات التفعيل في مقدمة حقل description — فهذا ما يطابقه Claude. استخدم user-invocable: false إن أردت أن تكون المهارة غير مرئية في قائمة الأوامر المائلة لكنها تُفعَّل تلقائيًا. راجع مثالَي code-review-specialist وإعادة الهيكلة (refactor) في دليل المهارات.

اختبار المعرفة

اختبر فهمك لمهارات Claude Code بهذه الأسئلة:

1. ما المستويات الثلاثة للكشف التدريجي في نظام المهارات؟
   أ) البيانات الوصفية، التعليمات، الموارد | ب) الاسم، المتن، المرفقات | ج) الترويسة، المحتوى، السكربتات | د) الملخص، التفاصيل، البيانات
   الإجابة: أ — المستوى 1: البيانات الوصفية (~100 رمز (token)، محمَّلة دائمًا)، المستوى 2: متن SKILL.md (<5k رمز، يُحمَّل عند التفعيل)، المستوى 3: الموارد المرفقة (سكربتات/مراجع/أصول، تُحمَّل عند الحاجة).
2. ما العامل الأهم لاستدعاء Claude للمهارة تلقائيًا؟
   أ) اسم ملف المهارة | ب) حقل description في الـ frontmatter مع كلمات متى-تُستخدم | ج) موقع دليل المهارة | د) حقل auto-invoke: true في الـ frontmatter
   الإجابة: ب — يقرّر Claude ما إذا كان سيستدعي المهارة تلقائيًا بناءً على حقل description وحده. ويجب أن يتضمن عبارات تفعيل وسيناريوهات محددة.
3. ما الطول الأقصى المُوصى به لملف SKILL.md؟
   أ) 100 سطر | ب) 250 سطرًا | ج) 500 سطر | د) 1000 سطر
   الإجابة: ج — ينبغي إبقاء SKILL.md أقل من 500 سطر. وتنتمي المواد المرجعية الأكبر إلى ملفات الدليل الفرعي references/.
4. كيف تجعل المهارة تعمل في وكيل فرعي معزول بسياقه الخاص؟
   أ) اضبط isolation: true في الـ frontmatter | ب) اضبط context: fork مع حقل agent في الـ frontmatter | ج) اضبط subagent: true في الـ frontmatter | د) ضع المهارة في .claude/agents/
   الإجابة: ب — يشغّل context: fork المهارة في سياق منفصل، ويحدّد حقل agent نوع الوكيل المستخدم.
5. تحتاج مهارة إلى الإشارة إلى مواصفة API كبيرة. أين ينبغي أن تضعها؟
   أ) ضمنيًا في SKILL.md | ب) في ملف references/api-spec.md داخل دليل المهارة | ج) في ملف CLAUDE.md الخاص بالمشروع | د) في ملف .claude/rules/ منفصل
   الإجابة: ب — تنتمي المواد المرجعية الكبيرة إلى الدليل الفرعي references/. يحمّل Claude موارد المستوى 3 عند الحاجة، مُبقيًا SKILL.md رشيقًا.

موارد إضافية

مهارات Claude Code تمنحك سير عمل متينًا قابلًا للتكرار. احفظ هذا الدليل عن مهارات Claude Code في المفضلة وعُد إلى خطواته كلما احتجت إليها.

مثال تطبيقي: بناء مهارة كشف تدريجي

لنبنِ مهارة حقيقية تراجع نقاط النهاية (endpoints) في مشروع API وتتأكد من توثيقها، لنرى كيف يعمل الكشف التدريجي في الممارسة.

أنشئ أولًا بنية المجلد: .claude/skills/api-audit/SKILL.md مع مجلد فرعي references/. في الترويسة، اكتب وصفًا يحتوي كلمات تفعيل واضحة:

---
name: api-audit
description: Audit REST API endpoints for missing documentation and inconsistent error handling. Use when reviewing API routes or when the user mentions endpoints, API docs, or route consistency.
---

في متن الملف، اكتب تعليمات موجزة فقط — لا تُدرِج قائمة الفحص الكاملة هنا. أشِر إليها بدلًا من ذلك بمسار نسبي: راجع references/checklist.md لكل فئة. هذا يبقي المستوى الثاني (متن SKILL.md) خفيفًا بينما تنتظر التفاصيل في المستوى الثالث حتى يحتاجها Claude فعليًا.

ضع قائمة الفحص التفصيلية — أسماء نقاط النهاية، وحالات الأخطاء المتوقعة، وصيغة التوثيق — داخل references/checklist.md. لن يقرأ Claude هذا الملف إلا عند استدعاء المهارة فعليًا، فلا يستهلك سياقًا في الجلسات التي لا تخصّه.

احفظ كل شيء، وافتح جلسة جديدة في مشروع API، ثم اطرح سؤالًا طبيعيًا مثل “راجع نقاط نهاية auth للتأكد من أنها موثّقة” دون ذكر اسم المهارة صراحةً. إن كان الوصف محددًا بما يكفي، يستدعي Claude api-audit تلقائيًا ويسحب قائمة الفحص من الملف المرجعي عند الحاجة فقط.

مهارات Claude Code: أخطاء شائعة يجب تجنّبها

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

• كتابة وصف غامض مثل “يساعد في الشيفرة”، فلا يجد Claude ما يطابقه بطلبات المستخدم الحقيقية ولا يُستدعى تلقائيًا أبدًا.
• حشو كل التفاصيل والأمثلة داخل SKILL.md نفسه بدل نقلها إلى ملفات مرجعية، ما يضخّم السياق في كل استدعاء.
• بناء مهارة واحدة ضخمة تغطي مهام متعددة غير مترابطة بدلًا من تركيب عدة مهارات صغيرة أحادية الغرض.
• تثبيت مهارة من مصدر غير موثوق دون قراءة محتواها، رغم أنها قد توجّه Claude لتنفيذ أوامر ضارة كأي برنامج آخر.

مهارات Claude Code: أفضل الممارسات

• اكتب ملف SKILL.md واحدًا لكل مهارة بوصف دقيق حتى يُفعَّل الاستدعاء التلقائي بشكل صحيح.
• استخدم الكشف التدريجي: أبقِ الملف الرئيسي قصيرًا واربط الملفات المرجعية للتفاصيل.
• اختبر صياغة التفعيل حتى تُفعَّل المهارة تمامًا عند القصد منها وليس في غير ذلك.
• أبقِ المهارات أحادية الغرض؛ ركّب عدة مهارات صغيرة بدلًا من واحدة ضخمة.
• أصدِر المهارات ووثّقها حتى يتمكن فريقك من إعادة استخدامها وتحسينها.

الأسئلة الشائعة حول مهارات Claude Code

ما الفرق بين المهارة والأمر المدمج؟

الأمر المدمج جزء أصيل من Claude Code، بينما المهارة ملف SKILL.md تكتبه أنت وتُستدعى تلقائيًا بناءً على وصفها متى طابق السياق.

لماذا لا تُستدعى مهارتي تلقائيًا رغم أنها تعمل عند الاستدعاء اليدوي؟

غالبًا لأن حقل description غامض أو لا يحتوي عبارات تفعيل صريحة. أعد صياغته ليشمل نوع المهمة والموضوع وسيناريو الاستخدام بوضوح.

هل يمكن لمهارتين أن تحملا الاسم نفسه؟

نعم إذا كانتا في نطاقين مختلفين (مشروع مقابل شخصي)؛ وعندئذٍ يُحسم التعارض بترتيب أولوية ثابت: المؤسسة، فالشخصية، فالمشروع.

متى أستخدم context: fork بدلًا من ترك المهارة تعمل في المحادثة الرئيسية؟

استخدمه عندما تحتاج المهارة إلى بحث أو تحليل ثقيل قد يُثقل نافذة السياق الرئيسية، فيتولى وكيل فرعي معزول العبء ويعود بملخص فقط.

كيف أمنع مهارة حساسة من الاستدعاء التلقائي؟

أضف disable-model-invocation: true إلى الترويسة، فلا يستدعيها Claude من تلقاء نفسه أبدًا، ويبقى تشغيلها اليدويًا فقط عبر /اسم-المهارة.