📘 תיעוד 32

כישורים

כישורים הם חבילות הנחיות לשימוש חוזר שמרחיבות את Grok בהוראות ייעודיות למשימה. הם מאפשרים לתעד הליך חוזר פעם אחת, במקום להסביר אותו מחדש בכל סשן. גילוי בהפעלה מדלג על כישורי פרויקט ופקודות בתיקיות לא מהימנות.

#מה הם כישורים?

כישור הוא ספרייה שמכילה קובץ SKILL.md. גוף ה-markdown שלו אומר ל-Grok איך לטפל בסוג מסוים של משימה: הוראות צעד אחר צעד, מוסכמות, ודפוסי שימוש בכלים.

השתמשו בכישור להליך חוזר שהוא ספציפי מדי ל-AGENTS.md אבל ארוך מדי להקלדה מחדש. Grok מפעיל כישור רק כשהוא חל על המשימה הנוכחית.

#מיקומי כישורים

Grok מגלה כישורים מהספריות האלה, לפי סדר עדיפות:

Grok מסיר כפילויות של כישורים לפי שם. מיקום בעדיפות גבוהה יותר דורס מיקום נמוך יותר. Grok גם סורק את .agents/skills/ (ואת commands/) בכל רמה (לצד .grok/) ועובר על כל ספרייה בין ספריית העבודה לשורש המאגר.

קבצי *.md שטוחים תחת ספריית commands/ הופכים לפקודות slash שהמשתמש יכול להפעיל (שם הקובץ בלי הסיומת = שם הפקודה), בהתאם לפריסת הפקודות המותאמות מדור קודם של Claude Code.

