مهارات Hermes Agent: تثبيت مهارتك الخاصة وإنشاؤها

المهارة تعليمة محفوظة لوكيل: تصف مرة واحدة كيفية تنفيذ مهمة، ومنذ ذلك الحين يطبقها Hermes عند استدعاء /skill-name، من دون الحاجة إلى تكرار الشرح. يمكن تثبيت مهارة جاهزة بأمر واحد، ويمكنك إنشاء مهارتك الخاصة بطريقتين: كتابة SKILL.md يدويًا أو استخدام /learn.

إذا لم تثبّت Hermes بعد، فابدأ بالدليل ما هذا الوكيل وكيفية تثبيته، ثم انتقل إلى المهارات.

ما المهارة في Hermes Agent؟#

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

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

اختر مهارة جاهزة لمهمة قياسية إذا كانت تعليماتها مناسبة وتم التحقق من مصدرها. واكتب مهارتك الخاصة عندما تحتاج إلى الحفاظ على تسلسل معين للإجراءات والقيود وتنسيق المخرجات. استخدم /learn إذا كانت لديك مواد بالفعل أو أكملت عملية ولا تريد كتابة الملف يدويًا.

التنسيق مفتوح ومتوافق مع مواصفات Agent Skills، لذا تعمل المهارات من الفهارس الأخرى عادةً في Hermes من دون أي تغيير في التنسيق، مع أن مهارة بعينها قد تحتاج إلى أدوات أو مفاتيح خاصة بها. ويمكنك أيضًا مشاركة مهارتك إذا رغبت.

ما المهارات المثبتة بالفعل وأين تُخزَّن؟#

يُنظَّم المجلد على النحو التالي:

~/.hermes/skills/
├── research/
│   └── arxiv/
│       ├── SKILL.md
│       └── scripts/
├── productivity/
│   └── pdf/
│       ├── SKILL.md
│       └── references/
└── .hub/

SKILL.md هو الملف الوحيد المطلوب. وتُضاف بقية الملفات عند الحاجة: references/ للمواد الأطول، وscripts/ للبرامج المساعدة، وtemplates/ وassets/ للقوالب والملفات.

يتضمن الفهرس المدمج مهارات للمهام اليومية: العثور على صور GIF، والعمل مع ملفات PDF وجداول البيانات وYouTube وGitHub والملاحظات. وتجد القائمة الكاملة مع الأوصاف في صفحة فهرس المهارات المدمجة. ومع كل hermes update، يحدّث Hermes المهارات المدمجة أيضًا مع الحفاظ على تعديلاتك عليها.

كيف تثبّت مهارة جاهزة من الفهرس؟#

1. ابحث في الفهرس

   hermes skills search pdf
   

   يجري البحث في جميع المصادر المتصلة. ولعرض الفهرس كاملًا من دون عامل تصفية، نفّذ hermes skills browse.

2. اعرض بطاقة المهارة

   hermes skills inspect skills-sh/anthropics/skills/pdf
   

   تعرض البطاقة الوصف والمصدر ومستوى الثقة. لا تثبّت مهارة شخص آخر قبل قراءة بطاقتها.

3. ثبّتها

   hermes skills install skills-sh/anthropics/skills/pdf
   

   ينزّل Hermes ملف SKILL.md والملفات المرافقة له، ويجري فحصًا أمنيًا، ثم يضع الملفات كلها في ~/.hermes/skills/. تصبح المهارة متاحة فورًا بوصفها الأمر /pdf. وإذا احتاجت المهارة إلى أدوات أو مفاتيح إضافية، فستُذكر في ملف SKILL.md الخاص بها، وسيخبرك Hermes بذلك أثناء التثبيت.

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

إذا أصدر الفحص تحذيرًا، يمكنك متابعة التثبيت باستخدام الخيار --force، لكن اقرأ أولًا الخطر الذي رصده. لا يمكن تجاوز حكم “dangerous”. ولا يضمن الفحص وحده السلامة: قبل تشغيل مهارة شخص آخر لأول مرة، اقرأ تعليماتها والأوامر المرافقة لها.

كيف تثبّت مهارة من GitHub أو من رابط؟#

هناك ثلاث طرق للتثبيت:

# 1. مهارة محددة من مستودع GitHub (يأتي المسار داخل المستودع بعد اسمه)
hermes skills install anthropics/skills/skills/pdf

# 2. رابط مباشر إلى SKILL.md على أي موقع (شارك هذه المهارة في محادثة)
hermes skills install '<OFFICIAL_URL>'

# 3. اربط مستودعًا كاملًا كمصدر (استبدل بالقيمتين الخاصتين بك: المالك والمستودع)
hermes skills tap add myorg/skills-repo
hermes skills install myorg/skills-repo/deploy-runbook

