مهارات Claude Code في 2026: كيفية بناء مكتبة مهارات لنفسك

توثيق Ailoot: واجهة API والمفاتيح والإعداد.

ما المهارة في Claude Code، ولماذا ليست مجرد «مطالبة أكبر»؟#

مهارات Claude Code ميزة أصلية في Claude Code أطلقتها Anthropic في أكتوبر 2025 لمشتركي Pro/Max/Team/Enterprise. وفي وقت لاحق، أتاحت مواصفة Agent Skills كمعيار يعمل خارج Claude أيضًا. وفي الشيفرة، ليست سوى مجلد:

.claude/skills/
├── deploy-to-prod/
│   ├── SKILL.md
│   └── scripts/
│       └── check-migrations.sh
├── weekly-content-plan/
│   └── SKILL.md
└── triage-support-tickets/
    └── SKILL.md

كل مجلد يمثل مهارة واحدة. ملف SKILL.md مكتوب بصيغة Markdown، مع ترويسة YAML في أعلاه وتعليمات عادية أدناه. عندما يطلب المستخدم: «لننشر إلى الإنتاج»، يرى Claude وصف مهارة deploy-to-prod، ويتعرف على «النشر إلى الإنتاج» بوصفه محفّزًا، ويحمّل متن SKILL.md إلى السياق، ثم يتبع الخطوات.

ثلاثة مستويات للتحميل التدريجي

صممت Anthropic المهارات لتُحمّل تدريجيًا: تُحمّل البيانات على طبقات حسب الحاجة. ويصف الفريق ذلك في مدونة Anthropic Engineering بأنه «مبدأ التصميم الأساسي الذي يجعل Agent Skills مرنة وقابلة للتوسع» (Anthropic Engineering).

مستويات التحميل الثلاثة:

1. البيانات الوصفية (دائمًا) - عند بدء الجلسة، لا يرى Claude سوى name وdescription لكل مهارة. الميزانية: نحو 100 رمز لكل مهارة.
2. التعليمات (عند تحقق المحفّز) - عندما يقول المستخدم شيئًا ذا صلة، يحمّل Claude متن SKILL.md. الميزانية: أقل من 5000 رمز.
3. الموارد (عند الطلب) - لا تُجلب الملفات المرفقة (الأمثلة والقوالب ومجموعات البيانات) إلا عندما يبحث عنها النموذج بنفسه. الميزانية: غير محدودة.

في السابق، كان لا بد أن يحتوي CLAUDE.md على كل ما ينبغي للذكاء الاصطناعي أن «يتذكره»، وكان مشروع يضم 50 قاعدة يصل سريعًا إلى حد السياق. أما مع المهارات، فيمكن أن تتعايش عشرات منها بسهولة في مشروع واحد، لأن أوصافها وحدها هي التي تدخل السياق الأولي.

أين توجد المهارات: أربعة مستويات

الأولوية: تتقدم إعدادات المؤسسة على الإعدادات الشخصية، والشخصية على إعدادات المشروع. تستخدم الإضافات مساحة الأسماء plugin-name:skill-name ولا تتعارض معها. وهذا ملائم: ضع المهارات المهنية العامة في ~/.claude/skills/، والمهارات الخاصة بالمشروع في .claude/skills/ داخل المستودع.

ما محتويات SKILL.md؟#

إليك مثالًا أدنى—عشرون سطرًا، وتصبح المهارة جاهزة:

---
name: weekly-content-plan
description: Prepares a weekly post plan for a Telegram channel and short-form videos. Triggers - "make a post plan", "what should I post this week", "a 7-day channel plan". Do not activate if the request is about a website or email newsletter.
---

# Weekly Content Plan

## Steps

1. Read `knowledge/audience.md` - who we're writing for
2. Read `knowledge/tone-of-voice.md` - how we write
3. Read the last 10 posts in the channel - what has already been covered
4. Come up with 7 topics for the week: 3 sales-focused, 2 expert, 2 personal
5. For each, provide one hook line and three bullets about the post
6. Output as a table: day of the week | type | hook | plan

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

حدود ينبغي مراعاتها

يضع التوثيق الرسمي لواجهة Claude API حدودًا صارمة:

