המדריך המלא לבניית סקיל

מה זה סקיל?

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

• SKILL.md (חובה): הוראות ב-Markdown עם YAML frontmatter
• scripts/ (אופציונלי): קוד הרצה (Python, Bash, וכו')
• references/ (אופציונלי): תיעוד שנטען לפי הצורך
• assets/ (אופציונלי): תבניות, פונטים, אייקונים

עקרונות עיצוב ליבה

חשיפה מדורגת (Progressive Disclosure)

סקילס משתמשים במערכת שלוש רמות:

• רמה ראשונה (YAML frontmatter): תמיד נטען ל-system prompt של Claude. מספק מידע מינימלי כדי ש-Claude ידע מתי להשתמש בסקיל.
• רמה שנייה (גוף SKILL.md): נטען כש-Claude חושב שהסקיל רלוונטי למשימה. מכיל את ההוראות המלאות.
• רמה שלישית (קבצים מקושרים): קבצים נוספים בתיקיית הסקיל ש-Claude יכול לגלות לפי הצורך.

קומפוזביליות

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

ניידות

סקילס עובדים באופן זהה ב-Claude.ai, Claude Code ו-API. צרו סקיל פעם אחת והוא עובד בכל הפלטפורמות.

דרישות טכניות

מבנה הקבצים

your-skill-name/
├── SKILL.md              # חובה - קובץ הסקיל הראשי
├── scripts/              # אופציונלי - קוד הרצה
│   ├── process_data.py
│   └── validate.sh
├── references/           # אופציונלי - תיעוד
│   ├── api-guide.md
│   └── examples/
└── assets/               # אופציונלי - תבניות
    └── report-template.md

כללים קריטיים

שם SKILL.md:

• חייב להיות בדיוק SKILL.md (רגיש לאותיות גדולות/קטנות)
• אין וריאציות מקובלות (SKILL.MD, skill.md, וכו')

שם תיקיית הסקיל:

• השתמשו ב-kebab-case: notion-project-setup
• ללא רווחים: Notion Project Setup
• ללא קווים תחתונים: notion_project_setup
• ללא אותיות גדולות: NotionProjectSetup

ללא README.md:

• אל תכללו README.md בתוך תיקיית הסקיל
• כל התיעוד ב-SKILL.md או ב-references/
• בעת הפצה ב-GitHub, צרו README ברמת הריפו (מחוץ לתיקיית הסקיל)

YAML Frontmatter

ה-frontmatter הוא הדרך של Claude להחליט האם לטעון את הסקיל. חשוב לכתוב אותו נכון.

פורמט מינימלי

---
name: your-skill-name
description: What it does. Use when user asks to [specific phrases].
---

שדות חובה

name (חובה):

• kebab-case בלבד
• ללא רווחים או אותיות גדולות
• צריך להתאים לשם התיקייה

description (חובה):

• חייב לכלול שני דברים:
  • מה הסקיל עושה
  • מתי להשתמש בו (תנאי הפעלה)
• עד 1024 תווים
• ללא תגיות XML
• כללו ביטויים ספציפיים שמשתמשים עשויים להגיד

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

• license: MIT, Apache-2.0
• compatibility: דרישות סביבה (עד 500 תווים)
• metadata: שדות מותאמים אישית (author, version, mcp-server)

דוגמאות לתיאורים טובים

# טוב - ספציפי ומעשי
description: Analyzes Figma design files and generates developer
  handoff documentation. Use when user uploads .fig files, asks
  for "design specs" or "design-to-code handoff".

# טוב - כולל trigger phrases
description: Manages Linear project workflows including sprint
  planning, task creation, and status tracking. Use when user
  mentions "sprint", "Linear tasks", or "project planning".

# רע - מעורפל מדי
description: Helps with projects.

# רע - חסרי triggers
description: Creates sophisticated documentation systems.

הגבלות אבטחה

אסור ב-frontmatter:

• תגיות XML (< או >)
• סקילס עם "claude" או "anthropic" בשם (שמורים)

כתיבת הוראות אפקטיביות

מבנה מומלץ

---
name: your-skill
description: [...]
---

# Your Skill Name

## Instructions

### Step 1: [First Major Step]
Clear explanation of what happens.

Example:
python scripts/fetch_data.py --project-id PROJECT_ID
Expected output: [describe what success looks like]

## Examples

### Example 1: [common scenario]
User says: "Set up a new marketing campaign"
Actions:
1. Fetch existing campaigns via MCP
2. Create new campaign with provided parameters
Result: Campaign created with confirmation link

## Troubleshooting

### Error: [Common error message]
**Cause:** [Why it happens]
**Solution:** [How to fix]

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

היו ספציפיים ומעשיים:

# טוב
Run \`python scripts/validate.py --input {filename}\` to check data format.
If validation fails, common issues include:
- Missing required fields (add them to the CSV)
- Invalid date formats (use YYYY-MM-DD)

# רע
Validate the data before proceeding.

כללו טיפול בשגיאות:

## Common Issues

### MCP Connection Failed
If you see "Connection refused":
1. Verify MCP server is running
2. Confirm API key is valid
3. Try reconnecting

השתמשו בחשיפה מדורגת:

שמרו על SKILL.md ממוקד בהוראות הליבה. העבירו תיעוד מפורט ל-references/ וקשרו אליו.

קטגוריות שימוש נפוצות

1. יצירת מסמכים ואסטים

ליצירת פלט עקבי ואיכותי: מסמכים, מצגות, אפליקציות, עיצובים, קוד.

• תבניות סגנון ובראנד מוטמעות
• מבני תבנית לפלט עקבי
• רשימות בדיקת איכות לפני סיום

2. אוטומציה של תהליכי עבודה

לתהליכים מרובי שלבים עם מתודולוגיה עקבית.

• תהליכי עבודה שלב-אחר-שלב עם שערי אימות
• תבניות למבנים נפוצים
• לולאות שיפור איטרטיביות

3. שיפור MCP

להנחיית תהליכי עבודה שמשפרת את הגישה לכלים ש-MCP מספק.

• תיאום קריאות MCP מרובות ברצף
• הטמעת מומחיות תחום
• טיפול בשגיאות לבעיות MCP נפוצות

הגדרת קריטריוני הצלחה

מדדים כמותיים

• הסקיל מופעל ב-90% מהשאילתות הרלוונטיות
• משלים תהליך עבודה ב-X קריאות כלים
• 0 קריאות API כושלות לתהליך

מדדים איכותיים

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

הגשה לפלטפורמה

לאחר שהסקיל מוכן, הגישו אותו לבדיקת אבטחה ופרסום ב-Skills IL.