Institflow מספקת [Agent Skill](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills) לממשק הציבורי שלה — תיקייה קטנה ועצמאית שמלמדת סוכן קוד (Claude Code, Cursor, Codex, או כל כלי אחר שיודע לקרוא קובץ ולשלוח בקשות HTTP) כל מה שהוא צריך כדי להתממשק נכון: אימות, מעטפת השגיאה, אידמפוטנטיות, עימוד, מגבלות קצב, אימות חתימה של webhook, וקוד דוגמה שרץ — בלי שהסוכן ייאלץ לגלות שום דבר מזה מחדש בניסוי וטעייה מול הדייר שלכם.

## ה-Agent Skill של Institflow

המיומנות היא תיקייה, `institflow-api/`, שמכילה קובץ כניסה אחד (`SKILL.md`) וחומרי עזר נלווים שהסוכן טוען רק לפי הצורך (אינדקס מלא של נקודות הקצה שנוצר ממסמך הממשק החי, פירוט webhooks ושגיאות, ושתי דוגמאות ברות-הרצה — אחת ב-TypeScript ואחת ב-Python, שתיהן עם `fetch`/ספריית התקן בלבד, בלי SDK). היא לעולם לא מעודדת דפוס לא מאובטח — בלי מפתחות במחרוזת שאילתה, השוואת חתימות webhook בזמן קבוע, ומפתחות אידמפוטנטיות בכל קריאה שמזיזה כסף.

[הורדת institflow-api-skill.tar.gz](https://docs.institflow.com/downloads/institflow-api-skill.tar.gz) או [institflow-api-skill.zip](https://docs.institflow.com/downloads/institflow-api-skill.zip) — אותה תיקייה, בשני פורמטים. קובץ ה-tar.gz נפרס ישירות לתיקיית מיומנויות בפקודה אחת:

```bash
curl -fsSL https://docs.institflow.com/downloads/institflow-api-skill.tar.gz | tar -xz -C ~/.claude/skills
```

התוצאה היא תיקיית `~/.claude/skills/institflow-api/` מוכנה לשימוש — בלי שלב חילוץ נפרד. שתי החבילות נבנות מחדש מהאתר הזה בכל פעם שקבוצת נקודות הקצה של הממשק משתנה, אז הריצו את הפקודה שוב (או הורידו מחדש את ה-zip) מדי פעם במקום לשמור עותק משלכם לנצח.

> **כבר עובדים בתוך המאגר הזה?**
>
> דלגו על ההורדה: המאגר הזה כולל עותק מוכן לשימוש ב-`.claude/skills/institflow-api` (זהה בית-בבית ל-`skills/institflow-api/`, המקור הקנוני שנארז בחבילות שלמעלה, על ידי אותו מחולל) — Claude Code טוען אותו אוטומטית, בלי הורדה ובלי חילוץ.

## התקנה ב-Claude Code

Claude Code מגלה מיומנויות משתי תיקיות: אישית (זמינה בכל פרויקט) או ייעודית לפרויקט (מוכנסת למאגר ומשותפת עם הצוות):

```bash
# Personal — available in every project on this machine
unzip institflow-api-skill.zip -d ~/.claude/skills/institflow-api

# Project — checked into this repo, shared with your team
unzip institflow-api-skill.zip -d .claude/skills/institflow-api
```

Claude Code קורא את ה-frontmatter של כל `SKILL.md` (`name` + `description`) כדי להחליט מתי היא רלוונטית — אינכם צריכים להזכיר אותה בשמה. בקשו ממנו “ליצור תלמיד דרך ה-API של Institflow” או “לאמת את חתימת ה-webhook הזו של Institflow” והוא יטען את המיומנות אוטומטית.

## כללי Cursor

Cursor עדיין לא קורא את פורמט ה-Agent Skills ישירות — הפנו אותו לאותו תוכן ככלל פרויקט במקום: חלצו את המיומנות לתוך המאגר שלכם (בכל מקום, למשל `docs/institflow-api/`) והוסיפו קובץ `.cursor/rules/institflow-api.mdc` קצר שמפנה אליה:

```plaintext
---
description: Institflow public API integration — auth, pagination, idempotency, webhooks
globs:
alwaysApply: false
---

When writing code that calls the Institflow API, follow docs/institflow-api/SKILL.md exactly —
especially its Idempotency, Pagination, and Gotchas sections. Endpoint details are in
docs/institflow-api/reference/endpoints.md.
```

## סוכנים אחרים

כל סוכן שאינו יודע לטעון תיקיית מיומנות באופן טבעי עדיין נהנה מאותו תוכן: הדביקו את `SKILL.md` ישירות לפרומפט המערכת או לחלון ההקשר שלו, או הפנו כלי שיודע להביא כתובת אל `llms.txt` שלמטה, שמרכז במקום אחד את כל המדריכים, את מסמך הממשק הקריא למכונה, ואת הורדת המיומנות — בדיוק למטרה הזו.

```plaintext
https://docs.institflow.com/llms.txt
https://docs.institflow.com/llms-full.txt
```

## או התחברות ישירה לשרת MCP

אם הסוכן שלכם פועל בשם אדם מסוים ומחובר (ולא רץ ללא השגחה כשירות) ומדבר Model Context Protocol, חיבור אל `/mcp` הוא לרוב התאמה טובה יותר מממשק ה-REST שהמיומנות הזו מכסה — הסכמת OAuth תוחמת את הסשן להרשאות של אותו אדם בדיוק, ופעולות הרסניות חוזרות כתצוגה מקדימה לאישור במקום להתבצע מיד. ראו את [המדריך ל-MCP ו-OAuth 2.1](https://docs.institflow.com/he/mcp) לכתובת החיבור, לתהליך הגילוי ולקטלוג הכלים המלא, ואת הסעיף “REST מול MCP” במיומנות עצמה כדי להחליט במה לבחור.

> **שני משטחים, מודל הרשאות אחד**
>
> REST (עם מפתח API) ו-MCP (עם טוקן OAuth) קוראים לאותם שירותי דומיין בדיוק, תחת אותו מרשם הרשאות בדיוק — אין שום דבר שאפשר לעשות דרך אחד מהם שאינו נשלט באותם כללים דרך השני.