{"slug": "a-skills-library-for-every-agent", "title": "A skills library for every agent", "summary": "Notion launched the Notion Skills API, a set of API endpoints for loading skills from Notion in spec-compliant file formats, and open-sourced a starter kit for syncing team skills from Notion into GitHub. The API is designed to be agent-neutral, letting skills be loaded into agents and tools including Claude, ChatGPT, and Grok Bot, with support for MCP tools to upload and edit skills from agent apps. Notion said the library adds permissions, suggested edits, version history, and usage analytics for team admins.", "body_md": "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.\n\nOur customers tell us they’re looking for a skills library with these qualities:\n\n- **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.\n- **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.\n- **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.\n- **Observable and governable** : Team admins need usage analytics and the ability to control which skills flow to which users.\n\nAt 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.\n\n## Introducing the Notion Skills API\n\nAn 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](https://developers.notion.com/guides/agent-skills/overview): **a set of API endpoints for loading skills from Notion in spec-compliant file formats.**\n\nOur 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.\n\n### Sync skills to GitHub\n\nMany 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.\n\nUsing 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.\n\nYou 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.\n\nHere’s what our customers have to say about this new capability:\n\n“**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\n\n“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\n\n#### Try it\n\nIf 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](https://github.com/makenotion/notion-skills-github-sync).\n\nAt 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.\n\n### Install Notion skills in the Vercel CLI\n\nThe **Skills API also allows companies building agentic tooling products to support the Notion skills library**.\n\nVercel has now added support for Notion skills to their `skills` CLI, one of the most popular tools for installing skills.\n\nRun `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.\n\nBehind 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](https://github.com/vercel-labs/skills), and you can use it as an example of how to integrate with the Skills API.\n\n## Get started\n\nWe believe every team needs a collaborative skills library that’s available in all their agents.\n\nIf you’re interested in learning more about how your company can use the Notion skills library, please [contact us](https://notion.notion.site/8753aa0d91b749baa71dad3e025cf1d2?pvs=105).\n\nTo get started building against the API, check out [the Agent Skills API page](https://developers.notion.com/guides/agent-skills/overview) in Notion Docs. \n\nTo learn more about how to use skills in Notion, see the [Skills for Notion Agent page](https://www.notion.com/help/create-and-manage-skills) in our Help Center.", "url": "https://wpnews.pro/news/a-skills-library-for-every-agent", "canonical_source": "https://www.notion.com/blog/a-skills-library-for-every-agent", "published_at": "2026-09-22 00:04:59+00:00", "updated_at": "2026-09-22 00:24:11.753203+00:00", "lang": "en", "topics": ["ai-agents", "ai-tools", "agent-protocols", "ai-products"], "entities": ["Notion", "Notion Skills API", "GitHub", "Claude", "ChatGPT", "Grok Bot", "Vercel CLI", "MCP"], "alternates": {"html": "https://wpnews.pro/news/a-skills-library-for-every-agent", "markdown": "https://wpnews.pro/news/a-skills-library-for-every-agent.md", "text": "https://wpnews.pro/news/a-skills-library-for-every-agent.txt", "jsonld": "https://wpnews.pro/news/a-skills-library-for-every-agent.jsonld"}}