מהי מיומנות של סוכן (Agent Skill) ואיך היא עובדת?
גלו כיצד מבנה התיקיות של Agent Skill וקובץ ה-SKILL.md מאפשרים לסוכן לטעון הנחיות רק בעת הצורך. הסבר על ההבדלים בין מיומנויות לבין פרומפט ענק ופרוטוקול MCP.
מהי למעשה מיומנות של סוכן (Agent Skill)
מיומנות של סוכן היא תיקייה בדיסק המכילה קובץ בשם SKILL.md. קובץ זה כולל שם, תיאור קצר והנחיות הכתובות בפורמט markdown פשוט. הסוכן טוען את התיאור בעת ההפעלה, והוא קורא את ההנחיות רק כאשר הבקשה שלך תואמת לתיאור זה או כאשר אתה מפעיל את המיומנות בשמה. כמעט כל שאר המאפיינים של מיומנויות נגזרים משני משפטים אלו.
התיקייה עשויה להכיל יותר מקובץ אחד. מפרט ה-Agent Skills מגדיר שלוש ספריות אופציונליות: scripts/ עבור קוד שהסוכן מריץ, references/ עבור מסמכים שהוא קורא בעת הצורך, ו-assets/ עבור תבניות ונתונים. אף אחת מהן אינה הכרחית. תיקייה שאין בה דבר מלבד SKILL.md מהווה מיומנות מלאה ותקינה.
restore-drill/
SKILL.md
references/retention-policy.md
scripts/verify_snapshot.shהתיאור הוא החלק שאנשים נוטים להמעיט בערכו. זהו הטקסט היחיד שהסוכן רואה לפני שהוא מחליט אם לפתוח את המיומנות כלל, לכן עליו לציין מה המיומנות עושה ומתי להשתמש בה, תוך שימוש במילים שאדם אמיתי היה מקליד.
מדוע מיומנות כמעט אינה עולה דבר עד לשימוש בה
זהו הטיעון שהופך את הבנת הפורמט לכדאית, והוא נוגע להקשר (context), לא לתכונות. הטעינה מתבצעת בשלבים, תהליך שהמפרט מכנה "חשיפה הדרגתית" (progressive disclosure).
בעת ההפעלה, הסוכן טוען את ה-name ואת ה-description של כל מיומנות מותקנת, ולא שום דבר מעבר לכך. מפרט ה-Agent Skills מעריך זאת בכ-100 אסימונים (tokens) לכל מיומנות (לפי הנחיות שפורסמו, נכון לאוקטובר 2026). התקנה של תריסר מיומנויות תצרוך נפח הקשר השווה בערך לפסקה אחת ארוכה.
כאשר בקשה תואמת לתיאור, הסוכן קורא את גוף ה-SKILL.md הספציפי הזה. המפרט ממליץ לשמור על גוף המיומנות מתחת ל-5,000 אסימונים ועל הקובץ מתחת ל-500 שורות. קבצים ב-references/ וב-scripts/ עדיין אינם עולים דבר בשלב זה. קובץ עזר נטען רק אם ההוראות מפנות את הסוכן אליו. סקריפט ארוז (bundled script) פועל אחרת: הסוכן מריץ אותו דרך ה-shell, כך שקוד המקור של הסקריפט לעולם אינו נכנס לחלון ההקשר, ורק הפלט שלו נכנס.
כעת, השוו זאת לגישה הראשונית שבה אנשים נוקטים: הנחיה (prompt) אחת עצומה. כל שורה בהנחיית מערכת או בקובץ הוראות קבוע משולמת בכל בקשה, בכל סשן, בין אם המשימה זקוקה לה ובין אם לא, והיא מתחרה על תשומת הלב מול השאלה עצמה. עשרת אלפים אסימונים של הוראות קבועות הם חשבון שאתם משלמים גם כשאתם רק שואלים מה השעה. תריסר מיומנויות עולות כ-1,200 אסימונים לפני הפעלה, אך הוראות שנטענו יכולות להישאר בהקשר עבור משימות מאוחרות יותר באותה שיחה. זהו כל הטיעון בעד מיומנויות, וזו הסיבה שספרייה קטנה עדיפה על הנחיה ארוכה.
סייג אחד מפתיע אנשים. ב-Claude Code, ברגע שמיומנות נטענת, הגוף שלה נשאר בשיחה לאורך תורות מאוחרים יותר, כך ש-SKILL.md ארוך הוא עלות חוזרת ולא חד-פעמית. דחיסה (compaction) יכולה לקצץ או להסיר תוכן של מיומנות שנטענה. העברת פרטים ל-references/ אינה עניין של סדר וארגון; זהו המנגנון הפועל כפי שתוכנן.
מיומנות של סוכן אינה קריאה לכלי (tool call)
כלי, המכונה גם קריאה לפונקציה (function call), הוא רכיב שהמודל יכול להפעיל. ה-harness שולח למודל סכימה: שם, תיאור ומבנה הארגומנטים. המודל מנפיק קריאה, הקוד שלכם מריץ אותה, והתוצאה חוזרת כהודעה. כלים מבצעים פעולות. שני חלקי התהליך הזה שייכים ל-harness, התוכנית שמריצה את הלולאה סביב המודל, והיא גם זו שקוראת את תיאורי המיומנויות שלכם בעת העלייה ומחליטה מתי לפתוח אחת מהן.
מיומנות אינה מבצעת דבר בעצמה. הסוכן קורא אותה, ולאחר מכן פועל באמצעות הכלים שכבר עמדו לרשותו. Claude Code מקבל ארגומנטים כאשר מיומנות מופעלת ומכניס אותם להוראות שלו דרך placeholders כגון $ARGUMENTS. מה שמיומנות יכולה לעשות הוא להורות למודל באילו כלים להשתמש, באיזה סדר, ומה לבדוק לאחר מכן. העברת משימה לסוכן שני היא הדוגמה המובהקת ביותר: סשן אחד של Claude Code כבר יכול לשלוח הודעה לאחר, והמיומנות היא המקום שבו אתם מגדירים מתי כדאי לעשות זאת ומה לשלוח.
הגרסה הקצרה: כלי מעניק לסוכן יכולת חדשה, ומיומנות מעניקה לו בעיקר שיקול דעת לגבי יכולות שכבר יש לו. כאשר מיומנות אכן מוסיפה יכולת, היא עושה זאת באמצעות סקריפט מצורף שהסוכן מריץ עם ה-shell שכבר היה לו. אם שלב מסוים חייב להפיק תוצאה מדויקת ומאומתת בכל פעם, אתם זקוקים לכלי או לסקריפט. אם שלב דורש הפעלה עקבית של אותו תהליך מחשבתי, אתם זקוקים למיומנות. מיומנות יכולה להסתכם בשיקול דעת בלבד ועדיין להיות זו שתשתמשו בה הכי הרבה, כפי שמראה Ponytail, שדוחף סוכן תכנות לבצע את השינוי הקטן ביותר שעובד: היא אינה מוסיפה יכולת חדשה אלא רק משנה את האופן שבו הסוכן משתמש ביכולות הקיימות שלו. שיקול דעת זה יכול לפעול גם בכיוון ההפוך, ו-המיומנות unlazy, שעוברת על Depth Tree כדי למנוע מהסוכן להכריז על משימה כגמורה בטרם עת היא אותו תעלול, המכוון ליסודיות במקום לאיפוק.
מיומנות של סוכן אינה שרת MCP
MCP (ראשי תיבות של Model Context Protocol) הוא פרוטוקול לחיבור סוכן למערכת חיצונית. שרת MCP הוא תהליך שרץ, מדבר בפרוטוקול זה, וחושף כלים לסוכן. הוא דורש בדרך כלל הגדרות, אישורי גישה, ופקודה מקומית או נקודת קצה ברשת. מיומנות (skill) היא תיקייה המכילה קובץ markdown. אין כאן תהליך, אין פורט ואין פרוטוקול.
עלות ההקשר (context cost) שונה באותו אופן. כל כלי ששרת MCP חושף נושא שם, תיאור וסכימת ארגומנטים; בלקוח שטוען אותם מראש, אלו יושבים בבקשה לאורך כל הסשן, בין אם נעשה בהם שימוש ובין אם לא. Claude Code כבר לא עובד כך כברירת מחדל: החל מאוקטובר 2026, חיפוש הכלים שלו פעיל מחוץ לקופסה, כך שרק שמות הכלים והוראות השרת נטענים בתחילת הסשן, וההגדרות המלאות מגיעות כאשר Claude מחפש אותן. מיומנות במצב מנוחה היא שורת טקסט אחת בלבד.
השניים משלימים זה את זה, וההגדרות החזקות ביותר מריצות את שניהם. שרת ה-MCP מספק את הגישה. המיומנות מספקת את הנוהל: באילו מכלים אלו להשתמש עבור זרימת העבודה האמיתית של הצוות שלכם, באיזה סדר, ואיך נראית תוצאה טובה. אם אתם מארחים שרתים בעצמכם, הרצת שרתי MCP על גבי VPS מכסה את הצד הזה.
מיומנות של סוכן (agent skill) אינה זהה ל-system prompt או ל-AGENTS.md
שני המושגים הם הנחיות בפורמט markdown, ולכן הבלבול מובן. ההבדל טמון במועד הטעינה שלהם. ה-system prompt והנחיות הפרויקט נטענים בעת ההפעלה ופעילים תמיד; קובצי AGENTS.md ו-CLAUDE.md מקוננים נטענים כאשר הסוכן פועל בתוך הספריות שלהם. מיומנות (skill), לעומת זאת, מופעלת לפי דרישה. סגנונות הפלט של Claude Code נמצאים בקצה הרחוק של רצף ה"פעיל תמיד", כיוון שבחירה באחד מהם עורכת את ה-system prompt עצמו, ולכן הוא מעצב כל תשובה בסשן, כולל כאלו שאף מיומנות לא נוגעת בהן.
המבחן הוא שאלה אחת: האם התעלמות מפסקה זו תהיה שגויה במשימה שאין לה שום קשר אליה? סגנון כתיבה מוסדי, פקודת ה-build וכלל מתן השמות לענפים (branch) חלים על כל משימה, ולכן מקומם בקובץ הפעיל-תמיד, שבו הטעינה בכל פעם היא המטרה. רשימת התיוג לשחרור גרסה (release checklist) שאתם מריצים פעמיים בחודש אינה חלה על כל משימה, ולכן מקומה במיומנות. כאשר חלק בקובץ הפעיל-תמיד שלכם צומח לכדי נוהל ממוספר, זהו הסימן להעביר אותו משם.
לקבצים אלו יש מוסכמות משלהם שכדאי להקפיד עליהן. ראו מה שייך ל-AGENTS.md ומה שייך לקובץ האנושי ו-קובץ design.md שמסביר את המבנה של בסיס הקוד עבור שני הקבצים שאנו משתמשים בהם.
איך נראית מיומנות מינימלית
ב-Claude Code, מיומנויות אישיות נמצאות ב-~/.claude/skills/<name>/SKILL.md וחלות על כל הפרויקטים שלכם באותה מכונה, אך לא על Cowork או על סשנים בענן. מיומנויות פרויקט נמצאות ב-.claude/skills/<name>/SKILL.md ומבוצעות commit ל-git, כך שגם הצוות שלכם מקבל אותן; שרשורי ענן בתוך פרויקט Claude לא טוענים אותן. GitHub Copilot ו-VS Code קוראים מיומנויות פרויקט מ-.github/skills/ ומ-.agents/skills/ וכן מ-.claude/skills/. הקובץ שבפנים הוא אותו קובץ.
mkdir -p ~/.claude/skills/restore-drill---
name: restore-drill
description: Run a restic restore drill and report what was recovered. Use when the user asks to test backups, verify a restore, or check that a snapshot is readable.
---
# Restore drill
1. Run `restic snapshots` and pick the newest snapshot for the host in question.
2. Restore it into a scratch directory under `/tmp`, never over live data.
3. Compare the restored file count and total size against the snapshot summary.
4. Report the snapshot ID and anything that failed to restore.
If `restic snapshots` reports that it cannot open the config file, stop and report the full error instead of guessing the cause.זוהי מיומנות מלאה. שם הספרייה הופך לפקודה שאתם מקלידים, לכן זו היא /restore-drill. ב-Claude Code, התפריט /skills מציג את מה שמותקן, וזו הדרך המהירה ביותר לוודא שהקובץ זוהה. אם הוא חסר בתפריט זה, בדקו תחילה את השמות: הקובץ חייב להיקרא SKILL.md, ומפרט ה-Agent Skills דורש שהשם יורכב מאותיות קטנות, ספרות ומקפים בודדים, בהתאמה לספרייה. אותו תהליך, כתוב כנוהל שהסוכן שלכם יכול להריץ מחדש, הוא בן לוויה טבעי ל-גיבויים מתוזמנים של restic ב-VPS, שכן הרצת הגיבוי אינה זהה לשחזור הגיבוי.
מתי מיומנות צריכה להיות סקריפט
כל שלב שיש לו תשובה אחת נכונה בכל פעם צריך להיות סקריפט, כאשר המיומנות מצטמצמת לכמה שורות שמציינות מתי להריץ אותו וכיצד לקרוא את הפלט. יש לכך שתי סיבות, ושתיהן מעשיות.
ראשית, קוד המקור של סקריפט לעולם אינו נכנס לחלון ההקשר (context window). מנתח (parser) של 300 שורות עולה לך רק בפלט שלו ולא מעבר לכך, בעוד שאותה לוגיקה הכתובה כהוראות בפורמט markdown עולה במלוא אורכה בכל פעם שהמיומנות נטענת.
שנית, סקריפט מספק את אותה תשובה פעמיים. מודל שמתבקש לגזור מחדש את אותו כלל ניתוח לוגים בכל הרצה יפיק תוצאה מעט שונה ביום רע, ואתה לא תבחין בכך עד ששני מספרים לא יתאימו זה לזה.
לכן, חלק את העבודה לפי סוגה. "נתח את ה-CSV והדפס כל שורה שבה הסכום הכולל אינו תואם לפריטים בשורה" הוא סקריפט. "הסתכל על השורות שהסקריפט הדפיס והסבר אילו מהן נראות כמו טעות בהזנת נתונים" הוא הוראת מיומנות. שמירה על שיקול דעת ב-markdown ועל דטרמיניזם בקוד היא אותה משמעת כמו בניית לולאה שסוכן יכול להריץ ללא השגחתך.
מדוע ה-skill שלי לעולם לא מופעל?
הסיבה היא שה-description שלך מתאר מה ה-skill עושה, אך לא מציין מתי להשתמש בו. שורה אחת זו היא כל מה שיש לסוכן כדי להתאים את הבקשה שלך. "מסייע בעבודה עם מסדי נתונים" אינו תואם לשום דבר ספציפי. לעומת זאת, "מריץ הגירת סכימה (schema migration) מול מסד הנתונים של ה-staging. יש להשתמש כאשר המשתמש מבקש להגר טבלה, להוסיף עמודה או לשנות סכימה" מכיל את המילים שאדם מקליד בפועל, ולכן הוא מופעל.
הכשל ההפוך הוא skill שמופעל ללא הרף. תיאור כמו "יש להשתמש בכל שינוי קוד במאגר זה" תואם להכול, ולכן הגוף שלו נטען בכל משימה ונשאר בשיחה לאורך תורות מאוחרים יותר. צמצם את התיאור למקרה הספציפי שאליו התכוונת. ב-Claude Code ניתן גם להגדיר disable-model-invocation: true ב-frontmatter, מה שעוצר טעינה אוטומטית ושומר על ה-skill זמין רק כאשר מקלידים את שמו.
הכשל השלישי הוא skill שמשכפל כלי קיים. הוראות המורות לסוכן לבצע curl ל-API ששרת ה-MCP שלו כבר חושף, או לבצע grep לקבצים כאשר למערכת יש כלי חיפוש, יוצרות נתיב איטי יותר בתוספת שתי מערכות הוראות שעלולות לסתור זו את זו. מחק את הכפילות ותאר את הכוונה במקום זאת.
אל תנחש איזה משלושת המקרים הוא שלך. הרץ את אותו ה-prompt פעמיים בסשן חדש, פעם אחת כשה-skill זמין ופעם אחת כשהוא כבוי, ולאחר מכן השווה את התשובות. הסשן החדש חשוב, כיוון שהסשן שבו כתבת את ה-skill כבר מכיל את כל מה שה-skill אומר, מה שמסתיר פערים בגרסה הכתובה. התוסף skill-creator של Anthropic מבצע אוטומציה להשוואה זו בתוך Claude Code, כולל יצירת prompts שאמורים ושאסור להם להפעיל את ה-skill, ומדידה של תדירות ההפעלה של כל אחד מהם. אם ה-skill אכן נטען והסוכן עדיין לא מבצע את מה שכתוב בו, התיאור אינו הבעיה שלך, ו-הסיבות לכך שסוכן מתעלם מהוראות שכבר קרא הן המקום הבא לבדוק בו.
האם זהו פורמט של ספק יחיד או תקן?
Anthropic פרסמה את הפורמט בסוף שנת 2025, ולאחר מכן שחררה אותו כתקן פתוח המתארח ב-agentskills.io. ב-22 באוקטובר 2026, הודיעה Anthropic על העברת Agent Skills לקרן Agentic AI Foundation תחת ה-Linux Foundation. נכון לאוקטובר 2026, המפרט מגדיר את השדות הנדרשים name ו-description, את השדות האופציונליים license, compatibility, metadata ו-allowed-tools, את שלוש הספריות האופציונליות, ואת התנהגות הטעינה בשלבים. הוא כולל גם כלי אימות (validator) רשמי, כך ש-skills-ref validate ./my-skill בודק תיקייה מול המפרט לפני שמשתפים אותה.
רשימת הלקוחות היא האינדיקציה המשמעותית ביותר. אותה תיקייה נקראת על ידי Claude Code, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot, VS Code, Goose, OpenHands ו-opencode, בין היתר. Microsoft מפרסמת מיומנויות משלה בפורמט זה ב-github.com/microsoft/skills, ומפיצה כלי שולחני בשם Skill Recorder שעוקב אחר ביצוע משימה פעם אחת, משחזר אותה ככוונה (intent) בצירוף שלבים מסודרים, וכותב את התוצאה כ-skill. ספק שבונה כלי הקלטה שהפורמט שלו שייך למפרט של גורם אחר הוא סימן מובהק לכך שהפורמט חדל להיות תכונה של מוצר בודד.
מה לכתוב תחילה
אל תתכננו ספרייה. המתינו עד שתתפסו את עצמכם מדביקים את אותן הוראות בצ'אט בפעם השלישית, ואז העבירו את הטקסט הזה לתוך SKILL.md ומחקו את ההדבקה. חזרתיות שכבר חשתם בה היא הטריגר האמין היחיד למיומנות ששווה לשמור. נוהל חיפוש הוא התחלה טובה, ו-מיומנות חיפוש המגובה במופע SearXNG משלכם מציגה את המבנה הרצוי.
שני הרגלים שומרים על בריאות הספרייה. קראו כל מיומנות שלא אתם כתבתם לפני שתתקינו אותה, כולל סקריפטים, כיוון שמיומנות היא אוסף הוראות שהסוכן שלכם יבצע וקוד שהוא עשוי להריץ: התייחסו לכך כאל התקנת תוכנה מאדם זר. שמרו על פרטי הזדהות מחוץ לתיקייה, שכן מיומנות היא קובץ טקסט שמתבצע לו commit ומשותף לאחרים. הרחקת סודות מהסוכנים שלכם מכסה היכן ערכים אלו צריכים להימצא במקום זאת, ו-מפת הדרכים ללימוד סוכנים השנה מסדרת את המיומנויות בהקשר לשאר ההגדרה.
FAQ
מה ההבדל בין מיומנות סוכן (agent skill) לבין שרת MCP?
שרת MCP (ראשי תיבות של Model Context Protocol) הוא תהליך רץ החושף כלים לסוכן באמצעות פרוטוקול; לכן הוא דורש הגדרה ופרטי הזדהות, והגדרות הכלים המלאות שלו תופסות נפח ב־context לאורך כל הסשן, אלא אם הלקוח דוחה את טעינתן (כפי ש-Claude Code עושה כברירת מחדל). מיומנות סוכן היא תיקייה המכילה קובץ SKILL.md, ללא תהליך רץ וללא פרוטוקול, ועלותה היא כ-100 טוקנים עד לרגע שבו הסוכן מחליט לקרוא אותה. השתמשו בשרת MCP כדי להעניק לסוכן גישה למערכת. השתמשו במיומנות כדי להנחות את הסוכן בנוגע לנוהל העבודה הנכון לשימוש בגישה זו. הגדרות רבות מריצות את שניהם במקביל.
האם מיומנויות סוכן עובדות רק עם Claude Code?
לא. חברת Anthropic פיתחה את הפורמט ושחררה אותו כתקן פתוח בכתובת agentskills.io, ואותה תיקייה נקראת על ידי Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot, VS Code, Goose, OpenHands ולקוחות נוספים. ההבדל טמון במיקום שבו כל לקוח מחפש את הקבצים ובשדות ה-frontmatter הנוספים שהוא יודע לפרש. Claude Code קורא את ~/.claude/skills/ ואת .claude/skills/, בעוד ש-GitHub Copilot ו-VS Code קוראים את .github/skills/, .claude/skills/ או .agents/skills/ בתוך המאגר. קובץ ה-SKILL.md עצמו עובר ביניהם ללא שינוי.
כמה מיומנויות ניתן להתקין לפני שתהיה פגיעה בביצועים?
המגבלה היא תקציב האתחול ולא מספר המיומנויות. כל מיומנות מותקנת תורמת את שמה ואת התיאור שלה, כ-100 טוקנים לפי ההנחיות המפורסמות של התקן, כך ששלושים מיומנויות עולות כ-3,000 טוקנים עוד לפני שנעשה בהן שימוש. מה שנפגע ראשון הוא יכולת ההתאמה (matching), לא המהירות: ריבוי מיומנויות עם תיאורים חופפים מקשה על המודל לבחור את המיומנות הנכונה. כתבו תיאורים שאינם חופפים ומחקו מיומנויות שאינכם משתמשים בהן עוד.
האם ההנחיה הזו צריכה להיכנס למיומנות או לקובץ AGENTS.md?
שאלו את עצמכם האם היא רלוונטית לכל משימה במאגר. פקודות בנייה, סגנון כתיבה וחוקי שמות רלוונטיים לכולן, ולכן מקומם בקובץ שתמיד פעיל, שבו טעינה בכל פעם היא המטרה. נוהל שאתם מריצים לעיתים רחוקות, כמו רשימת תיוג לשחרור גרסה (release checklist) או תרגול שחזור, צריך להיות מיומנות, כך שעלותו היא רק שורת התיאור שלו לפני ההפעלה. ברגע שהמיומנות נטענה ב-Claude Code, ההנחיות שלה נשארות בשיחה לאורך שלבים מאוחרים יותר, גם במשימות שאינן קשורות. חלק בתוך AGENTS.md שהפך לרשימת צעדים ממוספרים הוא בדרך כלל מיומנות שמחכה להעברה.