How to build Instructions and Skills that supercharge your Notion Agent (full walkthrough)

By Notion

Categories: Product, Tools

Summary

Notion's Instructions and Skills system transforms generic AI agents into personalized powerhouses by separating persistent preferences (Instructions) from reusable task automation (Skills). The key: Instructions apply universally to all chats, while Skills function as saved prompts for repetitive tasks—if you'd copy-paste the same prompt twice, it's a candidate for a Skill.

Key Takeaways

1. Instructions should be universal, personal, and low-maintenance—applying to everything without needing frequent changes. Start with what you want, not what you don't want (e.g., 'use checklists for action items' vs. 'don't use paragraphs').
2. Skills are saved prompts for repeatable, contextual, consistent tasks. The litmus test: if you'd copy-paste the same prompt twice, build it as a Skill. Examples include 'extract action items,' 'turn into project plan,' or 'draft Slack update.'
3. An effective Skill page requires five structural components: outlined goal, list of inputs, ordered instructions, output guidelines, and a defined quality bar or constraints that specify what the Skill shouldn't do.
4. Instructions and Skills are distinct from Custom Agents, which are autonomous multi-step agents with separate instructions. Your Notion Agent can only have one active Instructions page at a time but unlimited Skills.
5. Skills are shareable like any Notion page—create once, share with your team, and teammates can immediately add and run them in their Notion Agent. This enables scalable prompt distribution across organizations.

Topics

• Notion Agent Personalization
• AI Agent Instructions Framework
• Reusable Prompt Automation
• Custom AI Skills Design
• Agentic AI Workflow Optimization

Transcript Excerpt

Your Notion Agent is already pretty smart. It has access to the best AI models in the world. But what makes your Notion Agent special isn’t just how it works. It’s how it works specifically for you. Instructions are persistent preferences that tell your Notion Agent how to respond. Think of them as your Notion Agent’s default mode. They can include your preferred tone, formatting, and other rules you always want followed. Your agent uses your active instructions page in every chat. Instructions ...