Skills make AI agents more capable and customized to your workflows. And skills become even more valuable when they’re shared, letting many people benefit from the efforts of a few. That’s why it’s critical for modern teams to adopt a skills library where they can share and discover skills.
Our customers tell us they’re looking for a skills library with these qualities:
- Made for the whole team : Skills aren’t just for engineers anymore. A skills library must be easy to use for everyone, including functions like sales/marketing, finance, and operations.
- Agent-neutral : Skills are becoming a critical store of organizational knowledge. Your skills must be available in every agent, not locked into a single one.
- Collaborative : Skills should be continuously improving with suggestions from everyone on the team. At the same time, it’s important to stay in control with permissions and version history.
- Observable and governable : Team admins need usage analytics and the ability to control which skills flow to which users.
At Notion, we’re building a skills library that checks all of these boxes. You can edit skills just like regular Notion pages, and keep them organized in databases. You can store folders of supporting files like assets and code, so that the library can store any spec-compliant skill. And the whole system is deeply collaborative, with permissions, suggested edits, analytics, and more.
Introducing the Notion Skills API #
An agent-neutral skills library needs to be available everywhere your team works. Today we’re taking the next step toward this goal with the Skills API: a set of API endpoints for skills from Notion in spec-compliant file formats.
Our early customers and partners are using this API to load skills from Notion in all of their agents and tools. Here are some examples to get you inspired.
Sync skills to GitHub
Many teams store their skills in a GitHub repository, which can be used as a source of skills in agent apps like Claude, ChatGPT, and Grok Bot. GitHub works well for engineers, but others often struggle to edit the skills, or don’t even have accounts.
Using the skills API, you can sync your team’s skills from Notion into GitHub. This lets nontechnical teams use Notion as their collaborative home for skills, while still keeping those skills synced into their various agents. Once synced, the skills support native features available in agent apps, like / menu invocation and admin installation controls.
You can also upload and edit skills in Notion from agent apps using MCP tools. This means you can use existing skills from your agent to get your skills library started and drive a loop of continuous improvement as skills are actually used.
Here’s what our customers have to say about this new capability:
“Having the ability to document our skills in Notion strengthens our team’s awareness of what’s accessible and supports how they’re used when working with Claude.” –Hillary Helmling, Product Operations, Candidly
“The reason we can’t have those skills just sit in GitHub is that not everyone who makes a skill is a developer. Notion not only surfaces the skill output, but it can be collaborated upon by team members directly in the platform they know.” –Josh Reid, Product Engineer, Brainlabs
Try it
If you’d like to sync skills from Notion into GitHub, we are open-sourcing a starter kit that your IT team can use to set up your own skill sync. Point your coding agent at this repo to get started. At the same time, you don’t need to be limited to that particular sync, either. Your team can use this as sample code for building an integration with any internal agent or tool.
Install Notion skills in the Vercel CLI
The Skills API also allows companies building agentic tooling products to support the Notion skills library.
Vercel has now added support for Notion skills to their skills CLI, one of the most popular tools for installing skills.
Run npx skills add <notion url> to install a Notion page marked as a skill, or run npx skills add notion to interactively install entire plugins from all the plugins available in your workspace. Members of your team can use the CLI interactively, or you can integrate it into programmatic workflows.
Behind the scenes, these new CLI features are supported by the Skills API. Because the API returns files in standards-compliant formats, the skills CLI doesn’t need to reason about Notion-specific data formats. The skills CLI is open source, and you can use it as an example of how to integrate with the Skills API.
Get started #
We believe every team needs a collaborative skills library that’s available in all their agents.
If you’re interested in learning more about how your company can use the Notion skills library, please contact us. To get started building against the API, check out the Agent Skills API page in Notion Docs.
To learn more about how to use skills in Notion, see the Skills for Notion Agent page in our Help Center.