חיצים לניווט · Enter לפתיחה · Esc לסגירה

קורס Claude Code בעברית, בחינם · שיעור 4 מתוך 8 · 20 דק׳

🧩 Claude Code Skills ופקודות מותאמות: איך כותבים סקיל

Claude Code Skills (סקילים) בעברית: מה זה קובץ SKILL.md, איפה שומרים אותו, אילו שדות כותבים, מתי סקיל ומתי CLAUDE.md, דוגמה מלאה ושיתוף בצוות.

🎯 בסוף השיעור תדעו לכתוב סקיל קטן ב-⁠SKILL.md, לשמור אותו במקום הנכון, להפעיל אותו בפקודת slash ולהחליט מתי הוא עדיף על CLAUDE.md.

→ השיעור הקודם: עבודה יומיומית
בקצרה
  • סקיל (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-invocationtrue אומר שרק אתם מפעילים אותו
user-invocablefalse אומר שרק Claude Code מפעיל, כידע רקע
allowed-toolsכלים שמאושרים מראש בזמן הסקיל
contextfork מריץ אותו בסוכן משנה נפרד
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, כי אתם רוצים להחליט מתי להפעיל אותו.

~/.claude/skills/commit-notes/SKILL.md
---
name: commit-notes
description: מכין תיאור קצר לשינויים שלא נשמרו ומסמן סיכונים. להשתמש כשמבקשים הודעת קומיט או סיכום שינויים.
argument-hint: [נושא]
disable-model-invocation: true
---

## השינויים

!`git diff HEAD`

## הוראות

כתוב הודעת קומיט בשורה אחת של עד 70 תווים, ומתחתיה שלוש נקודות לכל היותר.
נושא שהמשתמש ציין: $ARGUMENTS
אחר כך רשום סיכונים: טיפול בשגיאות חסר, ערכים קבועים בקוד, בדיקות שצריך לעדכן.
אם ההפרש ריק, כתוב שאין שינויים.
  1. 1

    צרו תיקייה

    mkdir -p ~/.claude/skills/commit-notes, ושמרו שם את הקובץ.

  2. 2

    ערכו קובץ בפרויקט עם git

    שינוי קטן מספיק.

  3. 3

    הפעילו

    הקלידו /commit-notes ואחריו נושא, למשל /commit-notes תיקון טופס.

  4. 4

    שפרו

    לא מרוצים מהניסוח? ערכו את הקובץ. Claude Code מזהה שינוי בקבצי סקילים תוך כדי הסשן. תיקייה חדשה שלא הייתה בתחילת הסשן דורשת /reload-skills.

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

  • בפרויקט: עושים קומיט ל-⁠.claude/skills/, וכל מי שמושך את הריפו מקבל את הסקיל.
  • כפלאגין: שמים תיקיית skills/ בתוך פלאגין, ואז הוא מופץ ומופעל יחד איתו.
  • בארגון: מפיצים דרך ההגדרות המנוהלות.

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

טעויות נפוצות

  • תיאור כללי מדי (“עוזר בקוד”), ואז הסקיל לא נטען או נטען לכל דבר.
  • סקיל ארוך מדי. התיעוד ממליץ להישאר מתחת ל-500 שורות ולהעביר חומר עזר לקבצים נפרדים.
  • פעולות כמו deploy בלי disable-model-invocation: true.
  • הוראה שחייבת לקרות תמיד, שנשענת על סקיל. כלל כזה מתאים ל-⁠hook, ועל hooks נדבר בשיעור 7.
  • הנחה ששם שדה כתוב נכון. שדה עם שגיאת כתיב פשוט נבלע.
סיימתי את השיעור אם...0%

השיעור הבא: פלאגינים ל-⁠Claude Code: להתקין, לבחור ולא להסתבך →

20 דק׳ קריאה

חשבון גיקזילה