כדי להתקין סקיל ל-Claude ב-Claude Code, מעתיקים את תיקיית הסקיל, זו שמכילה את הקובץ SKILL.md, אל ~/.claude/skills/ לכל הפרויקטים או אל .claude/skills/ בתוך פרויקט אחד. באפליקציות של Claude מעלים את אותה תיקייה כקובץ ZIP תחת Customize > Skills, ו-Codex ו-Antigravity CLI קוראים אותה מ-.agents/skills/ בתוך הפרויקט.
השלבים שלהלן נבדקו ב-18 בנובמבר 2026 מול התיעוד ש-Anthropic, OpenAI ו-Google מפרסמות, והפקודות הורצו ב-Claude Code 2.1.326. תפריטים ונתיבים משתנים, ולכן המקורות מפורטים בסוף המדריך.
מה מתקינים
סקיל הוא תיקייה. מפרט Agent Skills הפתוח דורש בה קובץ אחד, SKILL.md, ומתיר לצדו סקריפטים, מסמכי עזר ונכסים:
skill-name/
├── SKILL.md
├── scripts/
├── references/
└── assets/
SKILL.md נפתח בבלוק קצר של הגדרות בין שתי שורות ---, שבו נמצאים ה-name וה-description של הסקיל, ואחריו ההוראות שכלי ה-AI קורא. לפי המפרט, השם כתוב באותיות לטיניות קטנות, בספרות ובמקפים, וזהה לשם התיקייה.
התקנת סקיל פירושה הנחת התיקייה הזאת במקום שכלי ה-AI שלכם מחפש בו. שום דבר אינו עובר הידור. אם אינכם בטוחים שסקיל הוא הפורמט המתאים למשימה שלכם, קראו קודם את פרומפט, סקיל או תהליך עבודה.
קראו את SKILL.md ואת כל סקריפט לפני שאתם מתקינים סקיל שמישהו אחר כתב. ההוראות והסקריפטים שלו רצים עם גישה לקבצים ולחשבונות שלכם. איך בוחרים חבילת פרומפטים ל-AI לפני שקונים מפרט את הבדיקות ששווה לעשות.
מתקינים סקיל ב-Claude Code
Claude Code טוען סקילים משני מקומות שאתם שולטים בהם.
| סוג | נתיב | איפה הסקיל פועל |
|---|---|---|
| אישי | ~/.claude/skills/skill-name/SKILL.md |
כל פרויקט במחשב הזה |
| פרויקט | .claude/skills/skill-name/SKILL.md |
מאגר אחד, וכל מי שעובד בו אחרי שהתיקייה נשמרת ב-commit |
- מורידים את הסקיל ומוצאים את התיקייה שמכילה ישירות את
SKILL.md. - יוצרים את תיקיית הסקילים אם היא אינה קיימת:
mkdir -p ~/.claude/skills - מעתיקים אליה את תיקיית הסקיל:
cp -R skill-name ~/.claude/skills/ - ב-Claude Code מריצים
/skills. הסקיל אמור להופיע ברשימה. - משתמשים בו. מקלידים
/skill-name, או מתארים משימה שמתאימה לתיאור הסקיל ונותנים ל-Claude לטעון אותו.
Claude Code עוקב אחרי תיקיות הסקילים שלו, ולכן סקיל שנוסף לתיקייה שכבר הייתה קיימת מופיע בלי הפעלה מחדש. אם יצרתם את ~/.claude/skills/ או את .claude/skills/ במהלך הסשן, מריצים /reload-skills פעם אחת.
מתקינים ערכת סקילים כתוסף של Claude Code
אוספי סקילים רבים מתפרסמים כתוספים, שבהם התקנה אחת מוסיפה כמה סקילים. סקילי הדוגמה של Anthropic עצמה מותקנים כך. ב-Claude Code מריצים:
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
השורה הראשונה רושמת את המאגר כמרקטפלייס, שהוא קטלוג של תוספים. השורה השנייה פותחת את פרטי התוסף, ושם קוראים מה הוא מוסיף ובוחרים אם הוא חל על כל הפרויקטים או על מאגר אחד. סקילים שמגיעים מתוסף נושאים את שם התוסף, בצורה /plugin-name:skill-name.
כדי לעיין קודם, מריצים /plugin ופותחים את הלשונית Discover. היא מציגה את התוספים במרקטפלייס הרשמי של Anthropic, ש-Claude Code מוסיף בפעם הראשונה שמתחילים סשן אינטראקטיבי. תוסף יכול להוסיף גם hooks ושרתי MCP, והם רצים במחשב שלכם, ולכן קראו את הפרטים לפני ההתקנה.
מתקינים סקיל באפליקציות של Claude
ב-claude.ai ובאפליקציה של Claude למחשב מעלים סקיל כקובץ ZIP. מפעילים את "Code execution and file creation" תחת Settings > Capabilities. בתוכניות Team ו-Enterprise ההגדרה הזאת בשליטת בעל החשבון. מרכז העזרה של Anthropic מונה סקילים בתוכניות Free, Pro, Max, Ultra, Team ו-Enterprise, ואילו אחד מדפי התיעוד שלה מונה רק את התוכניות בתשלום. אם אתם בתוכנית Free ואינכם רואים דף Skills, זו כנראה הסיבה.
- דוחסים את הסקיל מהתיקייה שמעליו, כך שתיקיית הסקיל היא הרמה העליונה בארכיון:
zip -r skill-name.zip skill-name/ - בודקים את הארכיון:
unzip -l skill-name.zip. כל שורה צריכה להתחיל ב-skill-name/. אםSKILL.mdמופיע בלי הקידומת הזאת, דחסתם את התוכן ולא את התיקייה. - ב-Claude פותחים Customize > Skills.
- לוחצים על הכפתור "+", אחר כך "Create skill", אחר כך "Upload a skill", ובוחרים את קובץ ה-ZIP.
- מוצאים את הסקיל ברשימה ומפעילים אותו.
באותו דף יש קטלוג של סקילים מוכנים: לוחצים על "+", אחר כך על "Browse skills", ואז על "Add" ליד הסקיל הרצוי.
סקילים שהפעלתם בחשבון Claude שלכם נטענים גם ב-Claude Code כשנכנסים עם אותו חשבון, בגרסה 2.1.273 ואילך. הפקודה /skills מציגה אותם תחת "claude.ai sync". הסנכרון חד-כיווני: תיקייה שהעתקתם אל ~/.claude/skills/ אינה מועלית לחשבון שלכם.
משתמשים באותה תיקייה ב-Codex וב-Antigravity CLI
Codex ו-Antigravity CLI (המחליף של Gemini CLI מבית Google) פועלים לפי אותו מפרט, ולכן התיקייה אינה צריכה המרה. סקיל שנשען על יכולות שיש רק ב-Claude Code עשוי לעשות פחות בכלי אחר.
| כלי | כל פרויקט | פרויקט אחד | בודקים שהוא נטען |
|---|---|---|---|
| Claude Code | ~/.claude/skills/ |
.claude/skills/ |
/skills |
| Codex | ~/.agents/skills/ |
.agents/skills/ |
/skills, או מקלידים $ כדי לבחור סקיל |
| Antigravity CLI | ~/.gemini/config/skills/ |
.agents/skills/ |
/skills |
.agents/skills/ בתוך הפרויקט היא התיקייה ששני הכלים, Codex ו-Antigravity CLI, קוראים. התיעוד של Claude Code מציין רק את המיקומים של .claude, אבל הוא עוקב אחרי קישורים סימבוליים, כמו Codex. לכן אפשר לשמור עותק אחד ולהפנות אליו את Claude Code:
mkdir -p ~/.agents/skills ~/.claude/skills
cp -R skill-name ~/.agents/skills/
ln -s ~/.agents/skills/skill-name ~/.claude/skills/skill-name
סקיל שקושר כך נטען ורץ ב-Claude Code בבדיקת המדריך.
Codex מוצא סקילים חדשים בעצמו, והתיעוד שלו אומר להפעיל אותו מחדש אם אחד מהם אינו מופיע.
דוגמה מעשית עם סקיל של נאקו
המוצרים של נאקו הם תיקיות סקיל שמגיעות עם מתקין, כך שצעד ההעתקה הוא פקודה אחת. זו הרצה אמיתית של מדריך לכתיבת פרומפטים החינמי, שנעשתה ב-18 בנובמבר 2026 מתיקיית product שבהורדה. הפקודה הראשונה מציגה תצוגה מקדימה של ההתקנה ואינה כותבת דבר:
python3 install.py --host claude --ids kit-prompt-writing-system --dry-run
התשובה, כשתיקיית הבית מקוצרת כאן ל-~:
{
"action": "preview",
"host": "claude",
"destination": "~/.claude/skills",
"products": [
"kit-prompt-writing-system"
]
}
בהרצה בלי --dry-run, המתקין העתיק ליעד תיקייה אחת בשם kit-prompt-writing-system. התיקייה הכילה את SKILL.md, את GUIDE.md, את references ואת tools. עם --host codex התצוגה המקדימה ציינה את ~/.agents/skills כיעד, ועם --host gemini היא ציינה את ~/.gemini/skills. המתקין דורש Python 3.9 ואילך.
בנאקו יש יותר מ-123 מוצרים, ולכל אחד יש קובצי התקנה ל-Claude Code, ל-Codex ול-Antigravity CLI. מתחילים עם הסקילים, חבילות הפרומפטים ותהליכי העבודה החינמיים, או עוברים על כל קטגוריית הסקילים. אחר כך התוסף של נאקו מאפשר לכלי AI מחובר לרשום את המוצרים שבבעלותכם ולהביא את הקבצים שלהם.
מה בודקים כשסקיל אינו נטען
עוברים על הרשימה לפי הסדר. שלוש הסיבות הראשונות מסבירות את רוב הכשלים.
| מה אתם רואים | סיבה סבירה | מה עושים |
|---|---|---|
הסקיל חסר ב-/skills |
התיקייה עמוקה ברמה אחת מדי, כמו skills/skill-name/skill-name/SKILL.md, מצב נפוץ אחרי חילוץ מארכיון |
מזיזים את התיקייה כך ש-SKILL.md יהיה ישירות בתוך skills/skill-name/ |
הסקיל חסר ב-/skills |
תיקיית הסקילים נוצרה במהלך הסשן הזה | מריצים /reload-skills ב-Claude Code, או מפעילים את הכלי מחדש |
הסקיל חסר ב-/skills |
הקובץ אינו נקרא SKILL.md, או שהתיקייה נקראת synced או anthropic-skills, שני שמות שמורים ל-Claude Code |
משנים את שם הקובץ או התיקייה |
/skill-name עובד, אבל Claude לעולם אינו בוחר את הסקיל בעצמו |
בלוק ההגדרות אינו נקרא כראוי, ולכן התיאור הולך לאיבוד | מריצים claude plugin validate ~/.claude/skills ומתקנים את השגיאה שדווחה |
| אותו מצב, וההגדרות תקינות | בתיאור חסרות המילים שבהן אתם משתמשים, או שהסקיל מגדיר disable-model-invocation: true |
מציינים את שם הסקיל בבקשה, או עורכים את התיאור |
| סקיל עבד ואז הפסיק להיבחר | מותקנים סקילים רבים, והתיאורים של חלקם נחתכים כדי להיכנס | מריצים /doctor ב-Claude Code ומסירים סקילים שאינכם משתמשים בהם |
| הסקיל חסר ב-Cowork או בסשן בענן | הסשנים האלה אינם קוראים את ~/.claude/skills/ |
מעלים את הסקיל לחשבון Claude שלכם |
| אפליקציות Claude: אין דף Skills, או שהסקילים אפורים | Code execution כבוי | מפעילים אותו תחת Settings > Capabilities, או פונים לבעל החשבון בארגון שלכם |
| אפליקציות Claude: ההעלאה נכשלת | קובץ ה-ZIP גדול מדי, שם התיקייה שונה משם הסקיל, SKILL.md חסר, או שיש בשם תווים לא תקינים |
מתקנים את התיקייה ודוחסים אותה שוב מהתיקייה שמעליה |
| Codex אינו מציג את הסקיל ברשימה | Codex לא סרק מחדש, או שהסקיל מושבת ב-~/.codex/config.toml |
מפעילים את Codex מחדש ובודקים את קובץ ההגדרות |
| Antigravity CLI אינו מציג את הסקיל ברשימה | הרשימה ישנה | מריצים /skills reload ואחר כך /skills |
claude plugin validate דורש Claude Code 2.1.233 ואילך. על תיקייה עם סקיל תקין אחד הוא הדפיס "Validation passed". כשנוסף סקיל שני עם בלוק הגדרות שבור, הוא ציין את SKILL.md של אותו סקיל ודיווח "YAML frontmatter failed to parse".
כששם סקיל זהה קיים בשני מקומות, הכלי בוחר באחד מהם. ב-Claude Code סקיל אישי גובר על סקיל פרויקט באותו שם.
לפני שסוגרים את הטרמינל
SKILL.mdנמצא ישירות בתוךskills/skill-name/.- שם התיקייה זהה ל-
nameשב-SKILL.md. - קראתם את ההוראות ואת כל סקריפט.
/skillsמציג את הסקיל.- בקשה אמיתית אחת גרמה לכלי להשתמש בסקיל.
שאלות נפוצות
איפה נשמרים סקילים של Claude?
Claude Code קורא סקילים אישיים מהתיקייה ~/.claude/skills/ וסקילים של פרויקט מ-.claude/skills/ בתוך המאגר. כל סקיל נמצא בתיקייה משלו עם קובץ SKILL.md. סקילים שמעלים באפליקציות של Claude נשמרים בחשבון Claude שלכם ומופיעים תחת Customize > Skills.
האם סקילים של Claude עובדים ב-Codex וב-Antigravity CLI?
כן. Claude Code, Codex ו-Antigravity CLI קוראים כולם את הפורמט הפתוח Agent Skills, ולכן אותה תיקייה נטענת בכל אחד מהם. Codex ו-Antigravity CLI קוראים שניהם את .agents/skills/ בתוך הפרויקט, ו-Antigravity CLI קורא סקילים לכל הפרויקטים מ-~/.gemini/config/skills/. סקיל שנשען על יכולות שיש רק ב-Claude Code עשוי לעשות פחות בכלי אחר.
איך מתקינים סקיל של Claude מ-GitHub?
מורידים או משכפלים את המאגר, מוצאים את התיקייה שמכילה את SKILL.md ומעתיקים אותה אל ~/.claude/skills/. אם המאגר הוא מרקטפלייס של תוספים, מריצים ב-Claude Code את /plugin marketplace add ואחריו שם הבעלים ושם המאגר, ואז מתקינים את התוסף הרצוי.
האם צריך להפעיל מחדש את Claude Code אחרי התקנת סקיל?
בדרך כלל לא. Claude Code עוקב אחרי תיקיות הסקילים שלו ומזהה סקיל חדש או סקיל שהשתנה במהלך הסשן. היוצא מן הכלל הוא תיקיית סקילים שלא הייתה קיימת כשהסשן התחיל. במקרה כזה מריצים /reload-skills פעם אחת, והסקיל מופיע כשמריצים /skills.
האם צריך תוכנית בתשלום של Claude כדי להשתמש בסקילים?
סקילים ב-Claude Code הם תיקיות במחשב שלכם, והתיעוד שלו אינו קובע להם דרישת תוכנית. באפליקציות של Claude, מרכז העזרה של Anthropic מונה סקילים בתוכניות Free, Pro, Max, Ultra, Team ו-Enterprise, כשהרצת קוד מופעלת, ואילו אחד מדפי התיעוד שלה מציין רק את התוכניות בתשלום.
מקורות וקריאה נוספת (8)
- Claude Code documentation: Extend Claude with skills
- Claude Code documentation: Install and manage plugins
- Claude Help Center: Use skills in Claude
- Claude documentation: Skills overview
- OpenAI documentation for ChatGPT and Codex: Build skills
- Google Antigravity documentation: Agent skills
- Agent Skills specification
- Knacco Prompt Writing Guide: requirements and contents