גילוי כישורים ופקודות לא משתמש ב-.gitignore. נתיבים תחת שורשי כישורים מוכרים (.grok/, .agents/, .claude/, .cursor/) נטענים תמיד כשהם קיימים בדיסק. צוותים לעתים קרובות מתעלמים מ-.claude/** כהגדרה מקומית בלבד, ועדיין מצפים שפקודות פרויקט בסגנון /frontend יעבדו. כדי להסתיר כישור, השתמשו ב-[skills] ignore בהגדרות (לא בכללי התעלמות של המאגר).

Grok סורק את ספריות הכישורים של Claude ושל Cursor כברירת מחדל. כדי להפסיק לסרוק ספק, הגדירו את תא ה-skills שלו ל-false תחת [compat.cursor] או [compat.claude] ב-~/.grok/config.toml, או הגדירו את משתנה הסביבה GROK_CURSOR_SKILLS_ENABLED או GROK_CLAUDE_SKILLS_ENABLED ל-false. ראו הגדרות לפרטים. Grok תמיד מסנן כישורי ברירת מחדל ידועים שמגיעים עם הספק (כמו shell, canvas ו-statusline של Cursor), בלי קשר להגדרות האלה.

#ספריות כישורים נוספות

הוסיפו ספריות, אל תכללו נתיבים, או השביתו כישורים בודדים דרך [skills] ב-~/.grok/config.toml:

[skills]
paths = ["~/my-team-skills"]          # Additional directories to scan
ignore = ["~/my-team-skills/wip"]     # Paths to exclude (hidden entirely)
disabled = ["wip-skill"]              # Skill names to keep listed but inactive

כל רשומה ב-paths היא קובץ SKILL.md או ספרייה ש-Grok עובר עליה רקורסיבית. ignore מסתיר כישור לחלוטין. disabled משאיר אותו ברשימה אבל מוציא אותו מהנחיית המערכת ומההפעלה. paths ו-ignore מקבלים נתיבי מערכת קבצים ותומכים בהרחבת ~. disabled מקבל שמות כישורים. כש-SKILL.md של כישור הוא symlink, ignore מתאים לתיקייה שמחזיקה את הקישור, לא ליעד הקישור, כך שהתעלמות מאחת משתי תיקיות שמקשרות לאותו SKILL.md עדיין מציגה את הכישור מהאחרת.

[paths] extra_skill_dirs נכתב על ידי /import-claude. הוא לא מזריק כישורים. שימו ספריות נוספות ב-[skills] paths.

#יצירת כישור

#מבנה ספריות

כל כישור נמצא בספרייה משלו עם קובץ SKILL.md:

~/.grok/skills/
  commit/
    SKILL.md
  review-pr/
    SKILL.md
  deploy/
    SKILL.md

#פורמט SKILL.md

לקובץ כישור יש YAML frontmatter ואחריו הוראות markdown:

---
name: commit
description: Create well-formatted git commits following conventional commit standards. Use when the user wants to commit changes or asks for /commit.
---

# Git Commit Skill

Review staged changes and create a commit with a clear, conventional message.

## Steps

1. Run `git diff --staged` to see changes
2. Summarize what changed and why
3. Create commit message following conventional commits format
4. Run `git commit -m "..."` with the message

#שדות frontmatter ליבה

כתבו description ספציפי. הוא קובע מתי Grok מפעיל את הכישור אוטומטית. ציינו את ביטויי ההפעלה ואת מקרי השימוש.

#שדות frontmatter אופציונליים

מפתחות frontmatter מרובי מילים משתמשים ב-kebab-case (מפתחות של מילה אחת כמו model נכתבים כפי שהם).

#יצירת כישורים עם /create-skill

הפקודה /create-skill מלווה אתכם בבניית כישור חדש באופן אינטראקטיבי. Grok שואל מה אתם רוצים, מנסח את הקבצים, וכותב אותם לדיסק.

#איך זה עובד

כשמריצים את /create-skill, Grok:

1. אוסף דרישות. Grok מבקש את שם הכישור, את ההיקף לשמירה, ותיאור של תהליך העבודה שרוצים לתעד. השתמשו בשם עם אותיות קטנות, ספרות ומקפים (2-64 תווים, שמתחיל ומסתיים באות או בספרה).

2. מנסח את התיאור. Grok כותב description שמציין מה הכישור עושה, את הביטויים שמפעילים אותו, ואת שם פקודת ה-slash. אתם מאשרים או עורכים את הטיוטה לפני שממשיכים.

3. יוצר את ספריית הכישור. Grok יוצר את הספרייה <scope>/.grok/skills/<name>/, ובנוסף תת-ספריות scripts/ או references/ כשהכישור צריך אותן.

4. כותב את SKILL.md. Grok כותב את ה-frontmatter (name ו-description) וגוף markdown של הוראות, יחד עם כל קבצי העזר.

5. מאמת ומאשר. Grok קורא את הקובץ בחזרה, מאשר שהוא נכתב נכון, ואומר לכם איך להריץ את הכישור.

#בחירת היקף

Grok שואל איפה לשמור את הכישור:

• פרויקט (<repo_root>/.grok/skills/<name>/): זמין רק במאגר הזה ואפשר לשתף אותו עם חברי צוות דרך בקרת גרסאות. Grok ממליץ על ההיקף הזה בתוך מאגר git.
• משתמש (~/.grok/skills/<name>/): זמין בכל הפרויקטים שלכם.

כדי להפיץ כישור לצוות שלם או לארגון, ארזו אותו בתוסף ופרסמו אותו דרך marketplace. ראו יצירת marketplace משלכם והפצה בארגון.

הכישור החדש מופיע בתפריט ה-slash בתוך כמה שניות, כי Grok טוען מחדש כישורים כשקובצים משתנים בדיסק.

#שימוש בכישורים

#הרצת כישור לפי שם

כל כישור הוא פקודת slash שנקראת על שם הכישור. מריצים אחת על ידי הקלדת השם:

/commit              # Runs the "commit" skill
/review-pr           # Runs the "review-pr" skill

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

/commit fix the build

Grok לא מריץ פקודות מעטפת שנכתבו בתוך גוף כישור או פקודה. !`git status` בגוף לא מריץ כלום ומגיע למודל כטקסט מילולי. כדי להשתמש בפלט של פקודה, הוסיפו צעד שאומר ל-Grok להריץ את הפקודה, כך שהיא עוברת בבדיקת ההרשאות הרגילה.

כדי לעיין בכישורים, הקלידו / כדי לפתוח את תפריט פקודות ה-slash. Grok מציג כל פקודה מובנית וכל כישור ומסנן אותם תוך כדי הקלדה. כדי לרשום כישורים משורת הפקודה, הריצו grok inspect (ראו צפייה בפרטי כישור).

#שמות מלאים

כששם כישור מתנגש עם כישור אחר או עם פקודה מובנית, Grok שומר את שניהם ניתנים להפעלה. המובנית שומרת את השם החשוף (/login, /compact, …). הכישור מוצג תחת שם מלא עם קידומת של ההיקף: local:, repo:, user:, או שם התוסף:

/local:commit        # The "commit" skill from ./.grok/skills/
/user:commit         # The "commit" skill from ~/.grok/skills/
/acme:login          # A plugin skill named "login" (built-in /login is unchanged)

הקלדת /login בתפריט ה-slash מציגה את שתי השורות, עם תג built-in או skill מיושר לימין כדי שאפשר להבדיל ביניהן. שנו את שם הכישור (או את הספרייה שלו) אם אתם רוצים את /name החשוף לכישור.

grok inspect מסמן כישורים מתנגשים עם [collides with /login → /acme:login].

#הפעלה אוטומטית

Grok יכול להפעיל כישור בעצמו כשהוא מזהה משימה רלוונטית. Grok מתאים את ההנחיה שלכם לשדות description ו-when-to-use של הכישור, אז כתבו את שניהם כך שיתארו את מצב ההפעלה.

לדוגמה, אם התיאור של כישור אומר "Use when the user wants to commit changes", אז האמירה "commit my changes" יכולה להפעיל את הכישור אוטומטית. כדי לדרוש פקודת slash מפורשת ולמנוע הפעלה אוטומטית, הגדירו disable-model-invocation: true ב-frontmatter.

#צפייה בפרטי כישור

הריצו grok inspect כדי לראות כל כישור ש-Grok מגלה, יחד עם שאר ההגדרות:

grok inspect          # Human-readable summary
grok inspect --json   # Machine-readable report

בפלט הקריא לבני אדם, מקטע ה-Skills מציג את השם של כל כישור ואת המקור שלו: project, user, bundled, config (רשומת [skills].paths), server (כישורים שסונכרנו מחנות הכישורים בסביבות עבודה מנוהלות), או plugin: <name>. Grok מסמן כל כישור שהושבת דרך [skills].disabled או ממשטח ספק מושבת בתג [disabled].

הדוח מכבד את הגדרות [skills] שלכם באותו אופן כמו סשן חי: כישורים מ-paths מופיעים ברשימה, כישורים תחת קידומת ignore מוסתרים, וכישורים ששמם ב-disabled נשארים ברשימה אבל מסומנים [disabled].

דוח --json כולל את הפירוט המלא של כל כישור: name, description, source (עם הנתיב לקובץ SKILL.md), ודגל userInvocable. כישורים ששם ה-slash החשוף שלהם שנוי במחלוקת, על ידי פקודה מובנית או על ידי כישור אחר, כוללים גם collidesWith (השם השנוי במחלוקת) ו-invocableAs (הפקודה המלאה להקלדה).

#כישורים מובנים וכישורי תוספים

Grok מפיץ כישורי פלטפורמה בנפרד מהכישורים האישיים שלכם. כישורים מובנים נשמרים במטמון תחת ~/.grok/bundled/skills/. Grok אף פעם לא כותב אותם אל ~/.grok/skills/. כישור מקומי, של מאגר, או של משתמש באותו שם דורס את העותק המובנה. grok inspect מתייג כל הגדרה לפי המקור בפועל. (כישור תוסף באותו שם לא דורס כישור מקורי. הוא נשאר זמין תחת הצורה המלאה plugin:name.)

כישורים יכולים להגיע גם מתוספים. כשמתקינים תוסף שכולל כישורים, הם מופיעים לצד כישורי המשתמש והפרויקט. grok inspect מתייג כל כישור שמגיע מתוסף עם המקור plugin: <name>.

ראו את מדריך התוספים לעוד על התקנת תוספים שמספקים כישורים.

#שיטות עבודה מומלצות

1. כתבו תיאורים ספציפיים. התיאור מניע הפעלה אוטומטית. "Create git commits" מעורפל מדי. "Create well-formatted git commits following conventional commit standards. Use when the user wants to commit changes or asks for /commit." עובד טוב יותר.

2. כללו צעדים קונקרטיים. כישורים עובדים הכי טוב כשהם נותנים ל-Grok הליך ברור ומסודר לעקוב אחריו.

3. הפנו לכלים לפי שם. כשכישור נשען על כלים מסוימים (כמו run_terminal_cmd או search_replace), ציינו אותם כדי שהמודל ידע במה להשתמש.

4. שמרו על כישורים ממוקדים. כתבו כישור אחד לכל תהליך עבודה. כישור "deploy" וכישור "rollback" עובדים טוב יותר מכישור יחיד "deploy-and-rollback".

5. נהלו כישורי פרויקט בבקרת גרסאות. בצעו commit ל-.grok/skills/ במאגר כדי שכל הצוות ייהנה. כישורי משתמש ב-~/.grok/skills/ נשארים אישיים ולא משותפים.

6. בדקו על ידי הרצה. הפעילו את /name ואשרו שהכישור עובד לפני שאתם מסתמכים על הפעלה אוטומטית.

7. שמרו את הגוף מתחת לתקרת קריאת הקובץ. Grok משלב לכל היותר את 25,000 הטוקנים הראשונים של גוף כישור (אותה תקרה כמו read_file). שימו חומר עזר ארוך בקבצים אחים ואמרו ל-Grok לקרוא אותם עם היסט שורות ומגבלה.