• name: حتى 64 حرفًا، وباستخدام الأحرف الصغيرة والأرقام والواصلات فقط، دون وسوم XML. الاسمان anthropic وclaude محجوزان.
• description: حتى 1024 حرفًا في واجهة API؛ وهو مطلوب، ولا يُسمح بوسوم XML.
• ميزانية القائمة: في Claude Code، تشغل أوصاف جميع المهارات مجتمعة نحو 1% من نافذة السياق. وإذا كثرت المهارات، فستُقتطع الأوصاف وقد تختفي الكلمات المفتاحية التي يحتاجها Claude للمطابقة.
• متن SKILL.md: توصي Anthropic بإبقائه ضمن 500 سطر. انقل كل ما يزيد على ذلك إلى ملفات references/ وscripts/ وexamples/ وحمّلها من خلال التعليمات.

بعد ضغط السياق (/compact)، يحتفظ Claude بأول 5000 رمز من كل مهارة سبق استدعاؤها؛ وتبلغ الميزانية الإجمالية لكل المهارات المعاد إرفاقها 25 000 رمز. إذا لم تتسع مهارة، فسيُنسى سلوكها.

مخطط الترويسة الكامل

استخدم name وdescription على الأقل. وتستخدم مهارات الإنتاج حقولًا أخرى أيضًا:

حقل disable-model-invocation: true ضروري لكل ما يجب ألا يعمل تلقائيًا. فمثلًا، لا يمكن استدعاء مهارة deploy-to-prod التي تحمل هذا العلم إلا إذا كتب المستخدم صراحةً /deploy-to-prod. ومن دون هذا العلم، قد ينفذ Claude النشر لمجرد أن «الشيفرة تبدو جاهزة».

لماذا يشكّل الوصف 90% من العمل، وكيف تكتبه؟#

أشيع خطأ لدى مبرمجي الأجواء هو كتابة وصف مثل «مساعد لـ X». تكون المهارة موجودة فعليًا في مجلدها، لكن Claude لا يستدعيها.

وصف سيئ

description: Build dashboards.

ما لا يستطيع Claude معرفته: عندما يطلب المستخدم «أرني المبيعات لهذا الأسبوع»، هل يتعلق ذلك بلوحة معلومات أم لا؟ وعندما يطلب «مخططًا للإيرادات»، فهل يتعلق ذلك بلوحة معلومات أم هو مجرد مخطط عمومًا؟ وعندما يطلب «تقريرًا شهريًا»، فهل من المؤكد أن ذلك لا يتعلق بلوحة معلومات؟

تذكر أداة Anthropic نفسها، skill-creator، التوصية مباشرة:

صيغة الوصف الجيد

ثلاثة أجزاء:

1. ما الذي تفعله - جملة واحدة تصف النتيجة لا العملية. ليس «يُنشئ SQL»، بل «يصدّر المبيعات في جدول لقناة Telegram».
2. متى يتم تفعيلها - من 3 إلى 5 عبارات مقتبسة يقولها المستخدمون فعلًا. لا تخمّن؛ راجع سجل المحادثات والدعم لديك.
3. متى يجب عدم تفعيلها - عبارة أو عبارتان عن مهام مشابهة ينبغي ألا تستجيب لها المهارة. من دون هذا القسم، ستظل مهارتان متشابهتان تتعارضان.

مثال على وصف قوي من مشروعي (مبسّط ومجهّل الهوية):

description: |
  Writes and publishes an SEO guide to the blog, following the editorial policy.
  Triggers: "write a guide about X", "let's make a new pillar",
  "a blog article about Y", "build a blog guide about Z".
  Do not activate if the request is about an email newsletter,
  a Telegram post, or an internal team instruction—
  those are other skills.

ما الذي ينجح هنا:

• يحدد الفعل «يكتب وينشر» نتيجة ملموسة بدلًا من «يساعد في».
• تغطي أربع عبارات محفّزة مقتبسة صيغًا مختلفة.
• يتضمن أيضًا محفّزًا باللغة الإنجليزية—فإذا انتقل المستخدم إلى لغة الفريق، تظل المهارة تعمل.
• يمنع قسم منفصل بعنوان «لا تفعّل إذا» التعارض مع مهارات البريد والمنشورات.

كيفية اختبار الوصف

أدرجت Anthropic في skill-creator منهجية تقييم المحفّزات: 20 مطالبة للتحقق من تفعيل المهارة. ينبغي أن تؤدي عشر منها إلى التفعيل، وألا تؤدي العشر الأخرى إليه (بما في ذلك الحالات القريبة التي تتشابه صياغتها لكن تختلف مهمتها).

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

