Introducing the Notion Skills API
By Steven Van ·
Notion launches the Skills API so teams can edit skills as Notion pages and use them in ChatGPT, Claude, and any agent.
Notion has introduced the Notion Skills API, which lets teams edit their skills in Notion and use them in ChatGPT, Claude, and other AI agents.
A Notion Skill is a page that holds instructions for a repeatable workflow. Teams already use Notion as a skills library to edit, review, and share these instructions. The new Agent Skills API exposes those skills as directories of files that agents can download, following the Agent Skills standard for individual skills and the Agent Plugins standard for groups of related skills. Each skill's main SKILL.md file is a Notion page, and supporting files and folders can be attached through its Files property.
- Edit your team's skills in Notion and use them in ChatGPT, Claude, and all of your agents.
- Three endpoints: List plugins, Get a plugin directory, and Get a skill directory, all served under /v1/ai/plugins with Notion-Version 2026-03-11.
- Skills tagged with the same label are bundled into one plugin, while an untagged skill becomes a plugin of its own.
- Each plugin carries a version_id, so sync scripts can skip plugins that have not changed and download only updated archives as gzipped tar files.
- Notion MCP adds a notion-download-skill tool, and a notion-skills-github-sync sample repo shows how to sync skills into a GitHub plugin marketplace.
The full details are in the announcement and the developer documentation.