בונים פלאגין משלכם: הסקילים, הסוכנים וההוקים שלכם בחבילה אחת

📘 מדריך מעשי🎬 פרק 42⏱️ 7 דקות קריאה🗓️ עודכן 12.11.2026
מדריכים מעשיים · הדרכות קלוד מ-0 ל-100
בונים פלאגין משלכם: הסקילים, הסוכנים וההוקים שלכם בחבילה אחת

🎬 פרק 42 בסדרה הדרכות קלוד מ-0 ל-100

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

במדריך הזה:

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

1מה זה פלאגין

לפי התיעוד, פלאגין הוא תיקייה אחת שאורזת יחד כמה סוגי כלים. במקור: "A plugin is a directory of skills, agents, hooks, and MCP servers".

מה אפשר לארוזאיפה זה יושב בפלאגיןראינו בפרק
סקיליםskills/<שם>/SKILL.md28
סוכניםagents/<שם>.md31
הוקיםhooks/hooks.json30
חיבורים (MCP).mcp.json29

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

2מתי בונים פלאגין, ומתי לא

לא כל הגדרה צריכה להפוך לפלאגין. לפי התיעוד:

  • כל עוד ההגדרות בתיקייה .claude משרתות פרויקט אחד, או רק אתכם, משאירים אותן כמו שהן. במקור: "Keep that standalone setup while it serves one project or only you."
  • בונים פלאגין כשרוצים לשתף עם הצוות, להתקין בכמה פרויקטים, או לפרסם גרסאות. במקור: "Make a plugin when you want to share the setup with teammates, install it in several projects, or publish versioned releases."
הגדרות רגילות (.claude)פלאגין
איפה עובדבפרויקט אחדבכל פרויקט שמתקינים בו
שם של סקיל/check-order/flower-tools:check-order
איך משתפיםמעתיקים קבצים בידמעבירים תיקייה אחת ומתקינים

3מה יש בתוך פלאגין

ככה נראה הפלאגין שנבנה בהדגמה:

flower-tools/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── check-order/
│       └── SKILL.md
├── agents/
│   └── site-checker.md
└── hooks/
    ├── hooks.json
    ├── protect-spec.js
    ├── notify-done.js
    └── notify-done.ps1
  • plugin.json הוא קובץ קטן עם השם, הגרסה והתיאור של הפלאגין. לפי התיעוד, רק השם הוא חובה.
  • ולידו תיקייה לכל סוג: סקילים, סוכנים והוקים.
חשוב: בתוך התיקייה .claude-plugin שמים רק את plugin.json. לפי התיעוד, כלים שנשמרים שם לא נטענים. את skills, agents ו-hooks שמים ליד התיקייה הזו, לא בתוכה.

ודבר אחד משתנה בשמות: לכל סקיל ולכל סוכן מצטרף שם הפלאגין, לפני השם שלו. הסקיל check-order נקרא עכשיו /flower-tools:check-order, והסוכן site-checker נקרא flower-tools:site-checker.

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

4הופכים כלים קיימים לפלאגין

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

  1. יוצרים תיקייה לפלאגין, ובתוכה .claude-plugin/plugin.json עם השם שלו.
  2. מעתיקים לתוכה את התיקיות skills ו-agents.
  3. מעתיקים את ההוקים מקובץ ההגדרות (.claude/settings.json) לקובץ hooks/hooks.json בפלאגין.
  4. בודקים שהפלאגין עובד, ורק אז מוחקים את המקור.
שימו לב, זו המלכודת: כל עוד המקור נשאר ב-.claude, הוא ממשיך לעבוד ליד העותק שבפלאגין. סקיל יופיע פעמיים, בשני שמות. הוק שנמצא בשני המקומות ירוץ פעמיים בכל פעם. אצלנו, למשל, חלון "קלוד סיים" היה קופץ פעמיים. לכן, אחרי שבודקים שהפלאגין עובד, מוחקים את המקור.

5בודקים ומתקינים

  1. בדיקת תקינות. הפקודה הרשמית בודקת את המבנה ואת הקבצים:
claude plugin validate ./flower-marketplace/plugins/flower-tools --strict

כשהכול תקין, מופיע ✔ Validation passed.

  1. התקנה מחנות מקומית. כדי להתקין פלאגין מהמחשב שלכם, יוצרים "חנות" קטנה (בתיעוד: marketplace): תיקייה עם קובץ .claude-plugin/marketplace.json שמפרט את הפלאגינים שבה. אחר כך מוסיפים אותה ומתקינים ממנה:
claude plugin marketplace add ./flower-marketplace --scope project
claude plugin install flower-tools@flower-marketplace --scope project

--scope project מתקין את הפלאגין רק לפרויקט הנוכחי. בלי זה הוא מותקן לכל הפרויקטים שלכם.

  1. בדיקה שהוא פעיל. הפקודה claude plugin list מציגה את הפלאגין עם Status: ✔ enabled. שיחה חדשה טוענת אותו, ובשיחה פתוחה כותבים /reload-plugins.
טיפ: לא חייבים להקליד את הפקודות האלה בעצמכם. באפליקציה, כמו בהדגמה, אפשר פשוט לבקש מ-Claude לארוז, לבדוק ולהתקין, והוא מריץ את הפקודות בשבילכם.

6מעבירים את הפלאגין הלאה

לפי התיעוד, יש שלוש דרכים:

