Die Notion Skills API lädt die Skills, die dein Team in Notion pflegt, als standardkonforme Skill-Verzeichnisse herunter, damit Agents außerhalb von Notion, von Claude, ChatGPT und Grok Bot bis zu lokalen Coding-Agents, Anweisungen ausführen, die Teammitglieder als ganz normale Notion-Seiten bearbeiten.

Drei Endpunkte erledigen die Arbeit. List plugins (GET /v1/ai/plugins) liefert die Plugins, die eine Connection sehen darf: Jeder Wert der Tags-Property einer Skills-Datenbank wird zu einem Plugin, ein Skill ohne Tag zu einem eigenen Plugin, jeweils mit einer version_id, die sich nur ändert, wenn sich der Inhalt ändert, sodass ein Sync überspringen kann, was er schon hat. Get plugin (GET /v1/ai/plugins/{id}) und Get skill (GET /v1/ai/skills/{id}) geben eine signierte URL auf ein gzip-komprimiertes tar-Archiv zurück, das die SKILL.md plus die über die Files-Property angehängten Dateien enthält, in den Formaten Agent Skills und Agent Plugins; ein Plugin umfasst höchstens 100 Skills. Anfragen brauchen einen Connection-Token oder Personal Access Token mit der Capability Read content und den Header Notion-Version: 2026-03-11, und zurück kommen nur Skills, die mit dieser Connection geteilt sind. Notions Open-Source-Starter-Repository makenotion/notion-skills-github-sync hält einen GitHub-Plugin-Marketplace mit dem Workspace synchron, sodass Claude, ChatGPT oder Grok Bot von dort installieren, mit ihrem eigenen Slash-Menü und ihren Admin-Installationskontrollen.

Um einen Skill ohne eigenen Code lokal zu installieren, nutzt du Vercels skills CLI: npx skills add gefolgt von der URL der Skill-Seite installiert genau diesen Skill, und npx skills add notion zeigt die Plugins deines Workspace an und installiert die, die du auswählst.