عند استخدام رابط مباشر، يحمّل Hermes ملف SKILL.md والملفات المذكورة فيه فقط من المجلدات الفرعية للخدمة؛ ولا يحمّل ملفات أخرى غير مرتبطة من الموقع. ويُحفظ الرابط بوصفه مصدرًا، بحيث يحدّث hermes skills update المهارة لاحقًا من العنوان نفسه.

إلى جانب GitHub، يمكن الاتصال بفهارس مهارات خارجية. ويمكنك العثور على مهاراتها باستخدام الأمر نفسه hermes skills search، مع تحديد المصدر.

كيف تستخدم المهارة بعد تثبيتها؟#

أدخل أوامر hermes ... في الطرفية، واستدعاءات /skill-name في محادثة مع الوكيل (في الطرفية نفسها أو واجهة الويب أو تطبيق مراسلة):

/gif-search funny cats
/github-pr-workflow create a PR for the authorization rewrite

إذا أدخلت /skill-name من دون مهمة، فسيحمّل Hermes التعليمات ويسألك عما تريد منه فعله. يمكنك استدعاء عدة مهارات في سطر واحد، بحد أقصى خمس؛ ويصبح النص المتبقي هو المهمة:

/github-pr-workflow /test-driven-development close issue 123 and open a PR

للتركيبات التي تستخدمها بانتظام، توجد حزم مهارات، وتُسمى bundles في مصطلحات Hermes: يجمع hermes bundles create backend-dev --skill github-pr-workflow --skill test-driven-development عدة مهارات تحت أمر قصير واحد هو /backend-dev. تعمل هذه الحزمة كاسم مستعار؛ ويجب تثبيت المهارات التي تضمها مسبقًا.

تعمل أوامر الشرطة المائلة أيضًا في Telegram إذا كانت البوابة متصلة؛ ويشرح دليل كيفية ربط Hermes Agent بـ Telegram الإعداد. وهذه طريقة ملائمة أيضًا لتشغيل المهارات من هاتفك.

كيف تنشئ مهارتك الخاصة: ماذا تضع في SKILL.md؟#

يمكنك نسخ هذه المهارة وتعديلها لتناسبك:

---
name: weekly-review
description: Weekly review: what got done, what stalled, plan for next week
version: 1.0.0
metadata:
  hermes:
    tags: [planning, review]
---

# Weekly review

## When to Use
When the user asks to review the week or put together a plan for the next one.

## Procedure
1. Get the week's task list from the file the user provided, or ask them for it.
2. Sort the tasks into three groups: done, stalled, and new.
3. Name three priorities for the coming week.

## Pitfalls
- Don't invent tasks that aren't in the original list.

## Verification
Ask the user to confirm that the tasks are correctly sorted into “done,” “stalled,” and “new.”

الترويسة الواقعة بين الشرطتين الثلاث تحتوي على البيانات الوصفية. الحقلان الأساسيان هما name (يُكتب بالأحرف اللاتينية، مع الفصل بين الكلمات بشرطات، ويُستخدم لاستدعاء المهارة كأمر) وdescription. يستخدم الوكيل حقل description ليقرر ما إذا كانت المهارة مناسبة للمهمة الحالية وينبغي تحميلها. وإذا كان الوصف مبهمًا، فقد لا تُحمّل المهارة عند الحاجة إليها.

تأتي بعد الترويسة أقسام التعليمات. يحدد When to Use متى ينبغي تحميل المهارة. ويشرح Procedure الخطوات. أما Pitfalls فيغطي الأخطاء الشائعة التي يقع فيها الوكيل وكيفية تجنبها. ويشرح Verification كيفية التحقق من النتيجة. إذا كانت التعليمات طويلة، فانقل المحتوى الأساسي إلى ملفات داخل references/؛ إذ لن تُحمّل إلا عند الحاجة، وضع البرامج المساعدة في scripts/.

إذا احتاجت المهارة إلى مفتاح API، فأعلِن عنه في الترويسة باستخدام required_environment_variables؛ لا تضع المفتاح نفسه في الملف، بل أعلن عن اسم المتغير فقط. سيطلب Hermes القيمة مرة واحدة عند أول استدعاء في طرفية محلية، ثم يمررها تلقائيًا (وفي تطبيقات المراسلة سيطلب منك إعداد المفتاح محليًا). الحقول platforms وconfig وblueprint وغيرها موضحة في صفحة الوثائق الرسمية Creating Skills.

بعد تجهيز الملف، اتبع الخطوات التالية:

1. أنشئ مجلد المهارة

   mkdir -p ~/.hermes/skills/weekly-review
   

   يطابق اسم المجلد قيمة الحقل name في الترويسة.

2. احفظ SKILL.md

   ضع ملفًا باسم SKILL.md يتضمن تعليماتك داخل المجلد؛ ويمكنك استخدام المثال أعلاه وتعديله لمهمتك.

