בלוג

כישורי Hermes Agent: התקנת כישור ויצירת כישור משלכם

Markdown

ספריות ו-GitHub, פורמט SKILL.md,‏ /learn, בדיקה, עדכון והסרה של כישורי Hermes Agent, עם דוגמאות מלאות לפקודות.

קריאת המאמר המלא

כישור הוא הנחיה שמורה לסוכן: מתארים פעם אחת איך לבצע משימה, ומאותו רגע Hermes מחיל אותה כשמפעילים את /skill-name, בלי צורך בהסברים חוזרים. אפשר להתקין כישור מוכן בפקודה אחת, ואפשר ליצור כישור משלכם בשתי דרכים: לכתוב ידנית קובץ SKILL.md או להשתמש ב-/learn.

אם עדיין לא התקנתם את Hermes, התחילו במדריך מהו הסוכן הזה ואיך מתקינים אותו, ואז עברו לכישורים.

הוראות מעשיות לשימוש ב-Ailoot מופיעות בתיעוד.

מהו כישור ב-Hermes Agent?

הנקודה המרכזית

כישור הוא קובץ שמכיל הוראות לסוכן: מה לעשות, באילו פקודות להשתמש, למה לשים לב ואילו טעויות נפוצות. הוא נשמר בתיקייה ~/.hermes/skills/ כקובץ SKILL.md, יחד עם חומרים נלווים. לאחר ההתקנה, הכישור הופך אוטומטית לפקודת /name בכל צ'אט עם הסוכן.

כותבים הנחיה בהודעה לסוכן. כישור נשמר בקובץ נפרד, ו-Hermes יכול להשתמש בהנחיה הזאת במשימות עתידיות. לסוכן יש גישה לרשימת שמות ותיאורים, והוא טוען את טקסט הכישור המלא כשהוא רלוונטי למשימה. כך נחסך מקום בהקשר: לא כל ההוראות נטענות בבת אחת.

כישור כשלעצמו אינו מעניק לסוכן כלים או גישה חדשים; הוא מתאר איך להשתמש בכלים שכבר יש לו. אינטגרציה חדשה עם שירות חיצוני מתבצעת באמצעות MCP, וזה נושא נפרד. אם משימה דורשת לוגיקה מדויקת של תוכנית, הרשאה מיוחדת או עיבוד של זרם אירועים, היא זקוקה לכלי סוכן; כישור לבדו אינו מספיק.

בחרו כישור מוכן למשימה סטנדרטית אם ההוראות שלו מתאימות והמקור שלו נבדק. כתבו כישור משלכם כשצריך לשמר את רצף הפעולות, האילוצים ופורמט הפלט הייחודיים לכם. השתמשו ב-/learn כשכבר יש לכם חומרים או כשסיימתם תהליך ואינכם רוצים לכתוב את הקובץ ידנית.

כישורים הם מסמכים המכילים מידע שסוכן זקוק לו, והוא טוען אותם רק כשצריך.

— תיעוד Hermes Agent (מתורגם מאנגלית), https://hermes-agent.nousresearch.com/docs/user-guide/features/skills

הפורמט פתוח ותואם למפרט Agent Skills, כך שכישורים מקטלוגים אחרים פועלים בדרך כלל ב-Hermes ללא שינויי פורמט, אף שכישור מסוים עשוי לדרוש כלים או מפתחות משלו. אפשר גם לשתף כישור שיצרתם.

אילו כישורים כבר מותקנים, ואיפה הם נשמרים?

הנקודה המרכזית

כברירת מחדל, כישורים נשמרים בתיקייה ~/.hermes/skills/, ומאורגנים בתיקיות משנה לפי קטגוריה (אם אתם משתמשים בפרופיל לא סטנדרטי או במשתנה HERMES_HOME, הנתיב יהיה שונה; הפקודה hermes config path תציג אותו). לאחר ההתקנה, Hermes כבר כולל עשרות כישורים מובנים, מחיפוש ב-arXiv ועד עבודה עם GitHub ומסמכים. הפקודה hermes skills list מציגה את הרשימה, ואפשר לשאול בצ'אט את הסוכן אילו כישורים זמינים לו.

התיקייה מאורגנת כך:

~/.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 מעדכן גם את הכישורים המובנים תוך שמירה על השינויים שלכם בהם.

איך מתקינים כישור מוכן מהקטלוג?

הנקודה המרכזית

