כיצד להפוך משימה חוזרת למיומנות לשימוש חוזר עבור סוכן הקוד של הבינה המלאכותית שלכם

אם אתם ממשיכים להדביק את אותה רשימת מטלות לתוך סוכן הקוד של הבינה המלאכותית שלכם — "כתוב conventional commit, ואז הרץ את הבדיקות, ואז עדכן את ה-changelog" — אתם מבצעים עבודה שהסוכן יכול לזכור עבורכם. רוב הסוכנים המודרניים מאפשרים לכם לארוז הליך חוזר לתוך קובץ קטן לשימוש חוזר. ב-Claude Code אלה נקראים מיומנויות (skills); אותו קובץ גם מפעיל פקודות slash כמו /deploy. מדריך זה עובר על בניית אחת מאפס, ואז מסביר את העקרונות שעוברים לכלים אחרים.

מהי מיומנות

מיומנות היא תיקייה עם קובץ SKILL.md יחיד בתוכה. לקובץ זה יש שני חלקים: frontmatter ב-YAML שאומר לסוכן מתי להשתמש במיומנות, וגוף markdown עם ההוראות שהוא עוקב אחריהן כאשר המיומנות רצה. היתרון המרכזי על פני דחיסת הכל לתוך קובץ CLAUDE.md (או AGENTS.md) הוא חשיפה הדרגתית (progressive disclosure): הגוף נטען רק כאשר המיומנות מופעלת בפועל, כך שחומר עזר ארוך עולה כמעט כלום עד שאתם זקוקים לו.

אתם מפעילים מיומנות בשתי דרכים: ישירות, על ידי הקלדת /skill-name, או באופן אוטומטי — הסוכן קורא את הבקשה שלכם, מתאים אותה אל ה-description של המיומנות, וטוען אותה אם היא רלוונטית.

היכן מיומנויות שוכנות

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

• ~/.claude/skills/<name>/SKILL.md — אישית, זמינה בכל הפרויקטים שלכם.
• .claude/skills/<name>/SKILL.md — פרויקט, מקובעת ל-repo כך שכל מי שבצוות מקבל את אותה פקודה.

שם התיקייה הופך לפקודה. תיקייה בשם summarize-changes מעניקה לכם /summarize-changes.

דוגמה קונקרטית

בואו נבנה מיומנות שמסכמת את השינויים הלא מקובעים שלכם ומסמנת כל דבר מסוכן לפני שאתם מקבעים. צרו את התיקייה:

mkdir -p ~/.claude/skills/summarize-changes

ואז שמרו את זה כ-~/.claude/skills/summarize-changes/SKILL.md:

---
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---

## Current changes

!`git diff HEAD`

## Instructions

Summarize the changes above in two or three bullet points, then list any
risks you notice such as missing error handling, hardcoded values, or tests
that need updating. If the diff is empty, say there are no uncommitted changes.

שני דברים גורמים לזה לעבוד. ראשית, ה-description כתוב עבור הסוכן, לא עבורכם — הוא מציין את הטריגרים ("what changed", "wants a commit message", "review their diff") כך שהסוכן יודע מתי לפנות אליו. שנית, השורה !`git diff HEAD` היא הזרקת הקשר דינמית (dynamic context injection): Claude Code מריץ את הפקודה הזו ומדביק את הפלט שלה לתוך הפרומפט לפני שהסוכן קורא את המיומנות. ההוראות מגיעות עם ה-diff האמיתי שלכם כבר משולב בתוכן, כך שהתשובה מבוססת על עץ העבודה האמיתי שלכם במקום על ניחושים.

בצעו עריכה קטנה לקובץ כלשהו, הפעילו את הסוכן שלכם, ונסו את שתי הדרכים — שאלו "מה שיניתי?" כדי להפעיל אותה אוטומטית, או הקלידו /summarize-changes כדי להריץ אותה ישירות.

העברת ארגומנטים

מיומנויות יכולות לקבל קלט. placeholder בשם $ARGUMENTS בגוף מוחלף בכל מה שאתם מקלידים אחרי הפקודה, ומשתנים עם אינדקס ($0, $1) תופסים מילים ספציפיות. מיומנות שמופעלת כ-/fix-issue 4821 יכולה להתייחס ישירות למספר ה-issue, כך שקובץ אחד מטפל בכל issue במקום אחד לכל כרטיס.

חמישה עקרונות למיומנויות שמחזיקות מעמד

אלה חלים בין אם אתם כותבים מיומנות של Claude Code, פקודת Cursor, או — נכון לתכונת Record & Replay של OpenAI מיוני 2026 — עורכים אוטומציה שהסוכן הקליט עבורכם:

1. כתבו את ה-description עבור המודל. הקדימו ביטויי טריגר קונקרטיים. תיאור מעורפל פירושו שהסוכן לעולם לא טוען את המיומנות אוטומטית, ואתם חוזרים להקלדת / ולזכירת שמות.
2. שמרו כל מיומנות למשימה אחת. מיומנות שמבצעת deploy וגם מריצה מיגרציות וגם מפרסמת ל-Slack קשה לסמוך עליה וקשה יותר לנפות בה באגים. מיומנויות קטנות וייעודיות מתחברות טוב יותר.
3. הזריקו הקשר חי במקום לתאר אותו. משיכת diff אמיתי, תוצאת בדיקה, או רשימת קבצים עדיפה על אמירה לסוכן "בדוק את המצב הנוכחי" — זה מסיר שלב שבו הסוכן יכול לנחש לא נכון.
4. חסמו כל דבר עם תופעות לוואי. עבור מיומנויות שמבצעות deploy, מיגרציה, או מחיקה, דרשו הפעלה מפורשת במקום לתת לסוכן להפעיל אותן אוטומטית. אתם רוצים אדם בלולאה לפני פעולות בלתי הפיכות.
5. קבעו מיומנויות צוות ל-repo. שמירת מיומנויות פרויקט ב-.claude/skills/ וקיבוען פירושם שכל מפתח — וכל הרצת סוכן ב-CI — עוקב אחר אותו הליך. המוסכמות שלכם מפסיקות לחיות בראש של אדם אחד.

מתי לפנות למיומנות

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