Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add alivirgo/Major-AI-Skills --skill notiongit clone --depth 1 https://github.com/alivirgo/Major-AI-SkillsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/alivirgo/major-ai-skills/notion)<a href="https://agentmods.dev/skills/alivirgo/major-ai-skills/notion"><img src="https://agentmods.dev/badge/skills/alivirgo/major-ai-skills/notion/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/alivirgo/major-ai-skills/notion"><img src="https://agentmods.dev/badge/skills/alivirgo/major-ai-skills/notion.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00022 | $0.01207 |
| Opus 5.5 | $0.00009 | $0.00483 |
| Sonnet 5.5 | $0.00004 | $0.00241 |
| Haiku 4.5 | $0.00002 | $0.00121 |
Grade A, and why
notion scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 144 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Notion Workspace & API AI Skill Guide (Claude)
Overview & Engine Architecture
Notion is a cloud workspace of pages, databases, and blocks. Programmatic control uses the Notion API (REST) with integration tokens, page parentage, and typed database properties. Claude operates as a Principal Knowledge Ops Engineer, specializing in database schema design, idempotent upserts, block append pipelines, and permission-aware integrations.
Notion Object & API Stack
┌─────────────────────────────────────────────────────────────┐
│ Notion Architecture │
│ │
│ Content Model │
│ ├── Workspace / Pages / Child pages │
│ ├── Databases (properties + rows as pages) │
│ └── Blocks (paragraph, heading, list, code, ...) │
│ │
│ API Surface │
│ ├── https://api.notion.com/v1 │
│ ├── pages / databases / blocks / users / comments │
│ └── Notion-Version header (pinned API version) │
│ │
│ Auth & Sharing │
│ ├── Internal integration token │
│ ├── Page/database sharing to the integration │
│ └── Capabilities (read/update/insert) │
└─────────────────────────────────────────────────────────────┘
Operational Capabilities & Agent Directives
- Share Before Query: Integrations only see pages/databases explicitly shared with them.
- Pin API Version: Always send
Notion-Version(e.g.2022-06-28or newer pinned version). - Property Types Matter: Match property payloads to types (
title,rich_text,select,date,status). - Idempotent Writes: Search by unique property before creating duplicate rows.
- Block Limits: Respect payload size and rate limits; paginate with
start_cursor.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 1mo ago Changed · -6 tokens per session 200fa07ebde5
- 1mo ago First seen · 144 lines · 28 tokens per session scan A 55820f17a999
notion is a skill published in the GitHub repository alivirgo/Major-AI-Skills (2 stars, last pushed yesterday), licensed MIT. It adds 22 tokens to every session and 1,207 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
notion
Notion API for creating and managing pages, databases, and blocks.
aident-loadout
Run multi-step work across apps the user connected in Aident Loadout: live action schemas, connection checks, cost preflight, and approval before side effects.
automation-flows
Use when building or fixing a no-code automation on n8n, Make, or Zapier — trigger to multi-app steps with data mapping, dedup, retries and an error path — or picking the platform by billing unit (task vs credit vs execution). NOT a typed API client in code (that is api-connector-builder), NOT a webhook receiver in…
notion-connector
Use when wiring server code or a cron job to Notion as an ops backend over its HTTP API: pushing or mirroring database rows, two-way sync without duplicates, page blocks, or an integration broken by the 2025-09-03 data-source split. NOT generic REST wiring (that is api-connector-builder), NOT inbound Notion webhook…
parsing-workflow
Parse and validate one authorized Office or PDF file version without overstating unsupported multimodal coverage.
merge-name
Suggest names for a Context Room created by merging two rooms. Use for merge-name tasks.