פתחו את הקטלוג באמצעות hermes skills browse, מצאו את מה שאתם צריכים בעזרת hermes skills search, הציגו כרטיס כישור באמצעות hermes skills inspect והתקינו אותו באמצעות hermes skills install. כל כישור עובר בדיקת אבטחה לפני ההתקנה, וכישורים רשמיים אינם מעוררים אזהרה על מקור צד שלישי.

  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 יודיע לכם על כך במהלך ההתקנה.

בדיקת האבטחה מחפשת ניסיונות לשלוח נתונים החוצה, הוראות שהוזרקו עבור הסוכן ופקודות שעלולות למחוק קבצים או להזיק להם. למקורות יש רמות אמון שונות:

רמהמקור הכישורמה קורה במהלך ההתקנה
מובנהכלול ב-Hermesכבר זמין; אין צורך בהתקנה
רשמיתיקיית optional-skills במאגר Hermesמותקן ללא אזהרה על מקור צד שלישי: hermes skills install official/security/1password
מהימןהמאגרים openai/skills,‏ anthropics/skills,‏ huggingface/skills ו-NVIDIA/skillsבדיקה פחות מחמירה
אחרקטלוגים, מאגרי GitHub של אחרים וקישורים ישיריםאזהרה ובדיקה מלאה

אם הבדיקה מציגה אזהרה, אפשר להמשיך בהתקנה באמצעות הדגל --force, אבל קודם קראו איזה סיכון היא זיהתה. אי אפשר לעקוף פסק דין שלפיו הכישור ״מסוכן״. הבדיקה עצמה אינה מבטיחה שהכישור בטוח: לפני ההפעלה הראשונה של כישור של מישהו אחר, קראו את ההוראות שלו ואת הפקודות הנלוות.

איך מתקינים כישור מ-GitHub או מקישור?

הנקודה המרכזית

התקינו כישור מ-GitHub באמצעות hermes skills install owner/repository/path, או השתמשו בקישור ישיר לקובץ SKILL.md; Hermes יוריד את הקבצים הנלווים אליו. אפשר לחבר מקור כישורים משלכם באמצעות hermes skills tap add, ולאחר מכן הוא פועל כמו כל קטלוג אחר.

שלוש דרכים להתקנה:

# 1. A specific skill from a GitHub repository (the path inside the repository comes after its name)
hermes skills install anthropics/skills/skills/pdf

# 2. A direct link to a SKILL.md on any site (share this skill in a chat)
hermes skills install '<OFFICIAL_URL>'

# 3. Connect an entire repository as a source (replace with your owner and repository)
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, תוך ציון המקור.

לתשומת לבכם

GitHub מגביל בקשות ללא אימות ל-60 בשעה. אם מופיעות שגיאות של חריגה ממכסת הבקשות בזמן התקנה או חיפוש, הוסיפו GITHUB_TOKEN לקובץ ~/.hermes/.env; המגבלה תגדל ל-5000 בקשות בשעה.

איך משתמשים בכישור אחרי ההתקנה?

הנקודה המרכזית

כישור מותקן הופך אוטומטית לפקודה: הקלידו /skill-name ואת המשימה באותה שורה. אין צורך בהפעלה נפרדת. הוא פועל בטרמינל, בממשק האינטרנט ובהודעות דרך השער. אפשר להפעיל עד חמישה כישורים בהודעה אחת, או להפוך שילוב שחוזר על עצמו לפקודה אחת.

הקלידו פקודות 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?

הנקודה המרכזית

כישור משלכם הוא תיקייה בתוך ~/.hermes/skills/ ובה קובץ נדרש אחד, SKILL.md: כותרת קצרה עם שם ותיאור, ואחריה הוראות המחולקות לסעיפים—מתי להשתמש בו, רצף הפעולות, טעויות נפוצות ואימות. כותבים אותו בטקסט פשוט; אין צורך בתכנות. לגרסה פשוטה מספיקות תיקייה אחת וקובץ אחד.

כישורים הם הדרך העיקרית להוסיף יכולות חדשות ל-Hermes Agent: קל יותר ליצור אותם מאשר כלים, הם אינם דורשים שינויים בקוד של הסוכן, ואפשר לשתף אותם עם הקהילה.

— תיעוד Hermes Agent (מתורגם מאנגלית), https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills

אפשר להעתיק את הכישור הזה ולהתאים אותו לצרכים שלכם:

