# איך בונים skill של Claude לעבודה עם שַׁגֵּר: SKILL.md אחד שמלמד את הסוכן להפיץ נכון

_2026-09-22 · מדריך לבניית Agent Skill לְשַׁגֵּר: מבנה התיקייה, השדות name וגם description בקובץ SKILL.md, איפה הוא יושב בכלי Claude Code ובאתר claude.ai, ומה לכתוב בו כדי שיעבוד נכון._

skill של Claude לְשַׁגֵּר הוא תיקייה עם קובץ `SKILL.md`, שבראשו frontmatter עם `name` וגם `description`, ובגוף שלו הנחיות: באיזה סדר להפעיל את הכלים של שַׁגֵּר, איך לנסח כיתוב שונה לכל חשבון, ומתי לעצור ולחכות לאדם. בכלי Claude Code שמים את התיקייה בנתיב `~/.claude/skills/` לשימוש אישי או בנתיב `.claude/skills/` בתוך הריפו לשימוש הצוות. באתר claude.ai מעלים אותה כקובץ ZIP. הסקיל לא מחליף את החיבור לְשַׁגֵּר. הוא יושב מעליו ומלמד את הסוכן להשתמש בו כמו שאתם הייתם משתמשים.

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

## איך בנוי skill?

לפי [מדריך יצירת skills של Anthropic](https://claude.com/docs/skills/how-to), skill הוא תיקייה ששמה זהה לשם של הסקיל עצמו, והקובץ היחיד שחובה בה הוא `SKILL.md`. כל השאר אופציונלי:

```text
shager-distribution/
├── SKILL.md
├── references/
│   └── caption-rules-he.md
└── assets/
    └── post-brief-template.md
```

בתיקייה `references/` שמים מסמכים ארוכים שהסוכן קורא רק כשצריך, למשל כללי טון בעברית לכל לקוח. בתיקייה `assets/` שמים תבניות שהוא ממלא. את `SKILL.md` כדאי להשאיר מתחת לגבול של 500 שורות, וזו גם ההמלצה הרשמית.

### מה מותר בשדות name וגם description?

[סקירת Agent Skills בתיעוד של Anthropic](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) מגדירה את הכללים:

| שדה | כללים |
|---|---|
| `name` | עד 64 תווים, רק אותיות קטנות באנגלית, ספרות ומקפים. בלי המילים השמורות anthropic וגם claude. חייב להתאים לשם התיקייה |
| `description` | לא ריק, עד 1,024 תווים. חייב להגיד גם מה הסקיל עושה וגם מתי להשתמש בו |

הכלל על המילים השמורות הוא הסיבה שהסקיל שלנו נקרא `shager-distribution` ולא משהו עם claude בשם. שדה description הוא החלק החשוב ביותר: זה הדבר היחיד שהמודל Claude קורא לפני שהוא מחליט לטעון את הסקיל. אם הוא לא מזכיר את המילים שאנשים באמת כותבים, כמו "להפיץ", "לתזמן", "עמודים", "ריל", הסקיל פשוט לא ייטען.

## SKILL.md מלא לְשַׁגֵּר

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

```markdown
---
name: shager-distribution
description: Distribute posts, Reels and Shorts to many Facebook Pages, Instagram accounts and YouTube channels through Shager. Use when the user asks to publish, schedule, distribute or prepare drafts for several client accounts, or asks for clicks per account.
---

# Distributing content with Shager

Shager is connected as the MCP server "shager" (https://app.shager.ai/api/mcp).

## Order of work
1. whoami, then list_workspaces. Confirm the client workspace by name.
2. list_channels and list_groups. Prefer group_ids over long channel lists.
3. If no channels: create_connect_link and give the link to the human.
4. upload_media_from_url. For video always pass width, height, duration_ms.
5. create_post as a DRAFT:
   - per_channel with a different caption for every account
   - cta_url for the landing page, first_comment inviting the click
   - campaign for utm_campaign, label for an internal name
6. Show the human a short table: account, first line of caption, format.
7. Only after explicit approval: request_approval or schedule_post.

## Rules
- Never schedule or publish without an explicit instruction in this chat.
- schedule_at is ISO 8601 with offset, e.g. 2026-10-20T09:00:00+03:00.
- Keep stagger_seconds at the default [30, 90] unless told otherwise.
- On error code sandbox_unclaimed: stop and ask the human to claim.
- On error code rejected: read the message, fix, retry once.
- Hebrew captions follow references/caption-rules-he.md.
```

שימו לב למה שאין בקובץ: מפתח API. התיעוד של Anthropic אומר במפורש לא לשים מפתחות או סיסמאות בשום מקום בתוך הסקיל, כי כל מי שמקבל את הסקיל מקבל את כל הקבצים שלו. ההרשאה מגיעה מהחיבור לְשַׁגֵּר, והסקיל רק מסביר איך להשתמש בו.

### קובץ ההפניה לעברית

`references/caption-rules-he.md` הוא המקום לדברים שמשתנים מלקוח ללקוח: פנייה בלשון רבים או ביחיד, האם מותר סלנג, מה עושים עם מגדר, אורך מקסימלי לפתיח, ואיך משלבים את שם העיר בכל סניף. ככל שהקובץ ספציפי יותר, הטיוטות טובות יותר. דוגמה אחת של פוסט טוב ודוגמה אחת של פוסט שנפסל, עם הסבר קצר למה, שוות יותר מעמוד שלם של עקרונות כלליים. על הנושא הזה בהרחבה כתבנו ב[מדריך על גיוון כיתובים לכל חשבון עם AI](/blog/caption-variation-per-account-with-ai).

## איפה הסקיל יושב בכל כלי

| סביבה | מיקום | מי רואה אותו |
|---|---|---|
| Claude Code, אישי | `~/.claude/skills/shager-distribution/SKILL.md` | אתם, בכל פרויקט |
| Claude Code, פרויקט | `.claude/skills/shager-distribution/SKILL.md` | כל מי שעובד בריפו |
| claude.ai ואפליקציית Desktop | העלאה כקובץ ZIP והפעלה תחת Customize ואז Skills | המשתמש שהעלה |

בכלי Claude Code, לפי [התיעוד על skills](https://code.claude.com/docs/en/skills), אפשר להפעיל skill ידנית עם `/shager-distribution`, או לתת למודל Claude לטעון אותו לבד כשהבקשה מתאימה לשדה description.

באתר claude.ai צריך לארוז נכון. קובץ ZIP חייב להכיל את התיקייה עצמה ברמה העליונה, כלומר `shager-distribution/SKILL.md` בתוך הארכיון, ולא `SKILL.md` לבד. הפקודה הנכונה, מתוך התיקייה שמכילה את הסקיל:

```bash
zip -r shager-distribution.zip shager-distribution/
unzip -l shager-distribution.zip
```

יש גם אפשרות להעלות skills דרך ממשק Skills API של Anthropic, אבל שם הם רצים בסביבה בלי גישה לרשת, ולכן לרוב זה פחות רלוונטי לעבודה מול שַׁגֵּר. הסקילים לא מסתנכרנים בין הסביבות. skill שהעליתם לאתר claude.ai לא יופיע בכלי Claude Code, ולהפך. ובנוסף, כדי שהסקיל יעבוד באתר claude.ai, צריך שגם שַׁגֵּר יהיה מחובר שם כמחבר, עם כל המגבלות שתיארנו במדריך [על Claude Desktop](/blog/connect-shager-to-claude-desktop).

### שדה שעובד רק בכלי Claude Code

לכלי Claude Code יש שדות frontmatter נוספים מעבר למפרט הפתוח. השימושי ביותר כאן הוא `disable-model-invocation: true`, שמונע מהמודל Claude לטעון את הסקיל לבד ומשאיר אותו רק להפעלה ידנית. זה מתאים לסקיל שמתזמן פוסטים בפועל. אבל לפי התיעוד, באתר claude.ai ובממשק Skills API מותרים רק שדות המפרט, ושדה לא מוכר יגרום לשגיאה בהעלאה. אם אתם רוצים skill אחד לשתי הסביבות, השאירו רק `name` וגם `description`.

## איך בודקים שה skill עובד

שלושה מבחנים פשוטים:

1. **האם הוא נטען?** כותבים בקשה רגילה, למשל "תכין לי טיוטת ריל לסניפים בצפון על מבצע הסתיו", ובודקים שהסוכן פועל לפי סדר העבודה. אם לא, משפרים את שדה description עם המילים שהשתמשתם בהן.
2. **האם הוא עוצר?** מבקשים "תפרסם את זה" בלי לציין זמן ובלי אישור מפורש, ובודקים שהסוכן שואל לפני שהוא מתזמן.
3. **האם הניסוח באמת שונה?** פותחים את הטיוטה בְּשַׁגֵּר ומשווים שלושה חשבונות. אם הם נבדלים רק בשם העיר, צריך לחדד את קובץ ההפניה.

Anthropic מציעה גם skill בשם `skill-creator` שמריץ את הסקיל שלכם על בקשות בדיקה ומשווה תוצאות עם ובלי, וזה שימושי כשרוצים לדעת אם שינוי בשדה description באמת עזר.

## נקודת התחלה מוכנה

אם לא רוצים להתחיל מאפס, לְשַׁגֵּר יש skill רשמי בכתובת `https://shager.ai/skills/shager/SKILL.md`. הוא קצר, מכסה את סדר הפעולות ואת כללי הבטיחות הבסיסיים, ואפשר להעתיק אותו ולהוסיף מעליו את הכללים של הסוכנות שלכם. את כל דרכי הגישה לְשַׁגֵּר, כולל קובץ הסקיל, תמצאו גם ב[עמוד הסוכנים](/agents).

הצעד הבא אחרי skill שעובד הוא להפוך אותו לשגרה: skill שרץ כל שבוע, מכין את כל הטיוטות של השבוע ושולח לאישור. את זה בדיוק בנינו במדריך [על שגרת הפצה שבועית עם skill](/blog/skill-weekly-distribution-routine).

## שאלות נפוצות

### מה ההבדל בין skill לבין חיבור MCP?

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

### אפשר לשתף skill עם כל הצוות?

בכלי Claude Code כן, על ידי שמירתו בנתיב `.claude/skills/` בתוך ריפו משותף. באתר claude.ai skills מותאמים הם אישיים, וכל אחד מעלה אותם בעצמו, אלא אם יש לכם אפשרויות שיתוף בתוכנית Team או Enterprise.

### למה הסקיל שלי לא נטען אוטומטית?

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

---
Source: https://shager.ai/blog/build-a-claude-skill-for-shager