ה-CLAUDE.md של קרפטי, מוסבר: קובץ אחד מאחורי Skills Search

ב-Google Trends, ברחבי העולם, במהלך שבעת הימים האחרונים ובקריאה ב-23 באוקטובר 2026, "karpathy skills" מופיע כשאילתה עולה תחת מונח הבסיס "claude skills". כל מי שעוקב אחר החיפוש הזה מגיע לאותו מקום: github.com/multica-ai/andrej-karpathy-skills, מאגר שהציג 222,612 כוכבים ב-GitHub, בקריאה ב-23 באוקטובר 2026. בתיאור שלו אין כלל את המילה skill. כתוב בו: "קובץ CLAUDE.md יחיד לשיפור התנהגות Claude Code, שנגזר מהתצפיות של Andrej Karpathy על מלכודות קידוד ב-LLM."

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

המספרים, כולם מ-GitHub ונקראו ב-23 באוקטובר 2026: 222,612 כוכבים, 22,321 פורקים, נוצר ב-27 בינואר 2026, הדחיפה האחרונה ב-20 באפריל 2026, רישיון MIT. הצמד האחרון הוא המעניין. המאגר לא קיבל דחיפה כבר כ־שישה חודשים, ומספר הכוכבים המשיך לעלות בכל זאת.

הקובץ עושה את העבודה; האריזה מסבירה את מונח החיפוש

פתחו את ה-repository ורשימת הקבצים הופכת את חוסר ההתאמה לקל להבחנה. בשורש נמצא CLAUDE.md, ולצידו CURSOR.md, EXAMPLES.md, תיקיית .cursor/rules המחזיקה את אותן ההנחיות בתור כלל פרויקט של Cursor, תיקיית .claude-plugin, ותיקיית skills/karpathy-guidelines. מסלול ההתקנה המומלץ ב-README הוא ה-plugin marketplace, והוא מתאר את התוצאה ככזו שהופכת "את ה-skill לזמין בכל הפרויקטים שלך".

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

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

התלונות שנגדן הוא נכתב

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

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

השני: הם "ממש אוהבים לסבך קוד וממשקי API, לנפח שכבות הפשטה, לא לנקות קוד מת… ליישם מבנה מנופח של יותר מ-1,000 שורות כשמספיקות 100". זה מוכר לכל מי שביקש פיצ'ר וקיבל פריימוורק.

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

ארבעה עקרונות, והמבחן שכל אחד מהם מותיר אחריו

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

חשוב לפני קידוד

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

פשטות תחילה

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

שינויים כירורגיים

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

ביצוע מונחה מטרה

הגדר קריטריוני הצלחה וחזור בלולאה עד לאימות. ה־README מציג את הטרנספורמציה כזוגות. במקום "להוסיף ולידציה", כתוב בדיקות לקלטים לא חוקיים ואז גרום להן לעבור. במקום "לתקן את הבאג", כתוב בדיקה שמשחזרת אותו ואז גרום לה לעבור. במקום "לבצע ריפקטור ל-X", ודא שהבדיקות עוברות לפני ואחרי. בעבודה מרובת שלבים זה מבקש תוכנית קצרה שבה כל שלב מציין את האימות שלו. ה־README מצטט שוב את קרפטי כאן: "מודלים לשוניים גדולים (LLMs) טובים במיוחד בלולאה עד שהם משיגים מטרות ספציפיות… אל תגיד להם מה לעשות, תן להם קריטריוני הצלחה ותראה אותם ממשיכים."

קובץ, מיומנות ותוסף הם שלושה דברים שונים

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

CLAUDE.md הוא, במובן הזה, הכלי הגס ביותר מבין השלושה. הוא תמיד פעיל בפרויקט הזה, הוא חל על כל משימה בו, והוא תופס הקשר בכל תור — בין אם העבודה היא תיקון שגיאת כתיב בשורה אחת ובין אם מדובר בהעברה. קובץ ה-README של הקובץ עצמו מכיר בעלות הזו בקטע בשם Tradeoff Note: ההנחיות נוטות להעדיף זהירות על פני מהירות, ובמשימות של מה בכך — תיקוני שגיאות כתיב פשוטים, שורות בודדות מובנות מאליהן — עליך להפעיל שיקול דעת. נאמר בו שהמטרה היא לצמצם טעויות יקרות בעבודה לא טריוויאלית, ולא להאט משימות פשוטות.

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

