Installing a Notion agent skillA reusable instruction file that teaches an agent how to do one job well — the procedure, the tools, and what counts as done.Full definition → authenticates through the separate Notion CLI (`ntn`), which requires the workspace to allow personal access tokenThe chunk of text a model reads and writes in — roughly three-quarters of a word — and the unit AI usage is billed in.Full definition → before `ntn login` will work.
Access to a Notion-hosted skill is entirely inherited from Notion's own page-sharing permissions, so controlling who can install a skill means controlling who can view its Notion page.
The integration runs on a new Notion AI agentAn AI system that doesn't just answer once but works toward a goal in a loop — taking actions, reading the results, and deciding what to do next.Full definition → Skills API that exposes Notion pages in the standard Agent Skills folder format, so a skill authored in Notion works in any compatible agent, not only this CLI.
Two install paths exist: `npx skills add notion` browses every skill pack shared with you for bulk install, or `npx skills add <page-url>` installs a single skill by its Notion page URL directly.
Terms in this piece · Glossary
AI agent — An AI system that doesn't just answer once but works toward a goal in a loop — taking actions, reading the results, and deciding what to do next.
agent skill — A reusable instruction file that teaches an agent how to do one job well — the procedure, the tools, and what counts as done.
token — The chunk of text a model reads and writes in — roughly three-quarters of a word — and the unit AI usage is billed in.
Why it matters
The skills CLI can now install agent skills directly from Notion pages via a new Agent Skills API, letting teams author and update reusable skills without a Git repository.
