Agent Skill
Notion API skill
notion-apiintellectronica/agent-skillsplugins/notion-api/skills/SKILL.md
This skill provides comprehensive instructions for interacting with the Notion API via REST calls. This skill should be used whenever the user asks to interact with Notion, including reading, creating, updating, or deleting pages, databases, blocks, comments, or any other Notion content. The skill covers authentication, all available endpoints, pagination, error handling, and best practices.
always on
77 tokname + description
once used
4,028 tokSKILL.md body
bundled files
436 KB
installs
92kskills.sh
Install the Notion API skill
Skills CLI (Claude Code, Codex, Cursor and others)
npx skills add https://github.com/intellectronica/agent-skills --skill notion-api
Claude Code, by hand (all projects)
git clone --depth 1 https://github.com/intellectronica/agent-skills.git /tmp/agent-skills mkdir -p ~/.claude/skills cp -R /tmp/agent-skills/plugins/notion-api/skills ~/.claude/skills/notion-api
For one project only, copy the folder into .claude/skills/ in that project instead. The agent picks it up when a task matches its description.
What it costs your context
Agent Skills load in three steps. Tokens counted with the o200k tokenizer; your model's count will differ a little.
| When | What loads | Cost |
|---|---|---|
| Every session | Name and description | 77 tok |
| When the agent uses it | The SKILL.md instructions | 4,028 tok |
| Only if opened | 4 bundled files (36 KB) | varies |
Until it is used, notion-api costs about 18× less than the median MCP server we measured (1,362 tokens on every turn). Installing all 44 skills from intellectronica/agent-skills would load 3,100 tokens of descriptions. Skills vs MCP study
Checks
- The name doesn't match its folder name, as the specification requires.
Checked 2026-10-22 · method
What's inside
The headings of its SKILL.md. Read the full file on GitHub.
- Notion API Skill
- Authentication
- API Key Handling
- Request Headers
- Verifying Authentication
- Base URL and Conventions
- Rate Limits
- Request Size Limits
- Confirmation for Destructive Operations
- Core API Endpoints
- Search
- Pages
- Blocks (Page Content)
- Databases
- Data Sources (API v2025-09-03+)
- Users
- Comments
- Pagination
- Error Handling
- Best Practices
- References
More skills from intellectronica/agent-skills
- anki-connectintellectronica/agent-skills
This skill is for interacting with Anki through AnkiConnect, and should be used whenever a user asks to interact with Anki, including to read or modify decks, notes, cards, models, media, or sync operations.
29649 tok idle · 2,478 in use - beautiful-mermaidintellectronica/agent-skills
Render Mermaid diagrams as SVG and PNG using the Beautiful Mermaid library. Use when the user asks to render a Mermaid diagram.
296228 tok idle · 1,150 in use - context7intellectronica/agent-skills
Retrieve up-to-date documentation for software libraries, frameworks, and components via the Context7 API. This skill should be used when looking up documentation for any programming library or framework, finding code examples for specific APIs or features, verifying correct usage of library functions, or obtaining current information about library APIs that may have changed since training.
29668 tok idle · 698 in use - copilot-sdkintellectronica/agent-skills
This skill helps with GitHub Copilot SDK work across Node.js/TypeScript, Python, Go, .NET, and Java. It covers setup, authentication, permissions, streaming events, custom tools, custom agents, MCP servers, hooks, skills, and session persistence.
29659 tok idle · 2,846 in use - gog-cliintellectronica/agent-skills
Use this skill whenever the user wants to operate Google Workspace from the command line with gog/gogcli, including Gmail, Calendar, Drive, Docs, Sheets, Slides, Forms, Apps Script, Chat, Classroom, Contacts, Tasks, People, Groups, Admin, Keep, auth, configuration, scripting, or agent-safe Google automation. Prefer this skill for Google account/file/mail/calendar work when the user mentions gog, gogcli, Google CLI, Gmail search/send, Calendar events, Drive files, Docs/Sheets/Slides editing, Forms, Apps Script, Workspace admin, or command-line Google automation.
296124 tok idle · 2,108 in use - gpt-image-1-5intellectronica/agent-skills
Generate and edit images using OpenAI's GPT Image 1.5 model. Use when the user asks to generate, create, edit, modify, change, alter, or update images. Also use when user references an existing image file and asks to modify it in any way (e.g., "modify this image", "change the background", "replace X with Y"). Supports text-to-image generation and image editing with optional mask. DO NOT read the image file first - use this skill directly with the --input-image parameter.
2961114 tok idle · 1,542 in use - here-be-gitintellectronica/agent-skills
Initialise a git repository with optional agent commit instructions and .gitignore. Use when users say "here be git", "init git", "initialise git", or otherwise indicate they want to set up version control in the current directory.
29652 tok idle · 712 in use - lorem-ipsumintellectronica/agent-skills
Generate lorem ipsum placeholder text. This skill should be used when users ask to generate lorem ipsum content, placeholder text, dummy text, or filler text. Supports various structures including plain paragraphs, headings with sections, lists, and continuous text. Output can be saved to a file or used directly as requested by the user.
296169 tok idle · 1,054 in use