ما أول 5 مهارات ينبغي أن أثبّتها؟#

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

1. anthropics/skills - المجموعة الرسمية التي تضم skill-creator

المستودع: github.com/anthropics/skills. لديه 138,000 نجمة على GitHub. ويضم مهارات رسمية من فريق Anthropic: skill-creator (مهارة وصفية تكتب مهارات أخرى)، وclaude-api (تساعد في بناء تكاملات واجهة API)، ومهارات جاهزة للمستندات في PowerPoint وExcel وWord وPDF.

التثبيت باستخدام Claude Code:

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

القيمة الرئيسية هي skill-creator. فهو يكتب SKILL.md استنادًا إلى وصفك، ثم يشغّل 20 تقييمًا للمحفّزات ويراجع الوصف إلى أن تبدأ المهارة بالتفعيل في المواضع الصحيحة. وباختصار، إنها «مهارة لإنشاء المهارات».

2. mattpocock/skills - المجموعة واسعة الانتشار من خبير TypeScript

يضم 12 مهارة فعّالة، منها:

• grill-me - يطرح أسئلة عبر شجرة قرارات إلى أن تُحسم أوجه الغموض في المهمة. وتُعالَج في التكرار الأول أكثر مشكلة تؤرق من يبرمجون وفق الأجواء: «لا أعرف ما الذي أريده».
• caveman - يضغط تواصل النموذج ليصبح برقيًا.
• diagnose - تصحيح الأخطاء عبر دورة: إعادة الإنتاج - التقليص - وضع الفرضية - إضافة أدوات القياس - الإصلاح - اختبار الانحدار.
• tdd - يفرض نهج أحمر-أخضر-إعادة هيكلة: اختبار فاشل أولًا، ثم إصلاح أدنى، ثم إعادة الهيكلة.
• to-issues - يحول الخطة إلى مشكلات GitHub مقسّمة رأسيًا (متكاملة المكدس وقابلة للنشر بصورة مستقلة).

التثبيت:

npx skills@latest add mattpocock/skills
/setup-matt-pocock-skills

3. coreyhaines31/marketingskills - مجموعة للمسوّقين

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

4. vercel-labs/agent-skills - تصميم بلا مظهر اصطناعي

المستودع: github.com/vercel-labs/agent-skills. أبرز مهاراته web-design-guidelines، مع نحو 133,000 تثبيت أسبوعيًا. وهي تراجع شيفرة واجهة المستخدم وفق أكثر من 100 قاعدة للإتاحة والأداء وسهولة الاستخدام.

وتوجد إلى جانبها مهارة Anthropic frontend-design، مع أكثر من 110,000 تثبيت أسبوعيًا. تجعل الذكاء الاصطناعي يختار نمطًا قبل بدء كتابة الشيفرة. من دونها، تأتي كل صفحة ينشئها Claude بخط Inter وتدرج بنفسجي وبطاقات شبكية. وتكون النتيجة واحدة للجميع.

5. obra/superpowers - سير عمل متعدد الوكلاء

إجمالًا، إذا ثبّت أول ثلاث مجموعات في هذه القائمة—anthropics/skills وmattpocock/skills وcoreyhaines31/marketingskills—فسيكون لدى Claude Code لديك عشرات المهارات الجاهزة التي تغطي معظم مهام رائد الأعمال خلال الشهر الأول.

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

ما المهام المتكررة التي ينبغي تحويلها إلى مهارة؟#

رأيت هذا النمط عشرات المرات في العمل مع العملاء ومشاريع الآخرين. لدى أحدهم «ذلك الشيء الذي ينفذه من الصفر في كل مرة». يكتب كل يوم اثنين النوع نفسه من التقارير. ويتبع الإجراء نفسه كلما انضم عميل جديد. ولكل منشور القالب نفسه. وفي كل مرة يستغرق الأمر 30-90 دقيقة، لأنه يضطر إلى تذكّر الخطوات وفتح الملفات الصحيحة وصياغة مطالبة Claude من جديد.

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

المثال 1. مسوّق مستقل - مهارة weekly-content-plan

ما يفعله يدويًا: يجهز كل يوم اثنين منشورات Telegram لأسبوع كامل لثلاثة عملاء. يفتح دليل صوت العلامة التجارية للعميل، ويراجع المنشورات الحديثة، ويبتكر موضوعات استنادًا إلى تقويم المنتج، ثم يضع جدولًا يتضمن العبارات الجاذبة والنقاط.

