תאימות רב-סוכנית: איך סקילס עובדים בין סוכנים

פורמט אחד, הרבה סוכנים

סקילס מבוססים על פורמט SKILL.md, תקן פתוח שכל סוכני ה-AI יכולים לקרוא ולפרש. קובץ SKILL.md הוא Markdown עם YAML frontmatter, ואין בו שום דבר ייחודי לסוכן מסוים. זה אומר שסקיל שנכתב פעם אחת יכול לעבוד בכל סוכן שתומך בפורמט.

כל סוכן שומר את הסקילס בתיקייה משלו:

• Claude Code: .claude/skills/
• Cursor: .cursor/skills/
• GitHub Copilot: .github/skills/
• Windsurf: .windsurf/skills/
• OpenCode: .opencode/skills/
• Codex: .codex/skills/

ה-CLI של Skills IL (npx skills-il add) מזהה אוטומטית אילו סוכנים מותקנים ומתקין את הסקיל בכולם.

סוגי סקילס וניידות

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

סקילס תהליך (Workflow Skills)

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

דוגמאות:

• סקיל להגשת דוח מע"מ (רצף שלבים עם בדיקות)
• סקיל לכתיבת תיעוד API (תבנית עם חוקים)
• סקיל לתרגום קוד לעברית (כללי לוקליזציה)

סקילס יכולת (Capability Skills)

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

דוגמאות:

• סקיל שמריץ סקריפטי Python לעיבוד נתונים (דורש Bash)
• סקיל שמשתמש ב-MCP לגישה לנתוני בנק ישראל (דורש MCP)
• סקיל שעורך קבצים ומריץ בדיקות (דורש כלי עריכה וטרמינל)

מה המשמעות של "נתמך" לכל סוכן

כשסקיל מציין supported_agents ב-frontmatter, המשמעות היא:

1. הסקיל נבדק ועובד בסוכן הזה
2. ההוראות תואמות ליכולות של הסוכן
3. אם הסקיל דורש כלים ספציפיים, הם זמינים בסוכן

סקיל שלא מציין supported_agents עדיין יכול לעבוד בכל סוכן, כי SKILL.md הוא פורמט אוניברסלי. אבל לא בהכרח נבדק.

כתיבת סקילס ניידים

1. תארו כוונות, לא כלים

# רע - צמוד לכלי ספציפי
Run \`eslint --fix src/\` to fix linting errors.

# טוב - מתאר כוונה
Check the source code for linting errors and fix them automatically.
The project uses ESLint; run the linter if available.

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

2. אגדו סקריפטים

אם הסקיל דורש לוגיקה מורכבת, שימו אותה בסקריפט בתיקיית scripts/:

your-skill/
├── SKILL.md
└── scripts/
    └── validate_invoice.py

## Instructions
Run the validation script to check the invoice:
\`python scripts/validate_invoice.py --input invoice.pdf\`

כך כל סוכן שיכול להריץ Python יכול להשתמש בסקיל, ללא תלות בכלים ספציפיים של סוכן מסוים.

3. ציינו דרישות במפורש

השתמשו בשדה compatibility ב-frontmatter:

compatibility: "Requires terminal access for running Python scripts"

ובגוף הסקיל, ציינו חלופות כשאפשר:

## Prerequisites
- Python 3.8+ (required for validation scripts)
- If terminal access is not available, review the validation
  rules manually in references/validation-rules.md

4. הימנעו משמות כלים ספציפיים של סוכן

# רע - מניח כלי ספציפי
Use the Bash tool to run the command.
Use the Edit tool to modify the file.

# טוב - ניטרלי
Run the command in the terminal.
Modify the file with the necessary changes.

5. ספקו חלופות

כשהסקיל דורש יכולת שלא כל סוכן תומך בה, ספקו נתיב חלופי:

## Step 3: Validate Output
If you can run scripts, execute:
\`python scripts/check_output.py\`

Otherwise, manually verify:
1. Check that all required fields are present
2. Verify date format is DD/MM/YYYY
3. Confirm totals match line items

הערות לכל סוכן

Claude Code

• תומך בכל הכלים: Bash, קריאה וכתיבה של קבצים, MCP
• רץ בטרמינל, מה שנותן לו גישה מלאה לסביבת הפיתוח
• תומך ב-allowed-tools ב-frontmatter להגבלת הרשאות
• תומך ב-skills מקומיים (.claude/skills/) ותיקיית פרויקט (.claude/skills/)
• היכולת הרחבה ביותר מבין הסוכנים לסקילס מבוססי יכולת

Cursor

• תומך ב-MCP ובעריכת קבצים מרובים
• עובד בסביבה ויזואלית (IDE), לא בטרמינל
• סקילס נטענים דרך .cursor/skills/ או Cursor Rules
• מצטיין בסקילס שמערבים עריכת קוד בקבצים מרובים
• הרצת פקודות טרמינל אפשרית דרך הטרמינל המובנה

GitHub Copilot

• תומך ב-MCP ובסקילס דרך .github/skills/
• משתלב עם תהליכי העבודה של GitHub (PRs, Issues)
• מצטיין בהשלמת קוד ובמשימות קוד קצרות
• Copilot Coding Agent יכול להריץ משימות מורכבות יותר

Windsurf

• תומך ב-MCP דרך קובץ הגדרה
• ממשק IDE עם מעבר חלק בין עבודה ידנית ל-AI
• סקילס נטענים דרך .windsurf/skills/
• תומך בהרצת פקודות ובגישה לקבצים

OpenCode

• סוכן קוד פתוח שרץ בטרמינל
• תומך בסקילס דרך .opencode/skills/
• פונקציונליות דומה ל-Claude Code עם מודלים שונים
• תומך ב-MCP

Codex

• סוכן של OpenAI שרץ בענן (sandbox)
• יכול להריץ קוד ובדיקות באופן אוטונומי
• סביבה מבודדת, אז סקילס שדורשים גישה לרשת חיצונית עשויים לא לעבוד
• מצטיין במשימות שדורשות הרצת קוד אוטונומית

רשימת בדיקה לניידות

לפני שמפרסמים סקיל, בדקו:

• ה-SKILL.md לא מזכיר שמות כלים ספציפיים של סוכן (Bash tool, Edit tool)
• הוראות מורכבות מקופסלות בסקריפטים בתיקיית scripts/
• דרישות חיצוניות מצוינות ב-compatibility
• יש נתיבים חלופיים לפעולות שלא כל סוכן תומך בהן
• supported_agents מעודכן ומשקף בדיקות בפועל
• הסקיל מתאר כוונות ("בדקו שגיאות") ולא פקודות ("הריצו eslint")

סיכום

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

קריאה נוספת

• המדריך המלא לבניית סקיל - מבנה, frontmatter והוראות
• בדיקה והפצה - איך לבדוק ולהפיץ סקילס
• מדריך התחלה מהירה - התקנה ושימוש ראשוני