3. استدعِ المهارة وتحقق منها

   أدخل /weekly-review واطلب من الوكيل مراجعة أسبوعك. إذا اتبع الخطوات الواردة في تعليماتك، فهذا يعني أن المهارة تعمل.

كيف تنشئ مهارة من مواد موجودة باستخدام /learn؟#

/learn توثيق واجهة demo API في ~/projects/example-docs، وخصوصًا القسم المتعلق بالمصادقة
/learn https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
/learn كيف نشرت للتو موقعًا على خدمة استضافة

إذا أكملت للتو عملية معقدة مع الوكيل، فاطلب من /learn حفظها كمهارة بينما لا تزال جميع الخطوات في المحادثة. في المرة التالية، سيكرر Hermes الإجراء باستخدام التعليمات الجاهزة.

المصدر الكبير، مثل كتاب أو مواصفة أو أرشيف مستندات، لا يتسع له ملف واحد. سينشئ Hermes ملف SKILL.md موجزًا يتضمن خريطة للموضوعات، وينقل التفاصيل إلى references/. ولا تشغل هذه الملفات مساحة في السياق إلا عند تحميلها للإجابة عن سؤال. إن استدعاء /learn مرة أخرى للموضوع نفسه يضيف إلى المهارة الموجودة بدلًا من إنشاء نسخة مكررة.

كيف تتحقق من أن المهارة تعمل؟#

hermes chat --toolsets skills -q "review my week using the weekly-review skill: done - report and calls, stalled - hosting payment"

هذا هو الاختبار الذي توصي به الوثائق: شغّل المهارة وتحقق من اتباع الوكيل لتعليماتك. إذا لم يفعل ذلك، فتحقق من ثلاثة أسباب محتملة. أولًا، قد لا يتطابق اسم المجلد أو قيمة name في الترويسة مع الاسم الذي تستدعيه. ثانيًا، قد لا يوضح الوصف متى ينبغي استخدام المهارة؛ أعد صياغته باستخدام كلمات المهمة نفسها. ثالثًا، قد لا يكون المجلد داخل ~/.hermes/skills/، ولذلك لا يستطيع Hermes العثور عليه. لاحظ أن الخيار --toolsets skills يقيّد مجموعة الأدوات المستخدمة في الاختبار: فهو يوضح كيفية تعامل الوكيل مع التعليمة، لكنه لا يتحقق من تبعيات المهارة، مثل البرامج الخارجية.

يعرض الأمر hermes skills list في الطرفية ما هو مثبت بالضبط.

المهارات جزء من نسخة AI مستنسخة: طريقة لتسجيل كيفية أدائك لمهمة مرة واحدة كي يتمكن الوكيل من تكرارها من دون تذكير. ويجمع هذا النهج بين نسخة AI + Second Brain + Context Engineering. ويساعد هذا المزيج على نقل منطق عملك وسياق المهمة إلى الوكيل.

كيف تحدّث المهارات وتزيلها؟#

hermes skills check      # ما الذي تغير في المصادر
hermes skills update     # تنزيل الإصدارات الجديدة
hermes skills uninstall pdf   # إزالة مهارة من hub

لإزالة مهارة أنشأتها يدويًا، احذف مجلدها من ~/.hermes/skills/. وإذا خصصت مهارة شخص آخر، فسيتركها update كما هي: يقارن Hermes قيم التجزئة ويتخطى الملفات التي تغيّرت تجنبًا للكتابة فوق عملك. لاستعادة النسخة الأصلية لمهارة من hub، استخدم hermes skills update name --force؛ وللمهارة المدمجة، استخدم hermes skills reset name --restore. يستبدل كلا الأمرين تعديلاتك، لذا احفظ نسختك أولًا.

إذا لم تكن بحاجة إلى المهارات المدمجة وكانت تزحم القائمة، فسيعطّل hermes skills opt-out إضافتها أثناء التحديثات. كما سيزيل الأمر opt-out --remove المهارات التي لم تعدّلها.

ماذا تفعل إذا لم تُثبَّت المهارة أو لم تعمل؟#

يعثر Hermes على المهارات في المجلدين .hermes/skills/ و.agents/skills/ داخل مستودع git. وقبل تحميلها، يجب أن تضع علامة موثوق على المستودع، لأن هذه الملفات تحتوي على تعليمات سيتبعها الوكيل. بعد ذلك، لا تعمل مهارات المستودع إلا داخله وتخضع للفحص الأمني نفسه. ولا تحتاج إلى وضع علامة موثوق على المستودع إلا مرة واحدة.

بماذا تبدأ؟#

للمتابعة في هذا الموضوع: كيفية ربط Hermes Agent بـ Telegram كي تتمكن من استدعاء المهارات من هاتفك، وكيفية إبقاء وكيل يعمل على خادم على مدار الساعة إذا أردت جدولة المهارات. وإذا كنت تختار وكيلًا، فراجع المقارنة OpenClaw أم Hermes Agent.