تتحول هذه العملية في صورة مهارة إلى تعليمات من خمس خطوات: قراءة ملف نبرة صوت العميل، وقراءة تقويم المنتج، وفحص آخر 10 منشورات لتجنب التكرار، وابتكار سبعة موضوعات مصنفة حسب النوع (تسويقية، وخبيرة، وشخصية)، وإخراج جدول.

تحول عبارة «لنخطط منشورات العميل X لهذا الأسبوع» ساعة من التحضير إلى ثلاث دقائق من الانتظار. يراجع المسوّق النتيجة ويجري تعديلات محددة ويرسلها إلى العميل.

المثال 2. محاسب خارجي - مهارة monthly-receipts-close (مثال المؤلف)

ما يفعله يدويًا: لكل عميل في محفظته، يصدّر كشف الحساب المصرفي كل شهر، ويطابقه مع المدفوعات في نظام المحاسبة، ويشير إلى المدفوعات غير المصنفة، ويعد تقريرًا أوليًا للدخل، ويقارن بنية الدخل بالشهر السابق.

المهارة تعليمات من ست خطوات، إضافة إلى نصين برمجيين في مجلد scripts/ لتحليل كشوف الحسابات. ويؤدي محفّز «أغلق مايو للعميل X» إلى أن يُعد Claude تقريرًا مع الإشارة إلى الحالات الشاذة خلال 4-5 دقائق.

المثال 3. منشئ برنامج عبر الإنترنت - مهارة welcome-letter-new-participant

ما يفعله يدويًا: يدفع مشارك جديد، ويلزم كتابة رسالة ترحيب بالبريد الإلكتروني. والترحيب الجيد شخصي: يراعي القناة التي جاء منها، والمنتج الذي اشتراه، والمجموعة التي ينتمي إليها، والمواد التي ينبغي إرسالها معه. ولا يحقق ذلك قالب «مرحبًا، يسعدنا انضمامك».

تطلب المهارة من Claude قراءة knowledge/audience.md (من هم هؤلاء الأشخاص)، وknowledge/products/<product>.md (ما الذي يحصلون عليه)، وآخر ثلاث رسائل ترحيب (لتجنب التكرار)، ثم كتابة الرسالة بهذا التركيب: جملة جاذبة - تفاصيل المنتج - الخطوات الثلاث الأولى - التوقيع.

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

ما الذي لا ينبغي تحويله إلى مهارة؟

• المهام التي تُنفذ مرة واحدة. إذا كنت تنفذها مرة في السنة عند تقديم الإقرار الضريبي، فاكتفِ بوصفها لـ Claude في المحادثة. تبدأ المهارة بتحقيق عائد بعد 3+ مرات تكرار.
• المهام العامة أكثر من اللازم. «ساعدني في التسويق» ليست مهارة؛ فهذا يشمل التسويق كله. أما المهارة فهي «خطة محتوى أسبوعية»—إجراء محدد بنتيجة محددة.
• المهام التي لا تتبع خطوات قابلة للتكرار. إذا اختلفت العملية في كل مرة، فهي ليست مهارة، بل عمل لمرة واحدة.

كيف ينشئ Skill Creator المهارات نيابةً عنك؟#

تكمن الصعوبة في كتابة مهارة جيدة من المحاولة الأولى. فكثيرًا ما يصبح الوصف ضيقًا أكثر من اللازم أو واسعًا أكثر من اللازم، أو يغفل العبارات التي يستخدمها الناس فعلًا، أو يتعارض مع مهارة مجاورة. عالجت Anthropic هذه المشكلة بإصدار skill-creator، وهي مهارة وصفية يمكنها إنشاء مهارات أخرى.

بعد تثبيت anthropics/skills، قل لـ Claude /skill-creator (أو ببساطة «لننشئ مهارة للتقرير الأسبوعي») واتبع سير العمل المؤلف من ست مراحل:

