מדריך Claude Skills: איך בונים Skill ראשון, גם ל-Vibe Coders וגם למפתחים

אם אתם עובדים עם Claude באופן קבוע, כנראה מצאתם את עצמכם מדביקים שוב ושוב את אותן הוראות. "תכתוב בסגנון של הבלוג שלי." "תבדוק שה-Title לא עובר 60 תווים." "לפני שאתה נוגע בקוד, תריץ את הבדיקות."

Skills פותרים בדיוק את זה. מלמדים את Claude פעם אחת, והוא מפעיל את הידע הזה לבד בכל פעם שהוא רלוונטי.

הפוסט הזה מיועד לשני קהלים. Vibe Coders, כלומר אנשי שיווק, SEO, תוכן ומוצר שעובדים עם Claude בצ'אט. אם המונח חדש לכם, כדאי להתחיל במה זה Vibe Coding. ומפתחים שעובדים עם Claude Code בטרמינל או ב-IDE. העקרונות משותפים, אבל הכלים והאפשרויות שונים, ולכן לכל קהל יש כאן מסלול משלו.

מה זה בעצם Skill?

Skill הוא תיקייה עם קובץ אחד חובה, SKILL.md. לקובץ יש שני חלקים:

1. Frontmatter: כמה שורות בראש הקובץ, בין שני קווים ---, עם שם ותיאור. על סמך התיאור Claude מחליט אם ה-Skill רלוונטי לבקשה הנוכחית.
2. ההוראות עצמן: טקסט רגיל ב-Markdown, מה Claude צריך לעשות כשה-Skill מופעל.

אפשר לשים בתיקייה גם קבצים נוספים: מסמכי עזר, תבניות וסקריפטים. Claude יקרא אותם רק כשהוא צריך.

למה זה עדיף על הדבקת הוראות, או על CLAUDE.md?

ההבדל הוא באופן הטעינה. Claude לא קורא את כל ה-Skills שלכם בכל שיחה. הוא טוען בשלבים:

1. תמיד: רק השם והתיאור של כל Skill, כדי לדעת מה זמין.
2. כשהבקשה מתאימה: את ההוראות המלאות מתוך SKILL.md.
3. רק כשצריך: קבצי עזר וסקריפטים מתוך התיקייה.

לכן אפשר להחזיק עשרות Skills בלי שהם יעמיסו על שיחות שלא קשורות אליהם.

CLAUDE.md, קובץ ההוראות הקבוע של Claude Code, נטען במלואו בכל סשן. הוא מתאים לעובדות קצרות על הפרויקט, כמו "אנחנו עובדים עם PHP 8.3" או "הבדיקות רצות עם PHPUnit". Skill מתאים לנהלים: רשימות בדיקה, תהליכים בכמה שלבים, וחומר עזר ארוך.

כלל אצבע: אם מצאתם את עצמכם מדביקים את אותה הוראה בפעם השלישית, זה Skill.

מה מתאים למי?

חשוב לדעת: Skills שמופעלים בחשבון Claude.ai שלכם זמינים גם ב-Claude Code, כשמתחברים עם אותו חשבון. אז Skill שבניתם בצ'אט לא נשאר תקוע שם.

מסלול Vibe Coders: Skill בלי לפתוח טרמינל

הדרך הקלה ביותר היא לתת ל-Claude לבנות את ה-Skill בשבילכם. תארו בשיחה מה אתם רוצים, למשל: "אני רוצה Skill שכותב Title ו-Meta Description לפוסטים שלי בעברית, לפי הכללים הבאים…", ובקשו ממנו לארוז את התוצאה כ-Skill. Anthropic מספקת Skill ייעודי בשם skill-creator שמנהל את התהליך הזה דרך שאלות ותשובות.

אחרי שיש לכם תיקייה עם SKILL.md, דוחסים אותה ל-ZIP ומעלים דרך הגדרות ה-Skills בחשבון Claude.ai. מיקום התפריט משתנה מדי פעם, אז אם לא מצאתם אותו, חפשו "Skills" בהגדרות.

הנה דוגמה ל-Skill כזה. שימו לב שהוא משתמש רק ב-name ו-description, ולכן יעבוד גם ב-Claude.ai וגם ב-Claude Code:

hebrew-seo-meta/
└── SKILL.md

---
name: hebrew-seo-meta
description: כותב ובודק Title ו-Meta Description לפוסטים בעברית. השתמש כשמבקשים כותרת לפוסט, מטא דיסקריפשן, או בדיקת SEO לטיוטה.
---

# הנחיות

- Title: עד 60 תווים, מילת המפתח הראשית קרוב להתחלה.
- Meta Description: בין 140 ל-155 תווים, עם פרט קונקרטי אחד מתוך הפוסט (מספר, דוגמה או מסקנה).
- בלי קליקבייט, בלי סימני קריאה, ובלי לחזור על ה-Title מילה במילה.
- הצע שלוש חלופות לכל אחד.

## פורמט תשובה

טבלה עם העמודות: חלופה | אורך בתווים | למה היא עובדת

רעיונות נוספים ל-Skills שמתאימים ל-Vibe Coders:

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

אם אתם כבר בונים כלים קטנים לעבודה, כמו שתיארתי בVibe Coding בארגון, Skills הם הדרך לשמור את ה"איך" של הכלים האלה במקום אחד. כך לא צריך להסביר את זה מחדש בכל שיחה.

מסלול מפתחים: Skills ב-Claude Code

ב-Claude Code, ה-Skill הוא תיקייה באחד משני מקומות עיקריים:

• ~/.claude/skills/<שם>/SKILL.md: Skill אישי, זמין בכל הפרויקטים במחשב שלכם.
• .claude/skills/<שם>/SKILL.md: Skill של הפרויקט. עושים לו commit והוא מגיע לכל הצוות.