הדרךלמי זה מתאים
שולחים את התיקייה, או קובץ zip שלהחבר לצוות, מחשב נוסף שלכם
מוסיפים אותה לחנות משלכם (marketplace)צוות שרוצה מקום אחד לכל הכלים, עם עדכונים
מגישים אותה לחנות של Anthropicכלי שכולם יכולים להשתמש בו
שימו לב: הפקודה claude plugin marketplace add שומרת בהגדרות את הנתיב המלא של החנות במחשב שלכם. מי שמקבל את התיקייה צריך להריץ אותה מחדש במחשב שלו. Claude בדק את זה בהדגמה: הוא הדמה מחשב אחר, והרצה מחדש החליפה את הנתיב הישן בנתיב החדש.

7מה קרה בהדגמה

פתחתי שיחה חדשה באפליקציה של Claude, ונתתי את הבקשה הראשונה שבסוף המדריך. הכלים שנארזו הם אלה שבנינו בפרקים הקודמים בתיקייה של אתר חנות הפרחים: הסקיל שבודק את טופס ההזמנה (פרק 28), השמירה על מסמך האפיון וחלון "קלוד סיים" (פרק 30), והסוכן שבודק את האתר (פרק 31).

  1. קרא את התיעוד הרשמי על יצירת פלאגינים.
  2. אסף הכול לפלאגין אחד בשם flower-tools, בתוך חנות מקומית בשם flower-marketplace שבתיקיית האתר.
  3. בדיקת התקינות הרשמית עברה, גם לפלאגין וגם לחנות: ✔ Validation passed.
  4. בדק על עותק שההוקים עובדים: בתיקייה זמנית, עריכה של SPEC.md נחסמה עם ההודעה בעברית, וההוק של סוף התשובה רץ.
  5. התקין את הפלאגין רק לאתר: ✔ Successfully installed plugin: flower-tools@flower-marketplace (scope: project).
  6. מחק את המקור: את הסקיל, הסוכן וקובצי ההוקים מתוך .claude, ואת בלוק ההוקים מקובץ ההגדרות. כל אלה שמורים ב-Git, אז אפשר לשחזר.
  7. וידא שכל כלי נטען פעם אחת, בלי כפילויות.
  8. כתב קובץ README בעברית עם הוראות התקנה למי שמקבל את החבילה.

הכול לקח שמונה דקות וחצי. קבצי האתר עצמם לא השתנו. Claude עדכן עוד קובץ אחד: תהליך העבודה מפרק 35, שקורא לסוכן, עבר לשם החדש flower-tools:site-checker. בלי זה הוא היה נשבר אחרי המחיקה.

8חשוב לדעת

  • כל פלאגין פעיל עולה קצת בכל שיחה: השמות והתיאורים של הסקילים והסוכנים שלו נכנסים להקשר של Claude בכל תור. אצלנו, לפי claude plugin details, זה בערך 295 טוקנים קבועים בכל שיחה.
  • הוקים רצים בלי לשאול: הוקים של פלאגין רצים בכל שיחה שבה הוא פעיל. לפני שמתקינים פלאגין של מישהו אחר, כדאי לקרוא מה ההוקים שלו עושים (על זה דיברנו בפרק 40).
  • שמות: שם של פלאגין כתוב באותיות קטנות באנגלית, עם מקפים במקום רווחים, למשל flower-tools.
  • עריכות: פלאגין שמותקן מחנות מקומית נטען מהתיקייה עצמה. אחרי שינוי בקבצים שלו, פותחים שיחה חדשה או כותבים /reload-plugins.

בקשות להעתקה

תארוז לי לפלאגין אחד, בשם my-tools, את הסקילים, הסוכנים וההוקים שבנינו בתיקייה הזאת. תעבוד לפי התיעוד הרשמי של Claude Code על יצירת פלאגינים. תבדוק שהפלאגין תקין, ותתקין אותו לפרויקט הזה בלבד, מתוך מרקטפלייס מקומי שיושב כאן בתיקייה. אחרי שהוא מותקן, תוריד את המקור הישן, כדי ששום דבר לא ירוץ פעמיים. בסוף תסכם לי בקצרה מה נוצר ואיך מעבירים את זה למישהו אחר.

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

קיבלתי תיקיית פלאגין ממישהו אחר. תבדוק אותה עם claude plugin validate, ותסביר לי במילים פשוטות מה כל סקיל, סוכן והוק בה עושה. אל תתקין כלום עד שאאשר.

בקצרה

  • פלאגין אורז סקילים, סוכנים, הוקים וחיבורים לתיקייה אחת שאפשר להעביר.
  • בונים אותו כשרוצים לשתף עם הצוות או להשתמש בכמה פרויקטים. לפרויקט אחד, או רק בשבילכם, ההגדרות הרגילות מספיקות.
  • בתוך .claude-plugin יש רק את plugin.json, ולכל סקיל מצטרף שם הפלאגין.
  • בודקים עם claude plugin validate, ומתקינים מחנות מקומית.
  • אחרי שהפלאגין עובד, מוחקים את המקור, כדי ששום דבר לא ירוץ פעמיים.
הדמות של Claude Code לעצלנים נחה על פוף עם לפטופ וקפה

עצרו שנייה ✋

כבד עליכם? מורכב לכם? יש דרך עצלה יותר.

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

  • אתרים
  • מערכות CRM
  • סרטונים
  • מותגים
  • אפליקציות

קודם יוצרים. אחר כך לומדים.