1. المسودة - يطرح skill-creator أسئلة: ما الذي ينبغي أن تفعله المهارة، وما العبارات المحفّزة التي ينبغي استخدامها، وما المصادر التي ينبغي قراءتها، وما الخطوات التي ينبغي اتباعها. والنتيجة أول نسخة من SKILL.md.
2. الاختبار - ينشئ skill-creator 20 مطالبة اختبارية: 10 ينبغي أن تفعّل المهارة و10 تبدو كأنها محفّزات لكن ينبغي ألا تفعل ذلك (حالات قريبة غير مطابقة).
3. التقييم - يشغّل كل مطالبة في محادثة جديدة ويتحقق مما إذا كانت المهارة قد تفعّلت. وإذا تفعّلت في موضع لا ينبغي أو لم تتفعّل في موضع ينبغي، فيضع علامة على النتيجة.
4. التكرار - يعيد كتابة الوصف استنادًا إلى الإخفاقات، ثم يشغّل الاختبارات مرة أخرى.
5. التحسين - تنقيح نهائي: يتحقق مما إذا تم تجاوز حد 1024 حرفًا وما إذا كانت هناك تعارضات مع مهارات المشروع الموجودة.
6. التجهيز - يجهز SKILL.md النهائي والملفات المرجعية بالبنية الصحيحة.

عمليًا، تجري محادثة مع Claude لمدة 15-20 دقيقة، وتجيب عن 7-8 أسئلة توضيحية، ثم تحصل في النهاية على مهارة جاهزة ومختبَرة تنشط عند المحفّزات المناسبة.

ومن الفوائد الأخرى أن skill-creator يعرض أسلوبًا نموذجيًا لكتابة SKILL.md. يمكنك فتح ملفه والاطلاع على تنسيق الخطوات ونبرتها وبنيتها. إنها حالة تعرض فيها الأداة نفسها: تقرأها فتتعلم كيفية كتابة مهارتك.

المهارات وCLAUDE.md والوكلاء الفرعيون وMCP والخطافات: أيها تستخدم؟#

أكثر مشكلة شيوعًا في المشاريع التي راجعتها هي احتواء CLAUDE.md على قواعد المشروع وتعليمات النشر خطوة بخطوة وقالب الالتزام بالتغييرات ووصف قاعدة البيانات، كلها معًا. وهذا يثقل السياق ويخفق عمليًا أيضًا: فلا ينفذ Claude تعليمة «عندما يطلب المستخدم النشر»، لأن النموذج يتعامل مع CLAUDE.md بأكمله على أنه سياق عام بلا محفّزات صريحة.

الحل هو إسناد كل عنصر إلى الوسيلة المناسبة:

في Claude Code، تتلخص الصورة في منطق بسيط: تغطي المهارات وMCP معظم تدفقات العمل، وتؤتمت الخطافات المهام الروتينية—فحوص الشيفرة والاختبارات والضوابط الوقائية. وتلزم الوكلاء الفرعيين عندما يصبح السياق ثقيلًا. وأكثر الأخطاء شيوعًا إنشاء وكيل فرعي بينما ينبغي استخدام مهارة.

شجرة القرار

عندما تفكر: «أحتاج إلى أن ينفذ Claude الأمر X»:

1. هل هذه معرفة مطلوبة طوال الوقت؟ مثلًا، «للمشروع لغة محددة» أو «لا نستخدم الشرطات الطويلة». ← ضعها في CLAUDE.md.
2. هل هو إجراء يُفعّل بمحفّز وتنفذه حاليًا يدويًا؟ مثلًا، «أكتب تقريرًا كل يوم اثنين». ← أنشئ مهارة.
3. هل تحتاج إلى الوصول إلى نظام خارجي؟ مثل واجهة Stripe API أو نظام CRM لديك. ← اربط خادم MCP.
4. هل ينبغي أن يستجيب Claude Code تلقائيًا لحدث؟ مثلًا، تشغيل أداة فحص الشيفرة بعد كل Edit. ← اكتب خطافًا.
5. هل المهمة ثقيلة، وستستهلك السياق كله، وتحتاج إلى تنفيذ شيء آخر بالتوازي؟ ← شغّلها في وكيل فرعي.

تقع 90% من مهام رائد الأعمال-مبرمج الأجواء ضمن الفئات 1-3. أما الخطافات والوكلاء الفرعيون فأدوات متقدمة تُستخدم عند تجاوز مرحلة «مهمة واحدة في كل مرة».

أوامر الشرطة المائلة والمهارات شيء واحد

