מה זה סקיל באמת?
סקיל הוא הדרך הפשוטה ביותר ללמד עוזר AI איך לטפל במשימה מסוימת: קובץ הוראות אחד (Markdown) עם YAML frontmatter בראש, אופציונלית מלווה בקבצי reference ובסקריפטים. הסוכן קורא את הקובץ לפי דרישה, כשהתיאור שלו תואם לבקשת המשתמש. זה כל המודל. כל השאר (קטלוג, sync pipeline, ציון אמון, מספרי התקנות) הוא תשתית סביב אותו קובץ בודד.
ההשוואה בארבע: סקיל מול MCP מול system prompt מול CLI
הכי קל להבין מה סקיל הוא, דרך הבנה של מה הוא לא.
| כלי | מה זה | מתי הייתם כותבים אחד |
|---|---|---|
| סקיל | קובץ Markdown שה־LLM קורא לפי דרישה כדי ללמוד איך לטפל בסוג משימה ספציפי | אתם רוצים שה־LLM יידע איך לעשות משהו בלי שתחזרו על ההוראות בכל שיחה |
| MCP server | שירות רשת שה־LLM קורא לו כדי לקבל מידע חי או לבצע פעולות עם state | אתם צריכים שה־LLM יקרא או יכתוב state חיצוני (DB, API, מערכת קבצים) |
| System prompt | הוראות קבועות שמוזרקות בתחילת השיחה | אתם רוצים התנהגות שחלה על כל האינטראקציות של עוזר, לא רק על משימה ספציפית |
| CLI tool | תוכנה שאדם מריץ ישירות | המשתמש יודע בדיוק איזו פקודה הוא רוצה להריץ, אין צורך בניתוב שפה טבעית |
בלבול נפוץ: אנשים כותבים סקיל כשהם באמת צריכים MCP. אם ה"סקיל" שלכם מסתכם ב"שה־LLM יקרא ל־API הזה ויחזיר את ה־JSON", זה MCP server, לא סקיל. סקילים זה ל־איך עושים משהו (חוקי החלטה, מבנה, שיקול דעת). MCP זה לגישה ל־state חי.
בלבול נפוץ שני: אנשים כותבים סקיל כשהם באמת צריכים system prompt. אם אתם רוצים ש־Claude ידבר תמיד בטון של המותג שלכם בכל שיחה, זה system prompt או GPT מותאם, לא סקיל. סקילים נטענים לפי דרישה כשכוונת המשתמש תואמת לתיאור של הסקיל.
מפרט הסקיל, בפסקה אחת
כל סקיל הוא תיקייה שמכילה לפחות קובץ SKILL.md עם YAML frontmatter. ה־frontmatter דורש לפי המפרט של Anthropic שני שדות, name (slug ב־kebab-case) ו־description (משפט או שניים שה־LLM קורא כדי להחליט אם לטעון את הסקיל), בנוסף ל־license שנהוג בקטלוג skills-il (בדרך כלל MIT, אבל טכנית אופציונלי במפרט המקורי). הגוף הוא Markdown רגיל, שנטען לקונטקסט של ה־LLM ברגע שהסקיל מופעל. אופציונלית התיקייה יכולה להכיל תת־תיקייה references/ (קבצים סטטיים שה־LLM קורא בעת הצורך) ותת־תיקייה scripts/ (קוד הרצה שכלי ה־shell של הסוכן יכול להריץ). זה כל המפרט. כל מה שיש בקטלוג skills-il הוא הרחבה של זה.
ההרחבה של skills-il: metadata.json ותוכן דו־לשוני
המפרט של Anthropic מינימלי. קטלוג skills-il צריך יותר: שמות תצוגה דו־לשוניים, תגיות קהל ורמה, רשימות סוכנים נתמכים, פקודות התקנה. כדי לא להתנגש עם המפרט של Anthropic, skills-il שם את כל זה בקובץ נפרד שנקרא metadata.json ליד SKILL.md. תוכן הליווי בעברית יושב בקובץ מקביל שנקרא SKILL_HE.md. פרק 3 מכסה את שניהם בפירוט.
מתי לא לכתוב סקיל (עץ ההחלטה)
לפני שכותבים שורה אחת של SKILL.md, עברו על הבדיקה הזאת:
- האם ה־LLM כבר עושה את זה טוב בלי סקיל? אם אתם שואלים את Claude "תפרמט את מספר הטלפון הישראלי הזה" והוא עושה את זה נכון מהפעם הראשונה, אתם לא צריכים סקיל לפרמוט טלפונים. סקילים מיועדים למקרים שבהם ההתנהגות הדיפולטית שגויה, חלקית, או חירשת תרבותית.
- האם המשימה דורשת מידע חי? אם התשובה משתנה כל שעה (מחירי מניות, תשובות מ־API ממשלתי, תנועה), הסקיל הוא ההפשטה הלא נכונה. כתבו MCP server.
- האם המשימה חישובית טהורה עם תשובה אחת נכונה? checksum פשוט או ממיר פורמט אולי מתאים יותר כשורת scripts/ אחת שנקראת מתוך סקיל גדול יותר, ולא בתור סקיל בפני עצמו.
- אתם בטוחים שיש קהל לזה? סקילים עם פחות מ־5 התקנות אחרי 6 חודשים בדרך כלל מתים בקטלוג. דברו עם 3 משתמשים פוטנציאליים לפני שכותבים.
הטעות הכי נפוצה בפרק 1: כתיבת סקיל במקום שבו MCP מתאים יותר. סימפטום: הגוף של הסקיל ברובו "תקראו ל־URL הזה, פרסרו את ה־JSON הזה, החזירו את השדה הזה". פתרון: המירו ל־MCP server עם כלי אחד, רשמו אותו בקטלוג, וה"סקיל" שלכם הופך לקריאה בשורה אחת ל־MCP.
אם הנושא שלכם שורד את עץ ההחלטה, התקינו את הסקיל skills-il-skill-creator (npx skills-il add developer-tools/skills-il-skill-creator) כדי לעשות scaffold למבנה התיקייה, ואז המשיכו לפרק 2 ללמוד מה לשים בתוך SKILL.md.