Skills של Claude Code בשנת 2026: איך לבנות לעצמכם ספריית skills
Markdownאיך ליצור Skills ל-Claude Code: מבנה SKILL.md, הנוסחה לתיאור, אוספים מוכנים מאת Anthropic, ותבניות אנטי. שלב אחר שלב בתוך 30 דקות.
קריאת המאמר המלא
נקודות מרכזיות
Skills של Claude Code הן תיקיות שמכילות קובץ SKILL.md ש-Claude טוען להקשר רק כשצריך. CLAUDE.md נשאר בזיכרון כל הזמן וצורך מתקציב הטוקנים, בעוד skill נטען בעקבות טריגר — ועשרות skills יכולות להתקיים בקלות בפרויקט אחד. החלק החשוב ביותר ב-skill הוא התיאור שלה: Claude משתמש בו כדי להחליט אם להפעיל את ה-skill. במאמר הזה אסביר את המבנה של SKILL.md, את הנוסחה לתיאור, אוספים מוכנים ואיך לבנות את ה-skill הראשון שלכם בתוך 30 דקות.
תיעוד Ailoot: API, מפתחות והגדרה.
מהו Skill ב-Claude Code, ולמה הוא לא סתם ״פרומפט גדול יותר״?
נקודות מרכזיות
Skill הוא תיקייה שמכילה קובץ SKILL.md המתאר מתי ואיך ליישם מתודולוגיה מסוימת. Anthropic משווה skill להוראות לעובד חדש: לא מכתיבים לו כל צעד מדי יום, אלא נותנים לו נוהל והוא מיישם אותו בעצמו במצבים המתאימים. ההבדל העיקרי מ-CLAUDE.md הוא ש-skill נטען להקשר רק כשצריך, ולכן עשרות skills יכולות להימצא בפרויקט בלי לחרוג מתקציב הטוקנים.
Claude Code Skills היא יכולת מובנית של Claude Code ש-Anthropic השיקה באוקטובר 2025 למנויי Pro/Max/Team/Enterprise. בהמשך הם פתחו את מפרט Agent Skills כתקן שפועל גם מעבר ל-Claude. בקוד, זו פשוט תיקייה:
.claude/skills/
├── deploy-to-prod/
│ ├── SKILL.md
│ └── scripts/
│ └── check-migrations.sh
├── weekly-content-plan/
│ └── SKILL.md
└── triage-support-tickets/
└── SKILL.md
כל תיקייה היא skill אחד. קובץ SKILL.md הוא Markdown עם YAML frontmatter בחלק העליון והוראות רגילות מתחתיו. כשמשתמש מבקש, ״בוא נפרוס לסביבת הייצור״, Claude רואה את תיאור ה-skill בשם deploy-to-prod, מזהה את הטריגר ״פריסה לסביבת הייצור״, טוען את גוף SKILL.md להקשר ופועל לפי השלבים.
שלוש רמות של טעינה הדרגתית
Anthropic בנו את ה-skills עם טעינה הדרגתית: הנתונים נטענים בשכבות לפי הצורך. בבלוג ההנדסה של Anthropic, הצוות מתאר זאת כ״עקרון התכנון המרכזי שהופך את Agent Skills לגמישים וניתנים להרחבה״ (Anthropic Engineering).
שלוש רמות הטעינה:
- מטא-נתונים (תמיד) - כשהפעלת שיחה מתחילה, Claude רואה רק את
nameואתdescriptionשל כל skill. תקציב: בערך 100 טוקנים לכל skill. - הוראות (עם הפעלת טריגר) - כשהמשתמש אומר משהו רלוונטי, Claude טוען את גוף SKILL.md. תקציב: פחות מ-5000 טוקנים.
- משאבים (לפי דרישה) - קבצים מצורפים (דוגמאות, תבניות, מערכי נתונים) נשלפים רק כשהמודל עצמו מחפש אותם. תקציב: ללא הגבלה.
בעבר, CLAUDE.md היה צריך להכיל את כל מה שה-AI אמור ״לזכור״ — ופרויקט עם 50 כללים הגיע במהירות למגבלת ההקשר. עם skills, עשרות יכולות יכולות להתקיים בקלות בפרויקט אחד, כי רק התיאורים שלהן נכנסים להקשר הראשוני.
איפה נמצאים Skills: ארבע רמות
| רמה | נתיב | חל על |
|---|---|---|
| Enterprise | הגדרות ארגוניות מנוהלות | כל משתמשי החברה |
| אישי | ~/.claude/skills/<name>/SKILL.md | כל הפרויקטים שלכם |
| פרויקט | .claude/skills/<name>/SKILL.md | הפרויקט הזה בלבד |
| תוסף | <plugin>/skills/<name>/SKILL.md | במקומות שבהם התוסף מופעל |
סדר העדיפויות: Enterprise גובר על אישי, ואישי גובר על פרויקט. תוספים משתמשים במרחב השמות plugin-name:skill-name ואינם מתנגשים. זה נוח: שמרו skills מקצועיים כלליים ב-~/.claude/skills/ ו-skills ספציפיים לפרויקט במאגר שלו, תחת .claude/skills/.
מה יש בתוך SKILL.md?
נקודות מרכזיות
SKILL.md הוא קובץ Markdown עם YAML frontmatter בחלק העליון וטקסט הוראות מתחתיו. לכל הפחות יש בו שני שדות: name (עד 64 תווים) ו-description (עד 1024 תווים). הסכמה המלאה כוללת את allowed-tools, disable-model-invocation, paths, context: fork, agent ו-hooks. Anthropic ממליצים להשאיר את גוף ההוראות בגבולות 500 שורות ולהעביר את כל השאר לקובצי עזר סמוכים.
הנה דוגמה מינימלית — עשרים שורות, וה-skill מוכן:
---
name: weekly-content-plan
description: Prepares a weekly post plan for a Telegram channel and short-form video posts. Triggers - "make a post plan", "what should I post this week", "a 7-day channel plan". Do not activate if the request is about a website or email newsletter.
---
# Weekly Content Plan
## Steps
1. Read `knowledge/audience.md` - who we're writing for
2. Read `knowledge/tone-of-voice.md` - how we write
3. Read the last 10 posts in the channel - what has already been covered
4. Come up with 7 topics for the week: 3 sales-focused, 2 expert, 2 personal
5. For each, provide one hook line and three bullets about the post
6. Output as a table: day of the week | type | hook | plan
זה מספיק. אם משתמש כותב, ״בואו נתכנן את הפוסטים לשבוע״, Claude רואה את הטריגר בתיאור, טוען את SKILL.md, קורא את הקבצים ששמותיהם מפורטים ומפיק טבלה.
מגבלות שכדאי לזכור
תיעוד Claude API הרשמי קובע מגבלות מחמירות:
name: עד 64 תווים; אותיות קטנות, מספרים ומקפים בלבד, ללא תגיות XML.anthropicו-claudeשמורים.description: עד 1024 תווים ב-API; נדרש, ללא תגיות XML.- תקציב הרשימה: ב-Claude Code, התיאורים של כל ה-skills יחד תופסים בערך 1% מחלון ההקשר. אם יש הרבה skills, התיאורים ייחתכו — ומילות המפתח ש-Claude צריך להתאים עלולות להיעלם.
- גוף SKILL.md: Anthropic ממליצים להשאיר את הגוף בגבולות 500 שורות. העבירו תוכן ארוך יותר לקובצי
references/,scripts/ו-examples/וטענו אותם באמצעות ההוראות.
לאחר דחיסת ההקשר (/compact), Claude שומר את 5000 הטוקנים הראשונים של כל skill שהופעל קודם לכן; התקציב הכולל לכל ה-skills שמוצמדים מחדש הוא 25 000 טוקנים. אם skill לא נכנס, ההתנהגות שלו ״נשכחת״.
סכמת Frontmatter מלאה
לכל הפחות, השתמשו ב-name וב-description. Skills לייצור משתמשים גם בשדות נוספים:
| שדה | מטרה | דוגמה |
|---|---|---|
name | שם ה-skill; ברירת המחדל היא שם התיקייה אם הושמט | deploy-to-prod |
description | טריגר להפעלה אוטומטית | ראו את הנוסחה בהמשך |
when_to_use | ביטויי טריגר נוספים | ["deploy", "let's ship it"] |
allowed-tools | באילו כלים אפשר להשתמש ללא בקשת רשות | ["Read", "Bash(npm run build)"] |
disable-model-invocation | true - רק המשתמש יכול להפעיל אותו | לפעולות מסוכנות |
user-invocable | false - רק Claude יכול להפעיל אותו | לידע רקע |
paths | דפוסי Glob שבהם ה-skill פעיל | ["src/**/*.ts"] |
context: fork | הפעלה בסוכן משנה מבודד | כשההקשר כבד |
agent | סוג סוכן המשנה להפעלה | Explore, Plan, general-purpose |
effort | רמת החשיבה | low, medium, high, xhigh, max |
model | איזה מודל להקצות ל-skill | claude-opus-4-7 |
hooks | Hooks במחזור החיים של ה-skill | ראו את סעיף ה-hooks |
השדה disable-model-invocation: true הוא חובה לכל דבר שאסור להפעיל אוטומטית. לדוגמה, אפשר להפעיל skill בשם deploy-to-prod עם הדגל הזה רק אם המשתמש מקליד במפורש /deploy-to-prod. בלי הדגל, Claude עלול לבצע פריסה כי ״הקוד נראה מוכן״.
למה התיאור אחראי ל-90% מהעבודה, ואיך כותבים אותו?
נקודות מרכזיות
התיאור הוא השדה היחיד ש-Claude רואה בתחילת השיחה. אם הוא מנוסח בצורה גרועה, ה-skill לא יעבוד גם אם גוף ההוראות שלו מושלם. לתיאור טוב יש שלושה חלקים: מה הוא עושה + ביטויי טריגר במירכאות + מתי לא להשתמש בו. ב-skill-creator שלו, Anthropic ממליצים להפוך את התיאורים ל״מעט דוחפים״ — Claude נוטה לא להפעיל skills מספיק.
הטעות הנפוצה ביותר אצל vibe-coders היא לכתוב תיאור כמו ״עוזר ל-X״. ה-skill נמצא פיזית בתיקייה שלו, אבל Claude לא מפעיל אותו.
תיאור גרוע
description: Build dashboards.
מה Claude לא יכול להבין: כשמשתמש מבקש ״תראה לי מכירות השבוע״, האם מדובר בלוח מחוונים או לא? כשמשתמש מבקש ״תרשים הכנסות״, האם מדובר בלוח מחוונים או סתם בתרשים? כשמבקשים ״דוח חודשי״, האם ברור שזה לא לוח מחוונים?
ה-skill-creator של Anthropic מציג את ההמלצה במפורש:
ל-Claude יש כרגע נטייה להפעיל skills בחסר — לא להשתמש בהם במקומות שבהם הם עשויים להיות מועילים. כדי להתמודד עם זה, נסחו תיאורים של skills בצורה מעט ״דוחפת״.
הנוסחה לתיאור טוב
שלושה חלקים:
- מה הוא עושה - משפט אחד שמתאר את התוצאה, לא את התהליך. לא ״מייצר SQL״, אלא ״מייצא את המכירות לטבלה עבור ערוץ Telegram״.
- מתי להפעיל אותו - 3-5 ביטויים במירכאות שמשתמשים באמת אומרים. אל תנחשו; בדקו את היסטוריית הצ'אט והתמיכה שלכם.
- מתי לא להפעיל אותו - 1-2 ביטויים על משימות דומות שה-skill לא אמור להשיב עליהן. בלי החלק הזה, שני skills דומים ימשיכו להתנגש.
דוגמה לתיאור חזק מהפרויקט שלי (בגרסה פשוטה ואנונימית):
description: |
Writes and publishes an SEO guide to the blog, following the editorial policy.
Triggers: "write a guide about X", "let's make a new pillar",
"a blog article about Y", "build a blog guide about Z".
Do not activate if the request is about an email newsletter,
a Telegram post, or an internal team instruction—
those are other skills.
מה עובד כאן:
- הפועל ״כותב ומפרסם״ במקום ״עוזר עם״ מגדיר תוצאה מוחשית.
- ארבעה ביטויי טריגר במירכאות מכסים ניסוחים שונים.
- נכלל גם ביטוי טריגר באנגלית — אם המשתמש עובר לשפת הצוות, ה-skill עדיין יעבוד.
- סעיף נפרד של ״אל תפעיל אם״ מונע התנגשויות עם skills של ניוזלטרים ופוסטים.
איך לבדוק תיאור
ב-skill-creator שלו, Anthropic שילבו מתודולוגיה להערכת טריגרים: 20 הנחיות כדי לבדוק אם skill מופעל. עשר אמורות להפעיל אותו ועשר לא — כולל מצבים כמעט זהים, שבהם הניסוח דומה אבל המשימה שונה.
במונחים של vibe-coder, פירוש הדבר הוא: אחרי כתיבת התיאור, פתחו שיחה ריקה ונסו 5 ביטויים שאתם באמת משתמשים בהם, ועוד 3 ביטויים דומים שמשמעותם משהו אחר. אם ה-skill לא מופעל במקום שבו הוא אמור לפעול, או מופעל במקום שבו לא צריך, שנו את התיאור. רק אז כתבו את גוף ההוראות.
אילו 5 Skills הייתי מתקין תחילה?
נקודות מרכזיות
האסטרטגיה המהירה ביותר ליזמים היא להתחיל באוספים מוכנים ולהתאים אותם לצרכים שלכם. Anthropic ו-Vercel פרסמו אוספים ציבוריים שאפשר להתקין בפקודה אחת. נכון למאי 2026, המאגר הרשמי anthropics/skills כולל כ-138,000 כוכבים.
השקעת השבועיים הראשונים בכתיבת skills משלכם היא אסטרטגיה מפסידה. התחילו בהתקנת skills מוכנים ובדקו איך בנו אותם; אחר כך הוסיפו משלכם באותה גישה. זול יותר לקחת אוספים מוכחים שאחרים יצרו ולהתאים אותם לעצמכם מאשר לבנות הכול מאפס. הנה חמישה אוספים שהייתי מתחיל איתם:
1. anthropics/skills - האוסף הרשמי עם skill-creator
מאגר: github.com/anthropics/skills. 138,000 כוכבי GitHub. הוא מכיל skills רשמיים של צוות Anthropic: skill-creator (meta-skill שיוצר skills אחרים), claude-api (מסייע בבניית אינטגרציות API), ו-skills מוכנים למסמכים ב-PowerPoint, Excel, Word ו-PDF.
התקנה באמצעות Claude Code:
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills
הערך העיקרי הוא skill-creator. הוא כותב SKILL.md על סמך התיאור שלכם, ואז מריץ 20 הערכות טריגרים ומשנה את התיאור עד שה-skill מתחיל לפעול במקומות הנכונים. למעשה, זה ״skill ליצירת skills״.
2. mattpocock/skills - האוסף הוויראלי של מומחה TypeScript
היא מכילה 12 skills פעילים, ובהם:
grill-me- שואל שאלות לפי עץ החלטה עד שהאי-ודאויות במשימה מתבהרות. נקודת הכאב העיקרית של vibe-coders — ״אני לא יודע מה אני רוצה״ — מטופלת כבר באיטרציה הראשונה.
התקנה:
npx skills@latest add mattpocock/skills
/setup-matt-pocock-skills
3. coreyhaines31/marketingskills - אוסף למשווקים
אם אתם מנהלים תוכניות מקוונות, עובדים כמשווקים עצמאיים או מנהלים סוכנות, אין צורך להקדיש שישה חודשים לכתיבת skills משלכם. חצי מהמשימות כבר ארוזות ומוכנות.
4. vercel-labs/agent-skills - עיצוב בלי מראה של AI
מאגר: github.com/vercel-labs/agent-skills. ה-skill המוביל שלו הוא web-design-guidelines, עם כ-133,000 התקנות שבועיות. הוא בודק קוד UI מול יותר מ-100 כללים של נגישות, ביצועים ושימושיות.
לצדו נמצא frontend-design של Anthropic, עם יותר מ-110,000 התקנות שבועיות. הוא גורם ל-AI לבחור סגנון לפני שהוא מתחיל לכתוב קוד. בלעדיו, בכל עמוד ש-Claude מייצר מופיעים גופן Inter, מעבר צבע סגול וכרטיסיות רשת. התוצאה זהה לכולם.
5. obra/superpowers - תהליך עבודה מרובה סוכנים
בסך הכול, אם תתקינו את שלושת האוספים הראשונים ברשימה — anthropics/skills, mattpocock/skills ו-coreyhaines31/marketingskills — ל-Claude Code שלכם יהיו עשרות skills מוכנים שיכסו את רוב משימות היזמות בחודש הראשון.
אילו משימות חוזרות כדאי להפוך ל-skill?
נקודות מרכזיות
הכלל פשוט: כל פעולה שאתם עושים יותר מפעמיים בשבוע ופועלים בה לפי אותם שלבים פחות או יותר היא מועמדת ל-skill. לא ״דוח שנתי מורכב לרואה החשבון״, אלא עבודה שגרתית: תוכנית תוכן לערוץ, בדיקת קבלות של לקוח, הודעת קבלת פנים למשתתף חדש. Skill הופך מאמץ חד-פעמי לנכס שעובד בלעדיכם.
בעבודה מול לקוחות ובפרויקטים של אחרים ראיתי את הדפוס הזה עשרות פעמים. למישהו יש ״את הדבר הזה שהוא עושה מחדש מאפס בכל פעם״. בכל יום שני הוא כותב אותו סוג של דוח. בכל פעם שלקוח חדש מצטרף, הוא עובר את אותו נוהל. כל פרסום פועל לפי אותה תבנית. ובכל פעם זה לוקח 30-90 דקות, כי צריך להיזכר בשלבים, לפתוח את הקבצים הנכונים ולנסח שוב את ההנחיה ל-Claude.
הפתרון הוא לארוז את התהליך ב-skill פעם אחת. אחר כך אומרים ביטוי אחד, ו-Claude טוען את המתודולוגיה, קורא את המקורות הדרושים ומפיק את התוצאה. שלוש דוגמאות מתחומים שונים:
דוגמה 1. משווקת עצמאית - skill בשם weekly-content-plan
מה היא עושה ידנית: בכל יום שני היא מכינה תוכן לשבוע שלם עבור שלושה לקוחות, בפוסטים ל-Telegram. היא פותחת את מדריך קול המותג של הלקוח, בודקת פוסטים אחרונים, חושבת על נושאים לפי לוח השנה של המוצר ועורכת טבלה עם hooks ונקודות.
כ-skill, התהליך הופך להוראות בחמישה שלבים: לקרוא את קובץ הטון של הלקוח, לקרוא את לוח השנה של המוצר, לבדוק את 10 הפוסטים האחרונים כדי למנוע חזרות, להציע שבעה נושאים המחולקים לפי סוג (מכירתי, מקצועי, אישי) ולהפיק טבלה.
הפקודה ״בוא נתכנן את הפוסטים של הלקוח X לשבוע״ הופכת שעה של הכנה לשלוש דקות המתנה. המשווקת בודקת את התוצאה, מבצעת תיקונים ממוקדים ושולחת אותה ללקוח.
דוגמה 2. רואה חשבון במיקור חוץ - skill בשם monthly-receipts-close (דוגמת המחבר)
מה הוא עושה ידנית: עבור כל לקוח בתיק, מדי חודש הוא מייצא דף חשבון בנק, משווה אותו לתשלומים במערכת הנהלת החשבונות, מסמן תשלומים שלא סווגו, מכין דוח הכנסות ראשוני ומשווה את מבנה ההכנסות לחודש הקודם.
ה-skill הוא הוראות בשישה שלבים ועוד כמה סקריפטים של shell בתיקיית scripts/ לניתוח דפי חשבון בנק. הטריגר ״סגור את מאי עבור הלקוח X״ גורם ל-Claude להפיק דוח עם חריגות מסומנות בתוך 4-5 דקות.
דוגמה 3. יוצרת תוכנית מקוונת - skill בשם welcome-letter-new-participant
מה היא עושה ידנית: משתתף חדש שילם ועכשיו צריך לכתוב לו הודעת קבלת פנים. הודעת קבלת פנים טובה היא אישית: היא מתחשבת בערוץ שממנו הגיע, במוצר שקנה, במחזור שאליו הוא משתייך ובחומרים שכדאי לשלוח לו. תבנית של ״שלום, שמחים שהצטרפת״ לא עושה את זה.
ה-skill מורה ל-Claude לקרוא את knowledge/audience.md (מי האנשים האלה), את knowledge/products/<product>.md (מה הם מקבלים) ואת שלוש הודעות קבלת הפנים האחרונות (כדי למנוע חזרות), ואז לכתוב את ההודעה במבנה הזה: פתיח - פרטי המוצר - שלושת הצעדים הראשונים - חתימה.
זה מהיר פי כמה וכמה מעבודה ידנית. האיכות עקבית יותר, כי Claude זוכר לבדוק שלושה מקורות, ואילו אדם שממהר מדלג על אחד מהם.
מה לא כדאי להפוך ל-skill
- משימות חד-פעמיות. אם אתם עושים משהו פעם בשנה, בעת הגשת דוח מס, פשוט תארו אותו ל-Claude בצ'אט. Skill משתלם אחרי 3+ חזרות.
- משימות כלליות מדי. ״עזור לי בשיווק״ אינו skill; זה כל תחום השיווק. Skill הוא ״תוכנית תוכן שבועית״ — פעולה מסוימת עם תוצאה מסוימת.
- משימות ללא שלבים שחוזרים על עצמם. אם התהליך שונה בכל פעם, זה לא skill אלא עבודה חד-פעמית.
איך Skill Creator כותב עבורכם skills?
נקודות מרכזיות
Skill Creator הוא meta-skill של Anthropic שהושק עם הפקודה /skill-creator. הוא מוביל אתכם בשישה שלבים: ניסוח, בדיקה, הערכה, איטרציה, אופטימיזציה ואריזה. התוצאה היא SKILL.md מוכן לשימוש שנבדק מול 20 הערכות טריגרים (10 שאמורות להפעיל אותו ו-10 שלא). למי שאינו מתכנת, זו הדרך המהירה ביותר לכתוב skill ראשון שעובד — בלי לפענח YAML או להתווכח עם Claude.
הבעיה היא שקשה לכתוב skill טוב כבר בניסיון הראשון. התיאור יוצא לעיתים צר או רחב מדי, לא כולל את הביטויים שמשתמשים באמת אומרים, או מתנגש עם skill סמוך. Anthropic פתרו את זה כשפרסמו את skill-creator, meta-skill שיכול ליצור skills אחרים.
אחרי התקנת anthropics/skills, אמרו ל-Claude /skill-creator (או פשוט ״בוא ניצור skill לדוח השבועי״) ופעלו לפי תהליך עבודה בן שישה שלבים:
- ניסוח טיוטה - skill-creator שואל שאלות: מה ה-skill אמור לעשות, באילו ביטויי טריגר להשתמש, אילו מקורות לקרוא ולאילו שלבים לפעול. התוצאה היא הגרסה הראשונה של SKILL.md.
- בדיקה - skill-creator יוצר 20 הנחיות בדיקה: 10 שאמורות להפעיל את ה-skill ו-10 שנראות כמו טריגרים אך לא אמורות להפעיל אותו (כמעט-התאמות).
- הערכה - הוא מריץ כל הנחיה בשיחה חדשה ובודק אם ה-skill הופעל. אם הוא מופעל במקום שבו לא צריך או לא מופעל במקום שבו צריך, הוא מסמן את התוצאה.
- איטרציה - הוא משכתב את התיאור על סמך הכשלים ומריץ את הבדיקות שוב.
- אופטימיזציה - ליטוש אחרון: בדיקה אם חורגים ממגבלת 1024 התווים ואם קיימות התנגשויות עם skills קיימים בפרויקט.
- אריזה - אריזת SKILL.md הסופי וקובצי העזר במבנה המתאים.
בפועל, זה נראה כך: משוחחים עם Claude במשך 15-20 דקות, עונים על 7-8 שאלות הבהרה ומקבלים בסוף skill מוכן שנבדק ומופעל בעקבות הטריגרים הנכונים.
יתרון נוסף הוא ש-skill-creator מדגים סגנון למופת לכתיבת SKILL.md. אפשר לפתוח את הקובץ שלו ולראות את הפורמט, הטון ומבנה השלבים. זה מקרה שבו הכלי מדגים את עצמו — קוראים ולומדים איך לכתוב skill משלכם.
Skills, CLAUDE.md, Subagents, MCP, Hooks: במה להשתמש?
נקודות מרכזיות
ל-Claude Code יש חמישה רכיבים נפרדים להרחבת ההתנהגות, והם אינם ניתנים להחלפה. CLAUDE.md הוא ידע קבוע על הפרויקט. Skills הם תהליכי עבודה חוזרים שמופעלים בעקבות טריגרים. Subagents מבצעים עבודה במקביל בהקשר נפרד. MCP מחבר מערכות חיצוניות (ממשקי API, מסדי נתונים). Hooks מגיבים לאירועים באופן אוטומטי. הטעות הנפוצה ביותר של vibe-coders היא לדחוס הכול לתוך CLAUDE.md או לנסות לבנות skill עם hook.
הבעיה הנפוצה ביותר בפרויקטים שבדקתי היא שקובץ CLAUDE.md מכיל יחד כללי פרויקט, הוראות פרסום שלב אחר שלב, תבנית commit ותיאור של מסד נתונים. כך מעמיסים על ההקשר, והפתרון גם נכשל בפועל: Claude לא מבצע את ההוראה ״כשמשתמש מבקש לפרסם״ כי המודל מתייחס לכל CLAUDE.md כהקשר כללי, ללא טריגרים מפורשים.
הפתרון הוא לשייך כל פריט לרכיב המתאים:
| מה | מתי להשתמש | דוגמה |
|---|---|---|
| CLAUDE.md | ידע שנחוץ תמיד | ״לפרויקט יש שפה מוגדרת״, ״לא משתמשים בקווים ארוכים בטקסט״, ״שם המותג נכתב עם o״ |
| Skills | תהליך חוזר שמופעל בעקבות טריגר | ״פרסם לסביבת הייצור״, ״תוכנית פוסטים שבועית״, ״סגור את ספרי הלקוח לחודש״ |
| Subagents | עבודה במקביל או הפרדת הקשר כבד | ״ביקורת אבטחה בזמן שאני מתכנן תכונה חדשה״, ״בדיקת בסיס הקוד בשיחה נפרדת״ |
| MCP | חיבור למערכת חיצונית | ״קבל נתונים מה-CRM״, ״משוך משימות ממערכת המעקב״, ״בדוק את האתר בדפדפן״ |
| Hooks | תגובה אוטומטית לאירוע | ״הרץ בדיקה אחרי Edit״, ״חסום פקודות מסוכנות״, ״שלח התראת Telegram בסיום״ |
במילים קצרות, התמונה מסתכמת בהיגיון פשוט: Skills ו-MCP מכסים את רוב תהליכי העבודה; Hooks מבצעים משימות שגרתיות באופן אוטומטי — בדיקות קוד, בדיקות ואמצעי הגנה. Subagents נחוצים כשההקשר נעשה כבד. הטעות הנפוצה ביותר היא ליצור subagent כשצריך להשתמש ב-skill.
עץ החלטה
כשאתם חושבים, ״אני צריך ש-Claude יעשה X״:
- האם הידע הזה נחוץ כל הזמן? למשל, ״לפרויקט יש שפה מוגדרת״ או ״אנחנו לא משתמשים בקו מפריד ארוך״. ← הכניסו אותו ל-
CLAUDE.md. - האם מדובר בנוהל שמופעל בעקבות טריגר ושאתם עושים כרגע ידנית? למשל, ״אני כותב דוח בכל יום שני״. ← צרו skill.
- האם אתם צריכים גישה למערכת חיצונית? למשל, API של Stripe או ה-CRM שלכם. ← התחברו לשרת MCP.
- האם Claude Code צריך להגיב אוטומטית לאירוע? למשל, להריץ linter אחרי כל Edit. ← כתבו hook.
- האם המשימה כבדה, תצרוך את כל ההקשר, ואתם צריכים לעשות משהו אחר במקביל? ← הפעילו subagent.
90% מהמשימות של יזם-vibe-coder נופלות בקטגוריות 1-3. Hooks ו-subagents הם כלים מתקדמים יותר למי שכבר עבר את שלב ״משימה אחת בכל פעם״.
פקודות Slash ו-Skills הם אותו הדבר
שינוי חשוב ב-Claude Code: מערכת פקודות ה-slash הישנה (.claude/commands/) ו-skills למעשה התמזגו. הקובץ .claude/commands/deploy.md והקובץ .claude/skills/deploy/SKILL.md יוצרים שניהם פקודת /deploy. אם השמות תואמים, ה-skill הוא שקובע. לכן, אם אתם עדיין משתמשים בפורמט ה-slash-command הישן, עברו ל-skills; התחביר ברור יותר ויש יותר יכולות.
7 טעויות שמונעות מ-skill לעבוד
נקודות מרכזיות
הבעיות הנפוצות ביותר ב-skills אינן באגים של Claude אלא טעויות ב-skill עצמו. תיאור ללא טריגרים, SKILL.md עמוס בן 2,000 שורות, שני skills דומים שמתנגשים או ניסיון להוריד ״את כל מה שיש בשוק״. כל אחת מהטעויות האלה פוגעת בהפעלת ה-skill או באופן פעולתו.
1. תיאור ללא טריגרים: ה-skill לא מופעל
תסמין: כתבתם skill, בדקתם את המבנה והכול תקין, אבל Claude לא מפעיל אותו בעקבות בקשות משתמש. הסיבה כמעט תמיד זהה: תיאור כמו ״עוזר לכתיבת תוכן״. Claude לא יודע לאילו ביטויים להגיב. הפתרון: הוסיפו לתיאור 3-5 ביטויים ממשיים שמשתמשים אומרים, במירכאות.
2. SKILL.md ארוך מ-500 שורות: הקשב מתפזר
Anthropic ממליצים במפורש להשאיר את גוף הקובץ בגבולות 500 שורות. אם ההוראות שלכם ארוכות 2,000 שורות, Claude מאבד ריכוז, מבצע רק חלק מהשלבים ומתבלבל בסדר שלהם. הפתרון: העבירו מקטעים גדולים לקבצים סמוכים — examples/, references/, scripts/ — והפנו אליהם מתוך SKILL.md.
3. Skill אחד ל״כל מה שקשור לתוכן״ במקום שלושה קטנים
הגדרה מפתה: skill גדול אחד בשם content עם פוסטים ל-Telegram, דפי נחיתה ודוא״ל. זה לא עובד. ה-skill מופעל בבקשות הלא נכונות, מערבב מתודולוגיות ומפיק תוצאה ממוצעת. הפתרון: skill אחד = פעולה חוזרת אחת. אם יש לכם שלוש שגרות בתחום ה״תוכן״, צרו שלושה skills: telegram-post, landing-section, email-broadcast.
4. Skill ללא סעיף ״מתי לא להשתמש בו״: התנגשויות
תסמין: יש שני skills דומים בפרויקט, ו-Claude מפעיל את הלא נכון. למשל, skill אחד עוסק בניוזלטר בדוא״ל ואחר מיועד במיוחד להודעות קבלת פנים למשתתפי תוכנית. בלי סעיף מפורש של ״אל תפעיל אם הבקשה עוסקת ברשימת דיוור כללית״, ה-skill של הודעות קבלת הפנים יופעל בכל אזכור של ״דוא״ל״. הפתרון: ציינו בתיאור מקרים שליליים.
5. 50 Skills בפרויקט: התיאורים נחתכים
מתוך תיעוד Claude Code:
שמות ה-skills תמיד נכללים, אבל אם יש הרבה skills, התיאורים שלהם נחתכים כדי לעמוד במגבלת התווים, והדבר עלול להסיר את מילות המפתח שבהן Claude משתמש להתאמת הבקשה. התקציב הוא 1% מחלון ההקשר של המודל.
אם הורדתם 50 אוספי skills מ-marketplace, חלק מהתיאורים ייחתכו. מילות המפתח שבניתם עליהן עלולות להיעלם. הפתרון: השאירו בפרויקט הפעיל את 10-15 ה-skills השימושיים ביותר. את השאר שמרו בארכיון לא פעיל מחוץ לכל תיקיות גילוי ה-skills, למשל בתיקיית skill-archive/ נפרדת בחומרים שלכם. התקינו רק את ה-skills הדרושים ברמת הפרויקט או ברמה האישית. ~/.claude/skills/ היא ספרייה אישית מותקנת שזמינה בכל הפרויקטים, ולכן העברת skills אליה אינה מוציאה אותם ממנגנון הגילוי.
6. Skills ממקורות לא מאומתים: סיכון אבטחה
Anthropic מזהירים על כך בתיעוד הרשמי:
השתמשו רק ב-skills ממקורות מהימנים: כאלה שיצרתם בעצמכם או שקיבלתם מ-Anthropic. skill זדוני עלול לגרום ל-Claude להפעיל כלים או להריץ קוד בדרכים ששונות מהמטרה המוצהרת של ה-skill.
מאגר GitHub אקראי עלול להכיל skill שידליף את מפתחות ה-API שלכם בפעם הראשונה שתפעילו אותו. הפתרון: פתחו את SKILL.md וקראו אותו בעצמכם לפני ההתקנה. אל תריצו skills של מחברים לא מוכרים בפרויקטים חשובים.
7. Skill בלי תיקיית ידע מפיק ״ChatGPT ממוצע״
זו התבנית האנטי-דפוסית העדינה והנפוצה ביותר. Skill הוא מתודולוגיה, אבל מתודולוגיה לבדה אינה אומרת דבר בלי הקשר. אם תכתבו skill בשם ״כתוב הודעת קבלת פנים״, אך בפרויקט אין קובץ שמתאר את הקהל ואין קובץ קול מותג, Claude יכתוב הודעת דוא״ל ממוצעת של ChatGPT, שאינה נבדלת מזו של כל אחד אחר.
Skill פועל במיטבו רק אחרי שכבר בניתם את ה-Second Brain של הפרויקט לפי העקרונות שבמדריך על CLAUDE.md. קודם בנו את מבנה הידע ורק אז צרו skills שמסתמכים עליו. הפכו את הסדר ותקבלו עבודה שגרתית באיכות ממוצעת במקום עבודה אישית בסגנון שלכם.
איך לבנות את ה-skill הראשון שלכם בתוך 30 דקות
נקודות מרכזיות
מתכון שלב אחר שלב לבניית skill ראשון שעובד: בחרו פעולה חוזרת אחת, כתבו את השלבים, צרו את מבנה התיקיות, כתבו תיאור לפי הנוסחה, בדקו אותו באמצעות 5-8 הנחיות וחזרו על התהליך עד שהוא מופעל במקומות הנכונים. לוח זמנים מציאותי ל-skill הראשון הוא 30-40 דקות. כל skill אחריו ייקח 10-15 דקות, כי הפורמט כבר יהיה מוכר.
הנה התוכנית המעשית שבה השתמשתי לבניית ה-skills הראשונים בפרויקטים שלי:
שלב 1. בחרו פעולה חוזרת אחת
פתחו את היומן של החודש האחרון. מצאו משימה שביצעתם לפחות 4-5 פעמים, וכל פעם ארכה 30-60 דקות. לא ״שיווק״ כללי, אלא משהו מסוים: ״דוח מכירות של יום שני״, ״קליטת לקוח חדש״ או ״עדכון מחירון למבצע״.
ככל שהניסוח מצומצם יותר, ה-skill פשוט יותר והטריגר מדויק יותר.
שלב 2. כתבו את התהליך ידנית
בקובץ נפרד או בשיחה עם Claude (לא עבור ה-skill, אלא כטיוטה), כתבו את השלבים שאתם מבצעים:
1. Open the client database
2. Filter by status "awaiting welcome email"
3. Check which channel the client came from
4. Get the email template for that channel from the "templates" folder
5. Fill in the name, product, and start date
6. Send
זה עדיין לא skill אלא הערות. אבל בלי ההערות האלה, כתיבת SKILL.md תוביל לבלבול כבר מההתחלה.
שלב 3. צרו את מבנה התיקיות
mkdir -p .claude/skills/welcome-email-new-client
touch .claude/skills/welcome-email-new-client/SKILL.md
או, אם אתם רוצים להשתמש ב-skill בכל הפרויקטים שלכם, שימו אותו ב-~/.claude/skills/.
שלב 4. כתבו SKILL.md לפי התבנית
שלד:
---
name: welcome-email-new-client
description: |
Prepares a welcome email for a new client using the template for their acquisition channel.
Triggers: "write a welcome email for new client X",
"onboard new participant Y", "welcome email for client from channel Z".
Do not activate if the request is about a general mailing list
or an email campaign—those are other skills.
---
# Welcome Email for a New Client
## Steps
1. Read `knowledge/audience/segments.md` - what client segments we have
2. Read `knowledge/templates/welcome/` - templates by channel
3. Identify the client's channel from the request context
4. Insert the client's name, product name, and start date
5. Check the length—it should be no more than 800 characters
6. Output the final email text in a copy-ready format
## Important
- Do not use “dear friend” or “hello”—use natural speech
- One paragraph, one idea
- End with one call to action, not two
שלב 5. בדקו עם 5-8 הנחיות
פתחו צ'אט ריק עם Claude Code בפרויקט הזה. נסו 5 ביטויים שאתם באמת משתמשים בהם ו-3 ביטויים דומים שלא אמורים להפעיל את ה-skill:
אמור להפעיל:
- “Write a welcome email for new client Ivanov”
- “Onboard a new participant who bought program X”
- “Welcome email for a client from Instagram”
לא אמור להפעיל:
- “Send a promotion email to the whole list”
- “Email campaign for the New Year holidays”
- “Write a follow-up to a client who hasn't paid”
בכל מקרה, בדקו אם ה-skill הופעל. אם הוא מופעל במקרים הלא נכונים, צמצמו את התיאור. אם אינו מופעל במקום שבו צריך, הרחיבו את ביטויי הטריגר.
שלב 6. בצעו איטרציה על התיאור
אחרי כל בדיקה שנכשלה, ערכו רק את התיאור — אל תגעו בגוף ההוראות. אחרי 2-3 איטרציות, ה-skill מתחיל לפעול באופן אמין. שמרו אותו, בצעו commit ואז השתמשו בו מדי יום.
עצה אחרונה: אל תנסו להפוך את ה-skill הראשון שלכם למושלם. גרמו לו לעבוד. הליטוש יבוא אחרי ה-skill החמישי או העשירי, כשתתחילו לזהות דפוסים בניסוחים שלכם ובתגובות של Claude.
בחרו משימה חוזרת אחת מהיומן לשבוע הזה, פנו לה 30 דקות ופעלו לפי ששת השלבים שלמעלה. כך Claude יעבוד לפי המתודולוגיה שלכם במקום לנחש.
מקורות
- הרחבת Claude באמצעות skills - תיעוד Claude Code
- סקירה כללית של Agent Skills - תיעוד Claude Platform
- הצטיידות סוכנים לעולם האמיתי באמצעות Agent Skills - בלוג ההנדסה של Anthropic
- anthropics/skills - מאגר רשמי עם skill-creator
- Skill Creator SKILL.md - מקור המתודולוגיה להערכת טריגרים
- vercel-labs/agent-skills - הנחיות עיצוב
- תקן Agent Skills הפתוח - מפרט
אם אתם צריכים גישה למודלי AI דרך Ailoot, בקרו ב-Ailoot.
פרטים נוספים
שאלות ותשובות: Skills של Claude Code בשנת 2026: איך לבנות לעצמכם ספריית skills
האם העברת skill אל ~/.claude/skills/ הופכת אותו ללא פעיל?
לא. זו תיקיית ההתקנה האישית, והיא הופכת את ה-skill לזמין בכל הפרויקטים שלכם. שמרו חבילות שאינן בשימוש בארכיון מחוץ לכל תיקיות הגילוי, ואז התקינו רק את ה-skills הדרושים כרגע.
איך בודקים אם התיאור מפעיל את ה-skill נכון?
נסו חמישה ניסוחים שאמורים להפעיל אותו ושלוש בקשות דומות שלא אמורות. השתמשו בשיחות חדשות, תעדו איזה skill נטען ושנו את התיאור כשהוא מחמיץ בקשה אמיתית או מתאים בטעות לבקשה דומה.