من التغييرات المهمة في Claude Code: اندمج نظام أوامر الشرطة المائلة القديم (.claude/commands/) والمهارات فعليًا. ينشئ الملف .claude/commands/deploy.md والملف .claude/skills/deploy/SKILL.md كلاهما أمر /deploy. وإذا تطابقت الأسماء، فالأولوية للمهارة. لذا إذا كنت لا تزال تستخدم تنسيق أوامر الشرطة المائلة القديم، فانتقل إلى المهارات؛ إذ إن صياغتها أوضح وقدراتها أكثر.

7 أخطاء تمنع المهارة من العمل#

1. وصف بلا محفّزات: لا تتفعّل المهارة

العَرَض: كتبت مهارة وتحققت من بنيتها، وكل شيء صالح، لكن Claude لا يستدعيها استجابةً لطلبات المستخدم. والسبب غالبًا واحد: وصف مثل «مساعد لكتابة المحتوى». لا يعرف Claude العبارات التي ينبغي أن يستجيب لها. الحل: أضف 3-5 عبارات فعلية للمستخدمين بين علامتي اقتباس مباشرةً في الوصف.

2. تجاوز SKILL.md حد 500 سطر: يتشتت الانتباه

توصي Anthropic صراحةً بإبقاء متن الملف ضمن 500 سطر. إذا بلغ طول تعليماتك 2,000 سطر، يفقد Claude تركيزه، ويتبع الخطوات جزئيًا فقط، ويرتبك بشأن تسلسلها. الحل: انقل الأقسام الكبيرة إلى ملفات قريبة—examples/ وreferences/ وscripts/—وأشر إليها من SKILL.md.

3. مهارة واحدة لـ«كل ما يتعلق بالمحتوى» بدلًا من ثلاث مهارات صغيرة

إعداد مغرٍ: مهارة واحدة كبيرة باسم content تضم منشورات Telegram والصفحات المقصودة والبريد الإلكتروني. لكنها لا تنجح. تنشط المهارة استجابةً لطلبات خاطئة، وتخلط بين المنهجيات، وتنتج نتيجة وسطية. الحل: مهارة واحدة = إجراء واحد قابل للتكرار. إذا كان لديك بالفعل ثلاثة إجراءات روتينية حول «المحتوى»، فأنشئ ثلاث مهارات: telegram-post وlanding-section وemail-broadcast.

4. مهارة بلا قسم «متى يجب عدم استخدامها»: تعارضات

العَرَض: توجد مهارتان متشابهتان في المشروع، ويستدعي Claude المهارة الخاطئة. مثلًا، إحدى المهارتين للنشرة البريدية، والأخرى لرسائل الترحيب بمشاركي البرنامج تحديدًا. ومن دون بند صريح يقول «لا تفعّلها إذا كان الطلب عن قائمة بريدية عامة»، ستعمل مهارة رسائل الترحيب عند أي ذكر لـ«البريد الإلكتروني». الحل: وضّح الحالات السلبية في الوصف.

5. 50 مهارة في مشروع واحد: تُقتطع الأوصاف

من توثيق Claude Code:

إذا نزّلت 50 مجموعة مهارات من سوق ما، فستُقتطع بعض الأوصاف. وقد تختفي الكلمات المفتاحية التي كنت تعتمد عليها. الحل: أبقِ على أكثر 10-15 مهارة فائدة في المشروع النشط. احتفظ بالبقية في أرشيف غير نشط خارج جميع مجلدات اكتشاف المهارات، مثل مجلد skill-archive/ مستقل ضمن موادك. ثبّت المهارات المطلوبة فقط في نطاق المشروع أو النطاق الشخصي. إن ~/.claude/skills/ مكتبة شخصية مثبتة مرئية عبر المشاريع؛ ونقل المهارات إليها لا يخفيها من الاكتشاف.

6. مهارات من مصادر غير موثوقة: خطر أمني

تحذر Anthropic من ذلك في التوثيق الرسمي:

قد يحتوي مستودع عشوائي على GitHub على مهارة تسرّب مفاتيح واجهة API لديك عند استدعائها أول مرة. الحل: افتح SKILL.md واقرأه بنفسك قبل التثبيت. لا تشغّل مهارات من مؤلفين غير مألوفين في المشاريع المهمة.

7. المهارة بلا مجلد معرفة تنتج «ChatGPT عاديًا»

