notion-api

This skill provides instructions for interacting with the Notion REST API. It enables agents to read, create, update, and delete Notion pages, databases, blocks, and comments using curl and jq.

52.2K

Installs

Use cases

5/10

Quality

Is notion-api safe to install?

Review the source first

Review the source first: our audit of notion-api's source files found 1 shell command, 16 external URLs, no file writes (high risk). Every command and URL listed appears verbatim in the skill's source. The skill performs network requests to the Notion API and executes shell commands. It handles sensitive API tokens which must be protected.

How we audit skills: our security review methodology.

Who is this skill for?

Developers and AI agents requiring programmatic access to Notion workspaces.

What can you do with it?

Searching Notion pages and databases
Retrieving and updating page content
Querying database entries
Creating new pages and databases
Managing comments on pages and discussions
Listing and retrieving user information

How good is this skill?

Quality score: 5/10. The skill documentation is comprehensive, follows security best practices regarding token handling, and provides clear instructions for API interaction.

What does the skill file contain?

SKILL.md

# Notion API Skill

This skill enables interaction with Notion workspaces through the Notion REST API. Use `curl` and `jq` for direct REST calls, or write ad-hoc scripts as appropriate for the task.

## Authentication

### API Key Handling

1. **Environment Variable**: Check if `NOTION_API_TOKEN` is available in the environment
2. **User-Provided Key**: If the user provides an API key in context, use that instead
3. **No Key Available**: If neither is available, use AskUserQuestion (or equivalent) to request the API key from the user

**IMPORTANT**: Never display, log, or send `NOTION_API_TOKE...

Frequently asked questions

How does the skill handle authentication?

It checks for the NOTION_API_TOKEN environment variable, accepts a user-provided key, or prompts the user if neither is available.

What precautions exist for destructive operations?

The skill requires the agent to ask the user for confirmation before updating, deleting, archiving, or modifying database schemas.

How are rate limits managed?

The skill advises implementing exponential backoff when receiving HTTP 429 responses.

Can the skill edit or delete existing comments?

No, the API documentation provided states the API cannot edit or delete existing comments.

Data sourced from intellectronica/agent-skills on GitHub. Install counts from skills.sh. The summary and security audit are derived from the skill's source files: every command and URL listed appears verbatim in the source.

Install

Works with Claude Code, Cursor, Codex CLI, and 50+ agents.

Manual install paths per agent

Claude Code: .claude/skills/ or ~/.claude/skills/

Codex CLI: .codex/skills/ or ~/.codex/skills/

GitHub Copilot: .github/skills/ or ~/.copilot/skills/

Amp: .agents/skills/ or ~/.config/agents/skills/

Copy the skill folder (with SKILL.md) into the project or global directory.

Security audit

high risk

Commands

URLs

File I/O

The skill performs network requests to the Notion API and executes shell commands. It handles sensitive API tokens which must be protected.

View commands and endpoints

$ curl

https://api.notion.com/v1/users/me

https://api.notion.com/v1/search

https://api.notion.com/v1/pages/{page_id}

https://api.notion.com/v1/pages

https://api.notion.com/v1/pages/{page_id}/properties/{property_id}

https://api.notion.com/v1/blocks/{block_id}/children?page_size=100

https://api.notion.com/v1/blocks/{block_id}/children

https://api.notion.com/v1/blocks/{block_id}

Sourceintellectronica/agent-skills

Installs52.2K

Quality5/10

notion api productivity automation

Related skills

find-skills

2.3M

Users seeking to extend agent capabilities with specialized tools, workflows, or knowledge packages

The find-skills skill enables agents to search for, discover, and install modular packages from the open agent skills ecosystem using the Skills CLI.

highclipackage-managervercel-labs

video-edit

338.7K

Users of the RunComfy CLI who need to automate video editing tasks like restyling, background swapping, or motion transfer

The video-edit skill acts as a router for the RunComfy CLI, selecting between Wan 2.7 Edit-Video, Kling 2.6 Pro Motion Control, and Lucy Edit Restyle models based on user intent to perform video transformations.

highvideo-editingai-agentagentspace-so

lark-doc

305.2K

Users who need to automate document management, content updates, and media handling within the Lark/Feishu ecosystem

The lark-doc skill enables agents to read, create, and edit Lark (Feishu) documents, including Docx and Wiki formats. It supports content manipulation via XML or Markdown, media handling, and resource management for document covers. The skill integrates with other Lark skills by identifying and delegating operations for embedded objects like spreadsheets, databases, and mind notes.

highLarkFeishularksuite

ai-image-generation

229.9K

Developers and AI agents requiring programmatic access to diverse image generation and editing models through a unified CLI

The AI Image Generation skill provides a command-line interface for generating and editing images using the RunComfy platform. It routes requests across 11+ AI models, including FLUX 2, Google Nano Banana, OpenAI GPT Image 2, ByteDance Seedream, Alibaba Qwen, and Wan 2-7. The skill selects the appropriate model based on user intent, such as typography precision, photorealism, or speed, and executes the generation via the runcomfy CLI.

highimage-generationcliruncomfy-com