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 agentmods add skills/ericwang915/pythonclaw/notionnpx skills add ericwang915/PythonClaw --skill notiongit clone --depth 1 https://github.com/ericwang915/PythonClawWhat 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 | $0.00078 | $0.00609 |
| Opus 5 | $0.00039 | $0.00304 |
| Sonnet 5 | $0.00016 | $0.00122 |
| Haiku 4.5 | $0.00008 | $0.00061 |
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 2d 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.
What it actually says
Notion
Use the Notion API to create, read, and update pages, databases, and blocks.
When to Use
- "Create a Notion page with my meeting notes"
- "Search my Notion for project plans"
- "Add an item to my Notion database"
- "Query my Notion task tracker"
- "Update the status of this Notion page"
When NOT to Use
- Local Markdown files: use read_file / write_file directly
- Obsidian vaults: use obsidian skill
- Trello boards: use trello skill
- Google Docs: use google_workspace skill
Setup
- Create an integration at https://notion.so/my-integrations
- Copy the API key (starts with ntn_ or secret_)
- Configure in pythonclaw.json:
"skills": {
"notion": {
"token": "ntn_your_key_here"
}
}
- Share target pages/databases with your integration
Commands
Search pages
python {skill_path}/notion_api.py search "query text"
Get a page
python {skill_path}/notion_api.py get-page <page_id>
Get page content (blocks)
python {skill_path}/notion_api.py get-blocks <page_id>
Create a page in a database
python {skill_path}/notion_api.py create-page --database <db_id> --title "New Item" --props '{"Status": "Todo"}'
Query a database
python {skill_path}/notion_api.py query-db <database_id>
Update page properties
python {skill_path}/notion_api.py update-page <page_id> --props '{"Status": "Done"}'
Append blocks to a page
python {skill_path}/notion_api.py append-blocks <page_id> --text "New paragraph content"
Notes
- Page/database IDs are UUIDs (with or without dashes)
- The API cannot set database view filters (UI-only)
- Rate limit: ~3 requests/second average
- The Notion-Version header is required for direct API calls
Resources
| File | Description |
|---|---|
notion_api.py |
Notion REST API client |
What ships with it
1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
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.
- 2d ago First seen · 100 lines · 78 tokens per session scan A f73f1ac9cae4
notion is a skill published in the GitHub repository ericwang915/PythonClaw (41 stars, last pushed 24d ago), licensed MIT. It adds 78 tokens to every session and 609 once invoked, about $0.0004 per session on Opus 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-30.
Other skills, from other repositories
typescript-expert
TypeScript and JavaScript expert with deep knowledge of type-level programming, performance optimization, monorepo management, migration strategies, and modern tooling.
antfu
Anthony Fu's opinionated tooling and conventions for JavaScript/TypeScript projects. Use when setting up new projects, configuring ESLint/Prettier alternatives, monorepos, library publishing, or when the user mentions Anthony Fu's preferences.
conventional-commits
Conventional Commits specification for consistent, machine-readable git commit messages. Use when crafting commit messages, enforcing commitlint rules, or generating changelogs/releases.
tencent-channel-community
腾讯频道(QQ频道)社区管理 skill（CLI 版）。频道创建/设置/搜索/加入/退出，成员管理/禁言/踢人，帖子发布/编辑/删除/移动/搜索，评论/回复/点赞，版块管理，分享链接解析，频道私信，加入设置管理，内容巡检，问答自动回复。涉及腾讯频道、频道帖子、频道成员相关任务时应优先使用。.
migrate-zhin-plugin-runtime
Migrate legacy Zhin.js plugins and projects to the convention-based Plugin Runtime — from usePlugin/getPlugin/addCommand/addMiddleware/addComponent/addTool/addCron/declareConfig/useContext and mutable registries to definePlugin + capability directories + Scope/Token resources. Use this whenever a Zhin plugin fails to…
zhin-audit
Audit Zhin.js monorepo for security vulnerabilities, performance bottlenecks, and architecture issues. Use when asked to "audit code", "check security", "find performance issues", "review architecture", "scan for vulnerabilities", "check memory leaks", or "review code quality".