notion-known-pitfalls
Pass
Audited by Gen Agent Trust Hub on Sep 12, 2026
Risk Level: SAFE
Full Analysis
- [SAFE]: The skill provides documentation and helper functions to address common Notion API implementation errors such as missing pagination, rate limiting, and incorrect ID formats.
- [SAFE]: Secret management follows industry best practices by explicitly instructing developers to use environment variables (e.g.,
NOTION_TOKEN,NOTION_TASKS_DB) rather than hardcoding credentials or identifiers in source code. - [SAFE]: All identified dependencies, such as
@notionhq/client(Node.js) andnotion-client(Python), are official and well-known SDKs for the Notion platform. - [COMMAND_EXECUTION]: The skill provides a shell script in
references/examples.mddesigned for local codebase diagnostics. The script uses standardgrepcommands to scan project files for unsafe patterns like hardcoded UUIDs or non-paginated API calls. This is consistent with the skill's stated purpose of debugging and reviewing code.
Audit Metadata