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 ericwang915/PythonClaw --skill notiongit clone --depth 1 https://github.com/ericwang915/PythonClawWrote 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/ericwang915/pythonclaw/notion)<a href="https://agentmods.dev/skills/ericwang915/pythonclaw/notion"><img src="https://agentmods.dev/badge/skills/ericwang915/pythonclaw/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/ericwang915/pythonclaw/notion"><img src="https://agentmods.dev/badge/skills/ericwang915/pythonclaw/notion.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
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.00078 | $0.00609 |
| Opus 5.5 | $0.00031 | $0.00244 |
| Sonnet 5.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 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.
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.
- 1mo ago First seen · 100 lines · 78 tokens per session scan A f73f1ac9cae4
notion is a skill published in the GitHub repository ericwang915/PythonClaw (45 stars, last pushed 10d ago), licensed MIT. It adds 78 tokens to every session and 609 once invoked, about $0.0003 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-30.
Other skills, from other repositories
feishu-doc-extended
An extended Feishu document assistant. Feishu is a workplace collaboration platform with online documents and tables; this skill can upload and place images and create tables after user confirmation.
form-filling
Fill out online forms (Google Forms, Typeform and similar) or PDF, Word and DocuSign forms; prepare a reviewable draft and get approval before submitting or sending.
youdaonote
A command-line skill for managing Youdao Cloud Notes, a Chinese note-taking service. It supports notes, to-do items, saved web pages, searches, and folders.
reminder
A personal reminder tool for the current chat. It can create, list, and cancel reminders that send a message back to this conversation.
telegram-chat-admin
A Telegram group administration tool for checking members and administrators before changing group settings.
google-workspace
Gmail, Calendar, Drive, Contacts, Sheets, and Docs integration via gws CLI (googleworkspace/cli). Uses OAuth2 with automatic token refresh via bridge script. Requires gws binary.