notion-api
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.
86
78%
Does it follow best practices?
Impact
100%
1.16xAverage score across 3 eval scenarios
Risky
Do not use without reviewing
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/notion-api/SKILL.mdSecurity
2 findings — 1 high severity, 1 medium severity. You should review these findings carefully before considering using this skill.
W007: Insecure credential handling detected in skill instructions
What this means
The skill handles credentials insecurely by requiring the agent to include secret values verbatim in its generated output. This exposes credentials in the agent’s context and conversation history, creating a risk of data exfiltration.
Why it was flagged
Insecure credential handling detected (high risk: 0.80). The skill primarily uses an environment variable (safe) but explicitly instructs asking for or using a user-provided API key in-context and to include it in requests (Authorization header), which can force the LLM to accept and embed secret values verbatim — an exfiltration risk.
W011: Third-party content exposure detected (indirect prompt injection risk)
What this means
The skill exposes the agent to untrusted, user-generated content from public third-party sources, creating a risk of indirect prompt injection. This includes browsing arbitrary URLs, reading social media posts or forum comments, and analyzing content from unknown websites.
Why it was flagged
Third-party content exposure detected (high risk: 0.70). The SKILL.md explicitly instructs the agent to fetch and read user-generated Notion content (e.g., "Retrieve block children", "Search", "Retrieve Comments" and blocks with external URLs/embeds) via the Notion API, which the agent is expected to interpret and can materially influence subsequent API actions—so untrusted third-party content could carry indirect prompt-injection instructions.
- Repository
- intellectronica/agent-skills
- Commit
9f7f750
- Audited
- Security analysis
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.