---
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. הסוכן משתמש בשדה התיאור כדי להחליט אם הכישור מתאים למשימה הנוכחית ויש לטעון אותו. אם התיאור עמום, ייתכן שהכישור לא ייטען כשצריך.

אחרי הכותרת מופיעים סעיפי ההוראות. When to Use מציין מתי לטעון את הכישור. Procedure מפרט את השלבים. Pitfalls מתאר טעויות נפוצות של הסוכן ואיך להימנע מהן. Verification מסביר איך לבדוק את התוצאה. אם ההוראות ארוכות, העבירו את התוכן העיקרי לקבצים בתיקיית references/; הם ייטענו רק כשיהיה בהם צורך, והכניסו תוכניות עזר לתיקיית scripts/.

טיפ

הציגו תחילה את התרחיש הנפוץ ביותר ואת המקרים הנדירים בסוף הקובץ. Hermes קורא כישור מלמעלה למטה, והסדר הזה חוסך מקום בהקשר.

אם כישור זקוק למפתח 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 יוצרת כישור מחומרים קיימים: תנו לה תיקיית תיעוד, קישור לעמוד, את ההערות שלכם או תיאור מילולי של תהליך, ו-Hermes יכתוב עבורכם SKILL.md לפי מוסכמות מקובלות, כדי שתוכלו לבדוק אותו. ספר או ארכיון גדול יפיקו כישור עם קבצים נפרדים לפי נושא.

/learn documentation for the demo API in ~/projects/example-docs, especially the section on authentication
/learn https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
/learn how I just published a site to hosting

אם זה עתה השלמתם תהליך מורכב עם הסוכן, בקשו מ-/learn לשמור אותו ככישור בעוד כל השלבים עדיין מופיעים בשיחה. בפעם הבאה, Hermes יחזור על התהליך באמצעות ההוראות המוכנות.

מקור גדול, כגון ספר, מפרט או ארכיון מסמכים, לא יוכל להיכנס לקובץ יחיד. Hermes ייצור SKILL.md תמציתי עם מפת נושאים ויעביר את הפרטים ל-references/. הקבצים האלה אינם תופסים מקום בהקשר עד שהסוכן טוען אותם כדי לענות על שאלה. הפעלה חוזרת של /learn באותו נושא מוסיפה לכישור הקיים במקום ליצור כפילות.

איך בודקים שכישור עובד?

הנקודה המרכזית

כדי לבדוק אותו, הריצו hermes chat --toolsets skills -q ותנו לסוכן בקשה הקשורה לכישור, למשל בקשו ממנו לסקור שבוע באמצעות רשימת משימות. אם הסוכן ממיין את המשימות לקבוצות שבהוראות שלכם, הכישור עובד. אם הוא משיב כרגיל, בדקו את שם הקובץ, את התיאור בכותרת ואת מיקום התיקייה.

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 + מוח שני + הנדסת הקשר. שילוב זה עוזר להעביר לסוכן את היגיון העבודה ואת ההקשר של המשימה.

איך מעדכנים ומסירים כישורים?

הנקודה המרכזית

הפקודה hermes skills check מציגה אילו כישורים מותקנים עודכנו במקור שלהם, hermes skills update מורידה את הגרסאות החדשות, והפקודה hermes skills uninstall name מסירה כישור. השינויים שלכם בכישור של מישהו אחר נשמרים במהלך העדכונים: Hermes מדלג על קבצים ששונו. אפשר לשחזר את המקור: לכישור מה-hub השתמשו ב-hermes skills update name --force; לכישור מובנה השתמשו ב-hermes skills reset name --restore.

hermes skills check      # what changed at the sources
hermes skills update     # download new versions
hermes skills uninstall pdf   # remove a skill from the hub

כדי להסיר כישור שיצרתם ידנית, מחקו את התיקייה שלו מתוך ~/.hermes/skills/. אם התאמתם אישית כישור של מישהו אחר, update ישאיר אותו כפי שהוא: Hermes משווה גיבובים ומדלג על קבצים ששונו כדי להימנע מדריסת העבודה שלכם. כדי לשחזר את המקור של כישור מה-hub, השתמשו ב-hermes skills update name --force; לכישור מובנה השתמשו ב-hermes skills reset name --restore. שתי הפקודות דורסות את השינויים שלכם, לכן שמרו קודם את הגרסה שלכם.

