אתם לא חייבים לדעת הכל כדי שקלוד שלכם ידע הכל

אני רוצה שתבנה skill ל-Claude Code שיודע לעבוד עם כלי שאני עובד איתו. הידע בסקיל בא מהתיעוד הרשמי של הכלי. לא מהזיכרון שלך, לא מבלוגים, לא מסרטונים ולא מפוסטים בפורומים. אל תתחיל לפני שאתה שואל. ## שלב 0: תשאל אותי שתי שאלות, אחת בכל הודעה 1. **איזה כלי**, בשם המדויק שלו. אם יש לי קישור לתיעוד, אני אתן אותו. 2. **מה אני עושה איתו בפועל:** שלוש עד חמש פעולות שאני מבצע בו ביומיום, במילים שלי. השאלה השנייה היא לא נימוס. בלי תשובה עליה תבנה לי תקציר של התיעוד, וזה חסר תועלת: את התיעוד אני יכול לקרוא לבד. סקיל שימושי הוא כזה שבנוי סביב מה שאני באמת עושה. אם אני עונה "לא יודע", תציע לי שלוש פעולות נפוצות בכלי כזה ותבקש ממני לבחור או לתקן. ## שלב 1: מצא את התיעוד הרשמי, ותוכיח לי שזה הוא חפש את התיעוד של הספק עצמו. הסימנים שזה האמיתי: הוא יושב על הדומיין של הכלי או על תת דומיין שלו, הוא מאורגן כעץ נושאים ולא כרשימת פוסטים, ויש בו עמודי התחלה, עמודי API או עמודי הגדרות. **מה לא נחשב תיעוד רשמי:** פוסט בבלוג, גם של הספק. מאמר "המדריך המלא ל" באתר אחר. סרטון. תשובה בפורום. עמוד שיווקי. מה שמצאת בזיכרון שלך. תוכן שנכתב על ידי AI אחר. מאגר קוד של צד שלישי שעוטף את הכלי. **לפני שאתה ממשיך, תציג לי טבלה:** כל כתובת שמצאת, מה יש בה, ואם היא רשמית או לא. סמן מה אתה מתכוון לקרוא. אם לא מצאת תיעוד רשמי, תגיד לי את זה במשפט אחד ותעצור. אל תבנה סקיל מחומר משני ואל תמלא את החסר מהזיכרון. סקיל שנשמע בטוח ומבוסס על ניחוש הוא גרוע מאין סקיל, כי אני אסמוך עליו. אם התיעוד דורש התחברות או שהוא סגור, תגיד לי. אני אחליט אם לפתוח אותו ולהעביר לך. ## שלב 2: קרא את הכל, ורשום מה קראת קרא את העמודים שסימנת, לא רק את הראשון. בזמן הקריאה תחפש במיוחד את הדברים האלה, כי הם מה שמבדיל סקיל שעובד מסקיל שמתאר: - המודל: מה הישויות בכלי, ואיך הן מתייחסות אחת לשנייה - הפעולות הנפוצות, והסדר המדויק שבו צריך לעשות אותן - מה שלא ניתן לעשות בכלי, או שניתן לעשות רק פעם אחת ואין דרך חזרה - מגבלות: הרשאות, תקרות, פורמטים, מכסות - השגיאות הנפוצות, ומה המשמעות של כל אחת - מילון: איך הכלי קורא לדברים, במיוחד כשזה שם שונה ממה שהעולם קורא להם **צור קובץ `docs-index.md` בתוך תיקיית הסקיל,** ובו לכל עמוד שקראת: הכתובת, מה יש בו, התאריך שבו קראת, ואם מופיע בעמוד תאריך עדכון או מספר גרסה, גם אותו. הקובץ הזה הוא מה שיאפשר לבדיקה השבועית להשוות בין אז ועכשיו, במקום לנחש. ## שלב 3: בנה את הסקיל המבנה: ``` <שם-הכלי>/ ├── SKILL.md מתי להשתמש, ואיך עובדים עם הכלי בפועל ├── docs-index.md מה נקרא, מאיפה, מתי ├── RECHECK.md הפרומפט של הבדיקה השבועית └── references/ פירוט לפי נושא, רק אם SKILL.md נהיה ארוך מדי ``` ב-`SKILL.md`: - **frontmatter** עם `name` (אנגלית, אותיות קטנות ומקפים) ו-`description`. התיאור הוא מה שמחליט אם הסקיל ייטען בכלל, ולכן הוא כתוב מנקודת המבט שלי ולא של הכלי: מה אני עומד לבקש, באילו מילים, בעברית ובאנגלית. אם יש בתיאור נקודתיים ואחריהן רווח, שים אותו בגרשיים או כבלוק `>-`, אחרת ה-YAML נשבר בשקט. - **מתי להשתמש בסקיל, ומתי לא.** הגבול חשוב כמו התוכן. - **הפעולות שעניתי עליהן בשלב 0**, כל אחת כשלבים בסדר הנכון, עם מה שצריך להכין לפני, ועם המקום שבו דברים נשברים בדרך כלל. - **מה אסור**, ובמיוחד כל פעולה בלתי הפיכה. זה החלק שאני רוצה שיהיה הכי מפורש. - **מה לא לנחש.** כל שדה, מזהה, מספר או שם שחייבים לבוא ממני או מהכלי ולא מהראש שלך, בשורה מפורשת. - **מקור לכל טענה לא טריוויאלית:** הכתובת שממנה היא באה. לא כדי שייראה מסודר, אלא כדי שאפשר יהיה לבדוק אותה בעוד חצי שנה. - **בלי קוד שלא בדקת.** אם אתה כותב פקודה או סקריפט, תגיד במפורש אם הרצת אותו או לא. אל תחזור על התיעוד. סקיל הוא הדרך לעבוד עם הכלי, לא עוד עותק של המסמכים שלו. ## שלב 4: תציג לי את הבדיקה השבועית, ואז תקים אותה כלים משתנים. בכלים צעירים זה קורה כל שבוע, ודווקא השורה שהשתנתה היא זאת שתשבור לי משהו בשקט. לכן הסקיל צריך בדיקה חוזרת. **קודם כתוב `RECHECK.md`:** הפרומפט שמריץ את הבדיקה, עצמאי לגמרי, כזה שאפשר להדביק בשיחה חדשה בלי שום הקשר. מה הוא עושה: פותח את `docs-index.md`, נכנס לכל כתובת, משווה למה שנרשם, ואם משהו השתנה מעדכן את `SKILL.md`, מעדכן את התאריכים ב-`docs-index.md`, וכותב שורה אחת ב-`CHANGELOG.md` של הסקיל: מה השתנה ומה עודכן בעקבות זה. אם כלום לא השתנה, הוא כותב רק את התאריך ולא נוגע בסקיל. **אחר כך תציג לי שלוש דרכים להריץ את זה, ותשאל אותי מה אני מעדיף.** תגיד לי על כל אחת מה היא דורשת ממני, בכנות, כולל מה שלא נוח: 1. **משימה מתוזמנת בתוך Claude Code.** אם הגרסה שלי תומכת בזה, זאת הדרך הנוחה: אתה מקים משימה שבועית עם הפרומפט מ-`RECHECK.md`, והיא רצה לבד. תבדוק אם הכלי הזה זמין אצלי לפני שאתה מציע אותו, ואם לא, תגיד לי. 2. **המתזמן של המחשב עצמו.** שורה אחת ב-cron במק או בלינוקס, או משימה מתוזמנת בווינדוס, שמריצה את Claude Code במצב לא אינטראקטיבי עם הפרומפט מ-`RECHECK.md`. רץ רק כשהמחשב פתוח. 3. **בלי אוטומציה.** תזכורת שבועית ביומן, ואני מדביק את `RECHECK.md` בשיחה חדשה. פחות אלגנטי, ועובד תמיד. שתי הראשונות מריצות שיחה אמיתית, ולכן הן עולות מכסת שימוש. תגיד לי את זה מראש. אחרי שאני בוחר, תקים את מה שבחרתי, תראה לי איך אני מוודא שזה אכן קיים, ותגיד לי איך מכבים את זה. ## כללים לכל אורך הדרך - **אל תמלא פערים מהזיכרון.** מה שלא נמצא בתיעוד נכתב בסקיל כ"לא מצאתי בתיעוד", ולא כעובדה. - **אל תכתוב סקיל לכלי שלא מצאת לו תיעוד רשמי.** תגיד לי ותעצור. - **אל תגדיל.** שתי פעולות שמתועדות היטב שוות יותר מעשר שחציין ניחוש. - **תשאל אותי לפני כל פעולה שיוצאת מהתיקייה הזאת:** התקנה, חיבור חשבון, מפתח, או כל קריאה שמשנה משהו בכלי עצמו. - **הסקיל לא מחזיק מפתחות ולא סיסמאות.** אם נדרשת הזדהות, הסקיל אומר איפה היא נשמרת, ולא מה היא. - **עברית בשיחה איתי, אנגלית בשמות קבצים ובקוד.**

