Skills for Notion Agent
Learn what Skills are and how to create, manage, and use them in Notion Agent 🪄
Jump to FAQsSkills are saved prompts you can run with Notion Agent whenever you need them.
A Skill is a page you’ve marked as a Skill, so you can organize and share it like any other page in Notion.
Use Skills for repeatable tasks like "Proofread," "Explain," or "Reformat."
Skills are pages, so you can organize and share them like any other page in Notion.
When you select text on a page, the text selection menu includes built-in Skills like Improve writing, Proofread, Explain, and Reformat.
Any Skill you or your team has created can be added to the menu, replacing or supplementing the defaults.
Use a Skill when your task is:
Repeatable: you or your team does this often
Contextual: it should run on a specific selection or page right now
Consistent: you want the same structure or quality every time
A simple rule of thumb is that if you’d copy and paste the same prompt twice, it is a good candidate for a Skill.
Example use cases for Skills
Executive-ready rewrites (tone, length, format)
Turning meeting notes into action items or a recap email
Converting drafts into a specific template (FAQ, PRD summary, spec skeleton)
Standardizing formatting across documents (bullets, headings, style)
Go to
Settings→Notion AI→Skills.Select
+ Add a Skill.Create a new Skill page or choose an existing page.
In settings
To manage Skills, go to
Settings→Notion AI→Skills.From there, you can view your existing Skills, add new Skills, and edit Skill pages by selecting
Open page.To choose which Skills appear in the text editor, select
Add to text editor menuorRemove from text editor menunext to each Skill page.
In the text editor
Highlight any text.
Next to Skills, choose
Manage Skills.
Start with a common workflow you do weekly, like rewriting, recapping, summarizing, or formatting.
Write your Skill like a strong prompt, including the goal, inputs, constraints, and desired output format.
Make output requirements explicit, like "return 5 bullets" or "include risks and next steps."
Keep the Skill page short and link to longer references when needed.
Iterate over time by updating the Skill page as you learn what works best.
You can run Skills from a few places, depending on what you are doing.
In Notion Agent
In chat, ask Notion Agent to run a Skill by typing
@then the name of the Skill page.
In the text editor
Select a body of text, then choose a Skill from the text selection menu.
Because Skills are pages, sharing works the same way it does for any other page in Notion.
If you share a Skill with someone, they can run that Skill once they have access to the Skill page.
If they can edit the Skill page, their edits will change the Skill.
View Skills you’ve created, Skills shared with you, and Skills in your workspace by going to
Settings→Notion AI→Skills.
FAQs
Can Custom Agents use Skills?
Can Custom Agents use Skills?
Yes! Since Skills are just pages, any Custom Agent with access to a Skill page can use it.
How are Skills different from Instructions and Custom Agents?
How are Skills different from Instructions and Custom Agents?
Skills are on-demand actions you trigger when you need them, for a specific task or selection.
Instructions are persistent preferences that apply to every Notion Agent response — your "default mode."
Custom Agents are autonomous: they can run in the background, be triggered by events (like a schedule or a new page), and be shared with your team. Each Custom Agent has its own Instructions and connections.
How can I remove a Skill?
How can I remove a Skill?
Go to Settings → Notion AI → Skills. Click x Unset page as Skill next to the Skill page you want to remove.
