התקנה וניהול מיומנויות

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

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

המיומנויות יושבות בהגדרות ← סביבת עבודה ← מיומנויות (/workspaces/<id>/settings/workspace/skills). הן מוגבלות לסביבת עבודה: המיומנויות שאתם מתקינים כאן שייכות לסביבת העבודה הזו בלבד. לדף שתי לשוניות: מותקנות (מיומנויות מקומיות, ובהן עורך מיומנות חדשה) ומקורות (קטלוגים של GitHub). שתי פעולות הכתיבה עוברות באותו שער סריקה.

הוספת מאגר מיומנויות

1. פתחו את הגדרות ← סביבת עבודה ← מיומנויות ועברו ללשונית מקורות.
2. לחצו על הוסף מאגר.
3. הדביקו כתובת URL של מאגר GitHub, למשל https://github.com/anthropics/skills, ואשרו.

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

המיומנויות של מאגר הן הספריות שמכילות SKILL.md (עד שלוש רמות עומק, ובנוסף פריסת שוק התוספים של Claude plugins/<plugin>/skills/<skill>, כשעצי תלויות ו-vendor מדולגים). אם הרשת אומרת בהמשך שלמאגר אין מיומנויות, זה בדיוק מה שזה אומר: שום ספרייה בו אינה תואמת למוסכמת המיומנויות.

בדיקת מיומנות לפני התקנה

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

• קובץ ה-README, מרונדר כ-markdown — ה-README.md של ספריית המיומנות, או גוף ה-SKILL.md כשאין README.
• תצוגת הסריקה המקדימה — הכרעת הסריקה (pass, warn או quarantine), היכולות שתכני המיומנות מצהיר עליהן (הרצת shell, כתיבת קבצים, גישה לרשת…) וכל ממצא שהסורק רשם.
• מספר הקבצים — התקנה כותבת את כל ספריית המיומנות, ולא רק את ה-SKILL.md שלה.

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

התקנת מיומנות

1. פתחו את תצוגת הפרטים של המיומנות.
2. קראו את הכרעת הסריקה. בהכרעה warn או pass, לחצו על התקנה.
3. בהכרעת quarantine, ההתקנה נשארת מושבתת עד שתסמנו אני מבין את הסיכון — התקן בכל זאת. העקיפה הזו נרשמת, ולא מונחת מאליה.

ההתקנה כותבת את ספריית המיומנות לתוך סביבת העבודה, רושמת הצמדה ב-skills-lock.json (מאגר המקור, הנתיב, הקומיט שממנו הגיעה וגיבוב תוכן), והמיומנות נעשית זמינה לסוכנים בסביבת העבודה. כרטיס שמסומן השם תפוס אומר שמיומנות אחרת כבר מחזיקה בשם הזה מקומית — הסירו את ההתקנה שלה קודם.

עדכון מיומנויות לאורך זמן

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

הסרת ההתקנה של מיומנות והסרת מאגר

הסר התקנה (בתצוגת הפרטים של מיומנות מותקנת, או מחיקה בלשונית מותקנות) מסיר יחד את ספריית המיומנות ואת הצמדת הנעילה שלה — מיומנות שהוסרה אינה משאירה דבר אחריה.

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

הפעלת מיומנות

מיומנויות מופעלות תחת מרחב השמות שלהן עצמן, ולכן הן לעולם אינן מתנגשות בפקודות קו נטוי מובנות (/plan, /goal, /loop, /compact):

• /skill:<name> — מיומנות מותקנת בסביבת העבודה הזו, או מיומנות שמחוברת לסוכן
• /skill:<repo>:<name> — מיומנות שמסופקת על ידי מאגר שבוצע לו checkout במרחב הזה

שם חשוף שאינו מובנה עדיין נפתר, עבור הודעות שנכתבו לפני שמרחב השמות היה קיים. /skill:plan הוא מה שמגיע למיומנות בשם plan; /plan הוא תמיד המובנה.

מיומנויות בהיקף מאגר

מאגר שבוצע לו checkout יכול לספק מיומנויות משלו, ב-.agents/skills/, .agent/skills/, .claude/skills/, .opencode/skills/ או skills/. אלה אינן מותקנות דרך הדף הזה. סוכן נושא רק את המיומנויות של המאגר שהוא עובד בו כרגע; הן מתחלפות כשהוא עובר. תיבת הכתיבה אינה מוגבלת כך: /skill:<repo>:<name> מגיע לכל מאגר במרחב.

מיומנויות של מאגר עוברות את אותה סריקה שנכשלת באופן סגור (pass / warn / quarantine) לפני שה-frontmatter שלהן מגיע להנחיה. warn מתקבלת; quarantine נחסמת, בלי עקיפת מפעיל במסלול הזה.

ראו מיומנויות בהיקף מאגר ופקודות קו נטוי.

מדריכים קשורים

• צ’אט עם סוכן
• יצירה והגדרה של סוכן

מושגים קשורים

• מודל הסוכן