אם אינכם זקוקים לכישורים המובנים והם מעמיסים על הרשימה, hermes skills opt-out ישבית את הוספתם במהלך העדכונים. הפקודה opt-out --remove גם תסיר את אלה שלא שיניתם.

מה לעשות אם כישור לא מתקין או לא עובד?

הנקודה המרכזית

שלושה דברים מפריעים לרוב: המגבלה של GitHub,‏ 60 בקשות בשעה; חסימת התקנה על ידי בדיקת האבטחה; והימצאות הקובץ בתיקייה הלא נכונה. אם חרגתם ממכסת הבקשות, הוסיפו GITHUB_TOKEN. אם הבדיקה חסמה את ההתקנה, קראו את פסק הדין שלה. אם Hermes אינו מוצא את הכישור, בדקו אם הוא נמצא ב-~/.hermes/skills/.

תסמיןסיבהמה לעשות
שגיאות חריגה ממכסת הבקשות בזמן חיפוש או התקנהבלי אסימון, GitHub מאפשר עד 60 בקשות בשעההוסיפו GITHUB_TOKEN ל-~/.hermes/.env
ההתקנה נחסמההבדיקה זיהתה סיכון בקוד הכישורקראו את פלט הבדיקה במהלך ההתקנה; כדי לבדוק מחדש כישור מותקן, הריצו hermes skills audit. אם זו אזהרה, אפשר להמשיך עם --force; אם פסק הדין הוא ״מסוכן״, אי אפשר
הכישור הותקן, אבל /name לא עובדהשם אינו תואם או שהתיקייה אינה במקומההריצו hermes skills list ובדקו את התיקייה ~/.hermes/skills/
הכישור כלל אינו מופיע ברשימהלקובץ SKILL.md יש הגבלה על הפלטפורמה או על הכלים הנדרשיםפתחו את SKILL.md ובדקו את השדות platforms ו-requires_*
גרסת כישור חדשה לא הורדה אחרי עדכוןשיניתם את הקובץ מקומית, ו-Hermes שומר על השינויים שלכםאם דרוש לכם המקור, השתמשו ב-update name --force לכישור מה-hub או ב-reset --restore לכישור מובנה; אם הגרסה שלכם חשובה יותר, אל תעשו דבר
כישורים ממאגר אחר אינם נטעניםיש לסמן את המאגר כמהימןהריצו hermes skills trust מתוך המאגר

Hermes מוצא כישורים בתיקיות .hermes/skills/ ו-.agents/skills/ בתוך מאגר git. לפני הטעינה שלהם, יש לסמן את המאגר כמהימן: הקבצים האלה מכילים הוראות שהסוכן יפעל לפיהן. לאחר מכן, הכישורים מהמאגר פועלים רק בתוכו ועוברים את אותה בדיקת אבטחה. צריך לסמן את המאגר כמהימן פעם אחת בלבד.

מה כדאי לעשות קודם?

הנקודה המרכזית

התקינו כישור מוכן אחד מהקטלוג; ההתקנה דורשת פקודה אחת בלבד. אחר כך קחו הנחיה שאתם חוזרים עליה, העבירו אותה אל /learn ובדקו את התוצאה במשימה אמיתית מהעבודה שלכם.

ההמשך בנושא: איך לחבר את Hermes Agent ל-Telegram, כדי שתוכלו להפעיל כישורים מהטלפון, ואיך להשאיר סוכן פועל בשרת מסביב לשעון, אם אתם רוצים כישורים מתוזמנים. אם אתם בוחרים סוכן, ראו את ההשוואה OpenClaw או Hermes Agent.

אפשר להמשיך להכיר את Ailoot ב-ailoot.ai.

פרטים נוספים

שאלות ותשובות: כישורי Hermes Agent: התקנת כישור ויצירת כישור משלכם

למה מיומנות מותקנת אינה מופיעה כפקודת slash?

בדקו את רשימת המיומנויות המותקנות, את שם הקובץ SKILL.md ושדה name ואת תיקיית skills של הפרופיל הפעיל. גם הגבלות פלטפורמה, כלי נדרש או אמון במאגר יכולות למנוע טעינה.

האם בדיקת העשן המוגבלת של skills מאמתת כל תלות?

לא. בדיקה של מיומנות בלבד בוחנת אם הסוכן טוען ומיישם את ההוראה. בדקו בנפרד כלים, תוכנות ומפתחות נדרשים ואז אמתו תוצאה אמיתית מוגבלת אחת לפני שימוש בתהליך המלא.

כל המאמרים