מה מודדים 222,612 כוכבים

הם מודדים תשומת לב. זה לא ביטול וזה לא דבר של מה בכך: מאגר שנוצר בינואר 2026 ובוצע לו push לאחרונה באפריל הגיע ל־222,612 כוכבים ול־22,321 forks עד 23 באוקטובר 2026, ב־GitHub, כפי שנקרא באותו יום, מה שאומר שהוא שותף באופן נרחב ובוצע לו fork על ידי אנשים שרצו עותק משל עצמם. מספר כוכבים הוא מדד מקורב סביר לכמה אנשים מצאו משהו ששווה לשמור במועדפים.

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

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

מה בעצם מקלידים כדי להתקין את זה

ה-README מציג שני מסלולים. המסלול המומלץ פועל בתוך Claude Code: מוסיפים את ה-marketplace, ואז מתקינים את התוסף, ולאחר מכן ההנחיות קיימות בכל הפרויקטים ולא בכל מאגר בנפרד. המסלול השני הוא לפי פרויקט: למשוך את קובץ ה-CLAUDE.md הגולמי אל מאגר חדש, או לצרף אותו למאגר קיים. קיים גם כלל פרויקט של Cursor שנכלל ב-commit, כך שאותן הנחיות חלות כאשר התיקייה נפתחת ב-Cursor — פרט שמעיד שהקובץ נכתב כך שיהיה נייד בין כלים שקוראים קובץ הנחיות ברמת הפרויקט, ולא תלוי בטוען של ספק אחד.

קצה מחוספס אחד, שווה לציין כי תיתקלו בו אם תפעלו לפי ה־README בדיוק. פקודת ה־marketplace מציינת את forrestchang/andrej-karpathy-skills, בעוד שכתובת ה־URL של המאגר בראש העמוד היא multica-ai/andrej-karpathy-skills. שתי המחרוזות מופיעות באותו README, שנקרא ב־23 באוקטובר 2026. אני רואה את אי־ההתאמה ואיני יכול לומר לך מדוע היא קיימת, לכן העצה הכנה היא לנסות את הנתיב האחר אם אחד נכשל, ולהתייחס לאחת משתי המחרוזות כלא מעודכנת.

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

שימוש בו מבלי לרשת את ההנחות שלו

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

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

וראוי לך לבחון אותו. זהו מסמך קצר של הנחיות התנהגותיות שיחול על כל בקשה במאגר. השאלה הנכונה אינה אם 222,612 אנשים יכולים לטעות — ניסוח כזה אינו מכריע דבר — אלא אם כל כלל מתאים לכשל שבאמת ראית. אם ה-diffs שלך מעולם לא כללו שכתובי הערות אגביים, פרק השינויים הכירורגיים עולה לך בהקשר לחינם. מחק אותו. הקובץ ברישיון MIT ונועד לעריכה.

שכבה אחת למטה, שום דבר מזה לא משנה איזה מודל עונה. קובץ CLAUDE.md מעצב איך בקשה מטופלת ברגע שהיא מגיעה למודל; הוא לא אומר דבר על המודל שמקבל אותה. ההחלטה השנייה הזו שייכת למה שנמצא לפני המודל. דרך אחת לארגן זאת היא נקודת קצה אחת תואמת OpenAI שנושאת יותר מ-200 מודלים תחת מפתח אחד, עם מעבר אוטומטי בין ספקים במקרה כשל ועם מחירי המחירון של הספקים מועברים הלאה בתוספת של 0%. אנחנו מארחים מודלים; אנחנו לא יוצרים את Claude Code, ושום דבר במאגר שלך לא גלוי לנו.

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