שם התיקייה הופך לפקודה. תיקייה בשם release-notes יוצרת את /release-notes. אפשר להפעיל את ה-Skill ידנית, או לתת ל-Claude להפעיל אותו לבד כשהבקשה מתאימה לתיאור.

ב-Claude Code יש שדות Frontmatter שלא קיימים ב-Claude.ai, והם הופכים את ה-Skills לכלי עבודה של ממש:

• disable-model-invocation: true: רק אתם יכולים להפעיל את ה-Skill. מתאים לכל דבר עם תופעות לוואי, כמו דיפלוי, commit או שליחת הודעה. אתם לא רוצים ש-Claude יחליט לבד שהגיע הזמן לדיפלוי.
• user-invocable: false: ההפך. רק Claude מפעיל את ה-Skill, והוא לא מופיע בתפריט. מתאים לידע רקע, למשל "איך עובדת מערכת הלגאסי".
• allowed-tools: כלים ש-Claude יכול להפעיל בלי לבקש אישור, בתור שבו ה-Skill הופעל.
• paths: טוען את ה-Skill אוטומטית רק כשעובדים על קבצים שתואמים לתבנית, למשל **/*.php.
• context: fork: מריץ את ה-Skill בסוכן-משנה נפרד, בלי היסטוריית השיחה.

שתי יכולות נוספות שימושיות במיוחד:

• $ARGUMENTS: מקבל פרמטרים מהפקודה. /fix-issue 123 מעביר את 123 להוראות.
• הזרקת פלט של פקודה: שורה שמתחילה ב-!`command` מריצה את הפקודה לפני ש-Claude קורא את ה-Skill, ומכניסה את הפלט במקומה.

הנה דוגמה למפתחי תוספים ותבניות וורדפרס:

---
name: release-notes
description: Drafts release notes for a plugin or theme release from recent commits.
disable-model-invocation: true
allowed-tools: Bash(git log *)
---

## Recent commits

!`git log --oneline -30`

## Instructions

Draft release notes for version $ARGUMENTS based on the commits above.

- Group changes under: New, Improved, Fixed.
- Skip merge commits and internal refactors that users won't notice.
- Write each item as one short sentence from the user's point of view.
- Output two versions: a readme.txt changelog block and a short blog-style summary.

מריצים /release-notes 2.4.0. Claude מקבל את 30 ה-commits האחרונים כבר בתוך ההוראות, ומחזיר טיוטה. allowed-tools מאפשר את הרצת git log בלי לעצור לבקשת אישור.

איך כותבים description שבאמת עובד

התיאור הוא החלק החשוב ביותר ב-Skill. זה הדבר היחיד ש-Claude רואה לפני שהוא מחליט אם לטעון אותו. תיאור טוב עונה על שתי שאלות: מה ה-Skill עושה, ומתי להשתמש בו. כדאי לכלול בו את הביטויים שאתם באמת אומרים.

• חלש: "עוזר עם SEO."
• חזק: "כותב ובודק Title ו-Meta Description לפוסטים בעברית. השתמש כשמבקשים כותרת לפוסט, מטא דיסקריפשן, או בדיקת SEO לטיוטה."

שימו את מקרה השימוש המרכזי בהתחלה. כשיש הרבה Skills, התיאורים עלולים להתקצר בתצוגה ש-Claude מקבל.

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

• Skill אחד שעושה הכול. Skill ל"סקירת קוד, בדיקות ותיעוד" יפעל בצורה לא עקבית. עדיף שלושה Skills ממוקדים.
• SKILL.md ארוך מדי. ההמלצה היא עד 500 שורות. חומר עזר מפורט עדיף להעביר לקבצים נפרדים בתיקייה, ולציין ב-SKILL.md מתי לקרוא כל אחד מהם.
• שדות של Claude Code בקובץ שמועלה ל-Claude.ai. שדה כמו disable-model-invocation יגרום לשגיאה בהעלאה. אם ה-Skill צריך לעבוד בשני המקומות, השתמשו רק ב-name וב-description.
• בלבול בין ידע לבין משימה. Skill של ידע, כמו "כללי ה-API שלנו", נטען לצד השיחה. Skill של משימה, כמו "תעשה דיפלוי", צריך הוראות צעד-אחר-צעד, ובדרך כלל גם disable-model-invocation.
• בדיקה רק בשיחה שבה בניתם את ה-Skill. השיחה הזו כבר מכילה את כל ההקשר, ולכן היא מסתירה חורים בהוראות. בדקו תמיד בשיחה חדשה, עם כמה ניסוחים שונים של בקשה.
• לא לבדוק Skills בריפו שלא אתם כתבתם. allowed-tools מעניק הרשאות להרצת פקודות. לפני שעובדים עם Claude Code בריפו חדש, כדאי להציץ בתיקייה .claude/skills/.

אז מאיפה מתחילים?

בחרו הוראה אחת שאתם מדביקים ל-Claude שוב ושוב והפכו אותה ל-Skill. אם אתם Vibe Coders, התחילו בצ'אט ובקשו מ-Claude לבנות אותו איתכם. אם אתם מפתחים, צרו תיקייה ב-.claude/skills/ והתחילו מנוהל שהצוות כבר מכיר, כמו release notes או רשימת בדיקה לפני merge.

אחרי שבוע, שאלו את עצמכם את אותה שאלה שאני שואל על כל כלי שנבנה ב-Vibe Coding: האם השתמשתם בו שוב? אם כן, בניתם משהו אמיתי.

שאלות נפוצות על Claude Skills

---

מקורות

• https://code.claude.com/docs/en/skills
• https://agentskills.io