أدق الأنماط المضادة وأكثرها شيوعًا. المهارة منهجية، لكن المنهجية وحدها لا تعني شيئًا من دون سياق. إذا كتبت مهارة «أنشئ رسالة ترحيب بالبريد الإلكتروني»، ولم يتضمن المشروع ملفًا يصف الجمهور وملفًا لنبرة العلامة التجارية، فسيكتب Claude رسالة بريد إلكتروني عادية شبيهة برسائل ChatGPT، لا تتميز عن رسائل أي شخص آخر.

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

كيفية بناء أول مهارة لك في 30 دقيقة#

إليك الخطة العملية التي استخدمتها لإنشاء المهارات الأولى في مشاريعي:

الخطوة 1. اختر إجراءً واحدًا قابلًا للتكرار

افتح تقويمك للشهر الماضي. اعثر على مهمة نفذتها 4-5 مرات على الأقل، ويستغرق تنفيذها 30-60 دقيقة في كل مرة. لا تختر مجالًا واسعًا مثل «التسويق»، بل شيئًا محددًا: «تقرير مبيعات يوم الاثنين» أو «تهيئة عميل جديد» أو «تحديث قائمة الأسعار لعروض ترويجية».

كلما كانت الصياغة أضيق، كانت المهارة أبسط والمحفّز أوضح.

الخطوة 2. اكتب العملية يدويًا

في ملف منفصل أو في محادثة مع Claude (ليس للمهارة، بل بوصفه مسودة)، اكتب الخطوات التي تتبعها:

1. Open the client database
2. Filter by status "awaiting welcome email"
3. Check which channel the client came from
4. Get the email template for that channel from the "templates" folder
5. Fill in the name, product, and start date
6. Send

هذه ليست مهارة بعد؛ إنها ملاحظات. لكن من دونها ستبدأ كتابة SKILL.md وأنت مرتبك.

الخطوة 3. أنشئ بنية المجلدات

mkdir -p .claude/skills/welcome-email-new-client
touch .claude/skills/welcome-email-new-client/SKILL.md

أو، إذا كنت تريد استخدام المهارة في جميع مشاريعك، فضعها في ~/.claude/skills/.

الخطوة 4. اكتب SKILL.md باستخدام القالب

الهيكل:

---
name: welcome-email-new-client
description: |
  Prepares a welcome email for a new client using the template for their acquisition channel.
  Triggers: "write a welcome email for new client X",
  "onboard new participant Y", "welcome email for client from channel Z".
  Do not activate if the request is about a general mailing list
  or an email campaign—those are other skills.
---

# Welcome Email for a New Client

## Steps

1. Read `knowledge/audience/segments.md` - what client segments we have
2. Read `knowledge/templates/welcome/` - templates by channel
3. Identify the client's channel from the request context
4. Insert the client's name, product name, and start date
5. Check the length—it should be no more than 800 characters
6. Output the final email text in a copy-ready format

## Important

- Do not use “dear friend” or “hello”—use natural speech
- One paragraph, one idea
- End with one call to action, not two

الخطوة 5. اختبر باستخدام 5-8 مطالبات

افتح محادثة فارغة مع Claude Code في هذا المشروع. جرّب 5 عبارات تستخدمها فعلًا و3 عبارات مشابهة ينبغي ألا تفعّل المهارة:

ينبغي أن تتفعّل:

• «اكتب رسالة ترحيب بالبريد الإلكتروني للعميل الجديد Ivanov»
• «هيئ مشاركًا جديدًا اشترى البرنامج X»
• «رسالة ترحيب بالبريد الإلكتروني لعميل من Instagram»

ينبغي ألا تتفعّل:

• «أرسل بريدًا ترويجيًا إلى القائمة كلها»
• «حملة بريد إلكتروني لعطلات رأس السنة»
• «اكتب رسالة متابعة لعميل لم يدفع»

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

الخطوة 6. كرّر تعديل الوصف

بعد كل اختبار فاشل، عدّل الوصف وحده—ولا تغيّر متن التعليمات. بعد 2-3 جولات، تبدأ المهارة بالتفعيل بشكل موثوق. احفظها، وأدرجها في التزام تغييرات، ثم استخدمها كل يوم.

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

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

الإعداد العملي هو نسخة الذكاء الاصطناعي + العقل الثاني + هندسة السياق. ثلاثة أجزاء من منهجية واحدة.

إذا كنت تحتاج إلى الوصول إلى نماذج الذكاء الاصطناعي عبر Ailoot، فتعرّف على Ailoot.