---
title: "A skills library for every agent"
description: "The post introduces Notion’s skills library and Skills API, aimed at helping teams share organizational knowledge across AI agents and workflows. The library is designed for nontechnical and technical users, with collaborative editing, database organization, supporting files, permissions, suggested edits, version history, usage analytics, and controls over skill distribution. The API provides endpoints for loading skills in spec-compliant file formats, with examples including synchronization to GitHub, installation through Vercel’s Skills CLI, and uploads or edits through MCP tools. Notion says early customers and partners are already using the API across agents and tools, while an open-source starter kit supports Notion-to-GitHub synchronization. Vercel’s Skills CLI can install individual Notion skill pages or workspace plugins, using standards-compliant files without handling Notion-specific formats."
---

# A skills library for every agent

[Notion](https://yomu.fyi/company/notion) · Geoffrey Litt · Sep 17, 2026

**Type:** Announcement

## Summary

The post introduces Notion’s skills library and Skills API, aimed at helping teams share organizational knowledge across AI agents and workflows. The library is designed for nontechnical and technical users, with collaborative editing, database organization, supporting files, permissions, suggested edits, version history, usage analytics, and controls over skill distribution. The API provides endpoints for loading skills in spec-compliant file formats, with examples including synchronization to GitHub, installation through Vercel’s Skills CLI, and uploads or edits through MCP tools. Notion says early customers and partners are already using the API across agents and tools, while an open-source starter kit supports Notion-to-GitHub synchronization. Vercel’s Skills CLI can install individual Notion skill pages or workspace plugins, using standards-compliant files without handling Notion-specific formats.

## Context

Notion positions a skills library as shared organizational knowledge that should be usable across agents, accessible to functions beyond engineering, and governed through collaboration, permissions, analytics, and administrative controls. The post describes customer use across marketing, design, operations, and product operations.

## Approach / What changed

Notion provides editable skill pages organized in databases, supporting files for assets and code, and a Skills API that returns skills in spec-compliant file formats. Teams can synchronize skills to GitHub, upload or edit them through MCP tools, or install them with Vercel’s Skills CLI. An open-source starter kit demonstrates the GitHub sync and can serve as sample code for other integrations.

## Takeaways

- Notion’s skills library is intended for organization-wide collaboration, allowing teams to edit skills as pages, organize them in databases, attach supporting files, and manage permissions, suggestions, analytics, and distribution controls.
- The Skills API exposes Notion skills in standards-compliant file formats, enabling synchronization to GitHub while allowing nontechnical teams to use Notion as the collaborative editing environment.
- Vercel’s Skills CLI supports installing a Notion page marked as a skill or interactively installing workspace plugins; its integration does not need to process Notion-specific data formats.

## FAQ

### How can a team keep Notion skills synchronized with agents that use GitHub?

The Skills API can sync skills from Notion into a GitHub repository. This preserves Notion as a collaborative home while making the skills available to agent apps that use GitHub, including native features such as menu invocation and administrative installation controls.

### Can agents update the skills library, or only read from it?

Agents can upload and edit skills in Notion through MCP tools. The post describes this as a way to use existing skills while creating a continuous improvement loop as those skills are used.

### How does Vercel’s Skills CLI install skills from Notion?

Running npx skills add <notion url> installs a Notion page marked as a skill, while npx skills add notion interactively installs plugins available in the workspace. The CLI uses the Skills API’s standards-compliant file responses rather than reasoning about Notion-specific formats.

**Tags:** [AI Agents](https://yomu.fyi/topic/ai-agents), [API](https://yomu.fyi/topic/api), [Notion](https://yomu.fyi/topic/notion), [Open Source](https://yomu.fyi/topic/open-source)

- Source: [Notion](https://www.notion.com/en-gb/blog/a-skills-library-for-every-agent)
- Source URL: https://www.notion.com/en-gb/blog/a-skills-library-for-every-agent
- Ingested by Yomu: 2026-09-17T18:00:14.601Z

[Read original post](https://www.notion.com/en-gb/blog/a-skills-library-for-every-agent)