דילוג לתוכן הראשי
aivrit

סקילים בקלוד קוד: ללמד את הסוכן לעבוד כמוכם

מאת ירון דויטשר עודכן לאחרונה:

מה זה סקיל, בעצם?

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

בפועל, סקיל הוא תיקייה עם קובץ אחד חובה — SKILL.md. הוא בנוי על תקן פתוח (Agent Skills), כך שאותו סקיל עובד גם בכלים אחרים ולא ננעל לקלוד.

סקיל מול CLAUDE.md — מה באמת ההבדל?

זו השאלה הראשונה של כל מי שכבר מכירים CLAUDE.md, והתשובה מסתכמת במילה אחת: טעינה.

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

אם CLAUDE.md הוא הידע על הפרויקט, סקיל הוא ידע על מקצוע. וזה גם הסימן המעשי מתי להעביר תוכן מאחד לשני: כשסעיף ב-CLAUDE.md הפך מעובדה (“הבדיקות רצות עם ‎npm test”) לנוהל בן שנים-עשר שלבים — זה הרגע להוציא אותו לסקיל.

איך בנוי סקיל?

הלב הוא SKILL.md: כמה שורות YAML בראש, ואחריהן ההוראות ב-markdown. הנה סקיל קומפקטי לכתיבת פוסט בעברית לפי כללי הבית:

---
name: hebrew-post
description: כותב פוסט בעברית לפי כללי הבית. להשתמש כשמבקשים לנסח פוסט, מאמר או ניוזלטר בעברית.
---

## כללי כתיבה
- כתיב מלא, בלי ניקוד, פנייה בלשון רבים
- פסקאות קצרות, כותרות בצורת שאלה
- מותגים מוכרים באנגלית; מחירים בשקלים

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

שני חלקים, שני תפקידים:

  • התיאור (description) הוא הכי חשוב: זו השורה היחידה שקלוד רואה תמיד, ולפיה הוא מחליט מתי לטעון את הסקיל. תיאור מעורפל = סקיל שלא ייטען בזמן. כותבים בו גם מה הסקיל עושה וגם מתי להשתמש בו
  • הגוף נטען רק בהפעלה: ההוראות שמתחת ל-YAML נכנסות להקשר רק כשהסקיל רץ. אפשר גם לצרף לתיקייה קבצים נוספים — תבניות, דוגמאות פלט, סקריפטים להרצה — ולהפנות אליהם מתוך SKILL.md

שם התיקייה (‎hebrew-post) הוא גם הפקודה: מקלידים ‎/hebrew-post כדי להפעיל ידנית.

מתי סקיל עדיף על חזרה על הוראות?

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

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

ולהפעלה יש שני מצבים, וזה חלק מהיופי:

  • אוטומטית: קלוד מזהה מהתיאור שהמשימה מתאימה וטוען את הסקיל לבד
  • ידנית: מקלידים ‎/שם-הסקיל כשרוצים שליטה מלאה. אגב, פקודות מותאמות ישנות (בתיקיית ‎.claude/commands) התמזגו לתוך המנגנון הזה — סקיל הוא הדרך המומלצת היום

איך משתפים סקיל עם הצוות?

כאן סקילים באמת זורחים. המיקום קובע מי נהנה מהם:

  • סקיל אישי יושב ב-‎~/.claude/skills/ וחל על כל הפרויקטים שלכם, בכל מקום
  • סקיל של הפרויקט יושב ב-‎.claude/skills/ בתוך הפרויקט. מכניסים את התיקייה ל-git, וכל מי שמושכים את הפרויקט מקבלים את אותם סקילים — בלי התקנה, בלי הסבר

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

שורה תחתונה

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

עוד לא כתבתם CLAUDE.md לפרויקט? זה הצעד שלפני — המדריך המלא ל-CLAUDE.md הוא נקודת הפתיחה, וממנו ממשיכים לסקילים.

שאלות נפוצות

מה ההבדל בין סקיל ל-CLAUDE.md?

CLAUDE.md הוא ידע קבוע על הפרויקט שנטען לכל שיחה במלואו — פקודות, מוסכמות, כללים. סקיל הוא נוהל או מומחיות שנטענים על פי דרישה: קלוד רואה רק את התיאור, וקורא את התוכן המלא רק כשהמשימה מתאימה. כלל אצבע: עובדה קבועה → CLAUDE.md; נוהל רב-שלבי → סקיל.

איך יוצרים סקיל בקלוד קוד?

מכינים תיקייה בשם הסקיל (למשל ‎~/.claude/skills/deploy) ובתוכה קובץ SKILL.md: כמה שורות YAML עם שדה description שמסביר מתי להשתמש, ואחריהן ההוראות עצמן ב-markdown. שם התיקייה הופך לפקודה שמקלידים אחרי ‎/.

האם סקיל תופס מקום בהקשר גם כשלא משתמשים בו?

כמעט לא. מההקשר נטענת רק שורת התיאור של כל סקיל זמין (עד כ-1,500 תווים). התוכן המלא — ההוראות, הדוגמאות, קובצי העזר — נכנס רק כשהסקיל מופעל. זה בדיוק היתרון על פני CLAUDE.md, שנטען תמיד במלואו.

איך משתפים סקיל עם כל הצוות?

שמים את הסקיל בתיקיית ‎.claude/skills/ של הפרויקט ומכניסים אותה ל-git. כל מי שמושכים את הפרויקט מקבלים אותו אוטומטית — כאילו כולם עברו את אותה הכשרה. סקילים אישיים, לעומת זאת, יושבים ב-‎~/.claude/skills/ וחלים על כל הפרויקטים שלכם בלבד.

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