בדיקה שבועית של סקיל שנבנה מתיעוד רשמי. תעבוד לבד, ותחזור אליי בסוף עם סיכום קצר. תיקיית הסקיל: `<כאן הנתיב לתיקיית הסקיל>` 1. **קרא את `docs-index.md` בתיקייה.** בו רשומה כל כתובת שממנה נבנה הסקיל, מה היה בה, מתי היא נקראה, ואם היה בה תאריך עדכון או מספר גרסה, גם הם. 2. **היכנס לכל כתובת ברשימה.** לכל אחת קבע אחד מארבעה: לא השתנתה, השתנתה, זזה לכתובת אחרת, נעלמה. אם הכתובת זזה, מצא את החדשה בתיעוד הרשמי של אותו כלי. אם היא נעלמה לגמרי, אל תחפש תחליף בבלוגים. 3. **בדוק גם מה נוסף.** עבור על עץ הנושאים של התיעוד וחפש עמוד חדש שרלוונטי לפעולות שהסקיל עושה. כלי צעיר מוסיף יכולות יותר מהר ממה שהוא משנה אותן, ועמוד חדש שלא נקרא הוא הפער הנפוץ. 4. **עדכן, במידה ובאמת צריך:** - `SKILL.md`: רק את מה שהשתנה בפועל. אל תשפר ניסוח ואל תארגן מחדש. שינוי שאי אפשר להצביע על השורה בתיעוד שחייבה אותו הוא שינוי שלא צריך לקרות. - `docs-index.md`: תאריך הבדיקה בכל שורה, וכתובת או גרסה חדשה אם היו. - `CHANGELOG.md` בתיקייה (צור אותו אם אינו קיים): שורה אחת לבדיקה, עם התאריך. מה השתנה בתיעוד, ומה עודכן בסקיל בעקבות זה. אם כלום לא השתנה, שורה אחת שאומרת בדיוק את זה. 5. **דגל אדום, אם יש.** אם משהו שהסקיל אומר כבר לא נכון, או שפעולה שהוא מתאר כבטוחה הפכה לבלתי הפיכה, אל תתקן רק את השורה. תגיד לי את זה במפורש בשורה הראשונה של הסיכום, לפני כל השאר. **כללים** - מהתיעוד הרשמי בלבד. לא בלוגים, לא סרטונים, לא פורומים, ולא מהזיכרון שלך. - מה שלא מצאת בתיעוד נשאר בסקיל מסומן כ"לא מצאתי בתיעוד". אל תשלים אותו. - אל תמחק מהסקיל ידע שעדיין נכון, גם אם העמוד שממנו הוא בא זז. - אל תשנה את `name` ואת `description` ב-frontmatter אלא אם הכלי עצמו שינה את שמו. - בסוף, סיכום של עד חמש שורות: מה נבדק, מה השתנה, מה עודכן, ומה דורש החלטה שלי.