- סקיל (Skill) הוא תיקייה עם קובץ SKILL.md שמלמד את Claude Code נוהל קבוע. הוא נטען כשהוא רלוונטי, או שאתם מפעילים אותו בפקודה כמו /שם.
- נוהל שחוזר ונדרש לפעמים שייך לסקיל. עובדה שנכונה בכל משימה שייכת ל-CLAUDE.md.
- שומרים בתיקיית הבית לשימוש אישי, או בתיקיית הפרויקט כדי שהצוות יקבל אותו בקומיט.
מחפשים את ה-best Claude Code skills? לפני שמורידים סקילים של אחרים, כדאי להבין איך הם בנויים ולכתוב אחד בעצמכם. רוב הסקילים הטובים הם קבצים קצרים של כמה עשרות שורות. אם אתם רוצים את הרקע המושגי, יש מדריך Skills ב-Claude Code ו-ההבדל בין פלאגין, סקיל, MCP וסוכן. המדריך הזה מתמקד בכתיבה.
מה זה סקיל, ואיך הוא קשור לפקודות slash?
סקיל הוא קובץ SKILL.md שמכיל הוראות. Claude Code טוען אותו אוטומטית כשהתיאור שלו מתאים למה שביקשתם, או שאתם מפעילים אותו ישירות בהקלדת /שם-הסקיל. לפי התיעוד, פקודות מותאמות אוחדו לתוך סקילים: קובץ ישן ב-.claude/commands/ ממשיך לעבוד, אבל לעבודה חדשה מומלץ סקיל, כי הוא תומך בקבצי עזר. שם התיקייה הוא שם הפקודה, כך ש-.claude/skills/deploy/SKILL.md נקרא /deploy.
יש גם סקילים מובנים שמגיעים עם הכלי, למשל /doctor, /code-review, /batch, /debug, /loop ו-/claude-api. הפקודה /skills מציגה את כל הסקילים הזמינים.
איפה שומרים סקיל?
| מיקום | נתיב | מי רואה |
|---|---|---|
| אישי | ~/.claude/skills/<שם>/SKILL.md | כל הפרויקטים שלכם, במחשב הזה |
| פרויקט | .claude/skills/<שם>/SKILL.md | מי שעובד על הפרויקט, אם עשיתם קומיט |
| פלאגין | <plugin>/skills/<שם>/SKILL.md | בכל מקום שהפלאגין מופעל, בשם /plugin-name:skill-name |
| ארגוני | בתיקיית ההגדרות המנוהלות | כל משתמשי הארגון |
אם יש לכם הרבה פרויקטים, התחילו מסקיל אישי. ברגע שהוא מוכיח את עצמו, העבירו אותו לפרויקט. על פלאגינים נרחיב בשיעור הבא, וגם בקטלוג פלאגינים ל-Claude Code.
איך כותבים קובץ SKILL.md?
הקובץ בנוי משני חלקים: פרונטמטר ב-YAML בין שורות ---, ואחריו הוראות. כל השדות אופציונליים, ורק description מומלץ, כי לפיו Claude Code מחליט מתי לטעון. הפרונטמטר נקרא רק אם --- פותח את השורה הראשונה בקובץ.
| שדה | מה הוא עושה |
|---|---|
name | שם הפקודה. ברירת מחדל: שם התיקייה |
description | מה הסקיל עושה ומתי להשתמש בו. כדאי לשים את השימוש העיקרי בהתחלה |
argument-hint | רמז שמופיע בהשלמה אוטומטית, למשל [issue-number] |
disable-model-invocation | true אומר שרק אתם מפעילים אותו |
user-invocable | false אומר שרק Claude Code מפעיל, כידע רקע |
allowed-tools | כלים שמאושרים מראש בזמן הסקיל |
context | fork מריץ אותו בסוכן משנה נפרד |
paths | תבניות קבצים שמגבילות מתי הסקיל נטען |
שמות השדות חייבים להתאים בדיוק, כולל מקפים. שדה שלא מוכר פשוט מתעלמים ממנו, בלי הודעת שגיאה. את הרשימה המלאה אפשר למצוא בתיעוד של סקילים.
בגוף הסקיל אפשר להשתמש ב-$ARGUMENTS: מה שכתבתם אחרי שם הפקודה מוחלף בו. /fix-issue 123 יחליף את $ARGUMENTS ב-123. אפשר גם להריץ פקודת מעטפת לפני שהמודל קורא את ההוראות, בתחביר !`git diff HEAD` , והפלט נכנס לתוך הסקיל.
אם הסקיל לא נטען, הסיבה הנפוצה היא תיאור שחסרות בו המילים שאתם באמת אומרים. כתבו בתיאור ביטויים כמו “מה השתנה”, “הודעת קומיט” או “סקירת diff”.
מתי סקיל ומתי CLAUDE.md?
CLAUDE.md נטען בכל שיחה, וכל שורה בו עולה קצת תשומת לב בכל משימה. סקיל, שהמודל יכול להתחיל בעצמו, תורם רק שם ותיאור לכל שיחה, והתוכן המלא נקרא רק כשצריך. אותו כלל חל על שניהם: כותבים רק מה ש-Claude Code לא יכול להסיק מהקוד.
| CLAUDE.md | סקיל | |
|---|---|---|
| נטען | בכל שיחה | כשרלוונטי או כשמפעילים |
| מתאים ל | פקודות בדיקה, מוסכמות, מלכודות | נוהל שחרור, סקירה, יצירת דוח |
| דוגמה | “הבדיקות רצות עם npm test” | “שלבי הכנת גרסה חדשה” |
אם קטע ב-CLAUDE.md גדל והפך לנוהל מרובה שלבים, זה סימן שהוא רוצה להפוך לסקיל.
דוגמה מלאה: סקיל לתיאור שינויים
הסקיל הבא מושך את ההפרש הנוכחי ומכין תיאור קצר לקומיט. הוא עם disable-model-invocation, כי אתם רוצים להחליט מתי להפעיל אותו.
--- name: commit-notes description: מכין תיאור קצר לשינויים שלא נשמרו ומסמן סיכונים. להשתמש כשמבקשים הודעת קומיט או סיכום שינויים. argument-hint: [נושא] disable-model-invocation: true --- ## השינויים !`git diff HEAD` ## הוראות כתוב הודעת קומיט בשורה אחת של עד 70 תווים, ומתחתיה שלוש נקודות לכל היותר. נושא שהמשתמש ציין: $ARGUMENTS אחר כך רשום סיכונים: טיפול בשגיאות חסר, ערכים קבועים בקוד, בדיקות שצריך לעדכן. אם ההפרש ריק, כתוב שאין שינויים.
- 1
צרו תיקייה
mkdir -p ~/.claude/skills/commit-notes, ושמרו שם את הקובץ.
- 2
ערכו קובץ בפרויקט עם git
שינוי קטן מספיק.
- 3
הפעילו
הקלידו /commit-notes ואחריו נושא, למשל /commit-notes תיקון טופס.
- 4
שפרו
לא מרוצים מהניסוח? ערכו את הקובץ. Claude Code מזהה שינוי בקבצי סקילים תוך כדי הסשן. תיקייה חדשה שלא הייתה בתחילת הסשן דורשת /reload-skills.
איך משתפים סקילים בצוות?
- בפרויקט: עושים קומיט ל-
.claude/skills/, וכל מי שמושך את הריפו מקבל את הסקיל. - כפלאגין: שמים תיקיית
skills/בתוך פלאגין, ואז הוא מופץ ומופעל יחד איתו. - בארגון: מפיצים דרך ההגדרות המנוהלות.
הרגל טוב: מי שכותב סקיל לצוות כותב בו רק מה שבאמת ייחודי לצוות. נוהל שחרור וקונבנציות פנימיות כן. הסבר כללי על איך עובד git לא.
טעויות נפוצות
- תיאור כללי מדי (“עוזר בקוד”), ואז הסקיל לא נטען או נטען לכל דבר.
- סקיל ארוך מדי. התיעוד ממליץ להישאר מתחת ל-500 שורות ולהעביר חומר עזר לקבצים נפרדים.
- פעולות כמו deploy בלי
disable-model-invocation: true. - הוראה שחייבת לקרות תמיד, שנשענת על סקיל. כלל כזה מתאים ל-hook, ועל hooks נדבר בשיעור 7.
- הנחה ששם שדה כתוב נכון. שדה עם שגיאת כתיב פשוט נבלע.
השיעור הבא: פלאגינים ל-Claude Code: להתקין, לבחור ולא להסתבך →