Skills — יכולות ארוזות מראש

Skill: מעבר לכלי בודד

Skill הוא חבילת הוראות עבודה למשימה מסוג ידוע: לא פעולה בודדת כמו tool, אלא תהליך שלם — השלבים, הסדר שלהם והכללים שצריך לעקוב אחריהם כדי לבצע אותו נכון.

tool עונה על "מה אפשר לעשות" (לקרוא קובץ, לשלוח בקשת רשת); skill עונה על "איך עושים דבר שלם נכון", ולרוב משתמש בכמה tools ברצף — כמו אדם שעובד לפי נוהל כתוב ומשתמש בדרך בכמה כלים.

איך Skill נטען: Progressive Disclosure

skills נטענים בשלבים, ולכן אפשר להחזיק עשרות מהם בלי למלא את הקונטקסט. בשלב הראשון רק השם והתיאור הקצר של כל skill נמצאים בקונטקסט, מתחילת השיחה — משפט או שניים לכל אחד.

כשמגיעה משימה, המודל משווה אותה לתיאורים. אם יש התאמה, הוא טוען את ההוראות המלאות של ה-skill, ורק עכשיו הן נכנסות לקונטקסט. בשלב השלישי, skill יכול להפנות לקבצים נוספים (מסמכי עזר, תבניות, סקריפטים) שהמודל קורא או מריץ רק אם המשימה באמת דורשת אותם.

לעיקרון הזה קוראים progressive disclosure: המודל מקבל כל שכבת מידע רק כשהוא צריך אותה. בלעדיו, כל skill זמין היה מוסיף את כל ההוראות שלו לכל שיחה ושוחק את תקציב הקונטקסט (פרק 9). וההבדל מ-subagent (פרק 4): skill נטען לתוך אותה לולאה, ולא מריץ לולאה נפרדת בקונטקסט משלו — אם כי skill יכול להורות להפעיל subagent כחלק מהתהליך.

מה יש בתוך Skill בפועל

ברוב המימושים skill הוא תיקייה עם קובץ הוראות ראשי ב-Markdown. בראש הקובץ יש frontmatter עם שם ותיאור — החלק שנטען תמיד — ומתחתיו גוף ההוראות, שנטען רק כשה-skill מופעל. לצידו יכולים לשבת קבצי עזר וסקריפטים.

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

---
name: code-review
description: סקירת קוד לפי רשימת קטגוריות קבועה. השתמש כשמבקשים review לקובץ, ל-diff או ל-PR.
---

# סקירת קוד

1. קרא את כל הקובץ לפני שאתה כותב ממצא כלשהו.
2. בדוק לפי הסדר: נכונות, אבטחה, ביצועים, קריאות.
3. לכל ממצא ציין: קטגוריה, קובץ ושורה, חומרה (גבוהה/בינונית/נמוכה) והצעת תיקון.
4. אם אין ממצאים בקטגוריה מסוימת - כתוב זאת במפורש.

לבדיקת אבטחה, עבור על הרשימה בקובץ security-checklist.md.

דוגמה: אותה משימה עם ובלי Skill

משימה: "תעשה code review לקובץ הזה". בלי skill, המודל מחליט בכל פעם מחדש על מה להסתכל (סגנון? באגים? אבטחה?) ובאיזה מבנה להציג את התוצאה. שתי בקשות זהות עלולות לקבל שתי סקירות שמתמקדות בדברים שונים.

עם ה-skill מהסעיף הקודם, ההוראות כבר קובעות אילו קטגוריות לבדוק, באיזה סדר ובאיזה פורמט — והתוצאה עקבית ומקיפה בכל הפעלה, בלי לסמוך על שיקול הדעת של המודל באותו רגע.

מתי כדאי לבנות Skill, ומתי כלי גולמי מספיק

skill משתלם למשימה שחוזרת על עצמה ושרוצים שתתבצע תמיד באותו אופן: code review, דוח שבועי בפורמט קבוע, תהליך פריסה. כותבים את ההוראות פעם אחת ומקבלים תוצאה אחידה בכל הפעלה.

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