Agent skill

Notion

by HybridAIOne in HybridAIOne/hybridclaw

Search, create, update, and organize Notion pages, databases, notes, and trackers through the Notion API.

MITAuto-check passed

Install Notion

skills CLI

$ npx skills add HybridAIOne/hybridclaw --skill notion -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install HybridAIOne/hybridclaw notion --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/HybridAIOne/hybridclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/notion .claude/skills/notion && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "notion" agent skill from https://github.com/HybridAIOne/hybridclaw/tree/main/skills/notion into .claude/skills/notion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "notion", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/HybridAIOne/hybridclaw/tree/main/skills/notion

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add HybridAIOne/hybridclaw --skill notion -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install HybridAIOne/hybridclaw notion --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/HybridAIOne/hybridclaw.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/notion .agents/skills/notion && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "notion" agent skill from https://github.com/HybridAIOne/hybridclaw/tree/main/skills/notion into .agents/skills/notion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "notion", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add HybridAIOne/hybridclaw --skill notion -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install HybridAIOne/hybridclaw notion --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/HybridAIOne/hybridclaw.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/notion .cursor/skills/notion && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "notion" agent skill from https://github.com/HybridAIOne/hybridclaw/tree/main/skills/notion into .cursor/skills/notion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "notion", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/HybridAIOne/hybridclaw.git --path skills/notion

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add HybridAIOne/hybridclaw --skill notion -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install HybridAIOne/hybridclaw notion --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/HybridAIOne/hybridclaw.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/notion .gemini/skills/notion && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "notion" agent skill from https://github.com/HybridAIOne/hybridclaw/tree/main/skills/notion into .gemini/skills/notion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "notion", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install HybridAIOne/hybridclaw notion

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add HybridAIOne/hybridclaw --skill notion -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/HybridAIOne/hybridclaw.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/notion .github/skills/notion && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "notion" agent skill from https://github.com/HybridAIOne/hybridclaw/tree/main/skills/notion into .github/skills/notion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "notion", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add HybridAIOne/hybridclaw --skill notion -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install HybridAIOne/hybridclaw notion --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/HybridAIOne/hybridclaw.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/notion .opencode/skills/notion && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "notion" agent skill from https://github.com/HybridAIOne/hybridclaw/tree/main/skills/notion into .opencode/skills/notion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "notion", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: notion
GitHub stars: 159
Token cost: ~759 tokens
SKILL.md length: 202 words
Files: 1
Skills in repo: 72
Repo updated: Oct 9, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Search, create, update, and organize Notion pages, databases, notes, and trackers through the Notion API.

Works in 3 steps: Create an internal integration in Notion. → Save the token outside the repo, usually… → Share the target pages or databases with…
SKILL.md covers Setup, API Basics, Common Operations and Important Notes, plus 1 more section
Calls curl; reaches api.notion.com; needs NOTION_API_KEY

What it does

Notion is an agent skill from HybridAIOne/hybridclaw. Search, create, update, and organize Notion pages, databases, notes, and trackers through the Notion API.

Its SKILL.md is about 760 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with Notion. The repository describes itself as: Enterprise-ready self-hosted AI assistant runtime with sandboxed execution, secure credentials, approvals, and memory. The licence is MIT.

Example prompts

“/notion”

Requirements

A credential in NOTION_API_KEY

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

Create an internal integration in Notion.
Save the token outside the repo, usually as NOTION_API_KEY.
Share the target pages or databases with that integration.

What it can do on your machine

Read from SKILL.md and the folder at commit 8162701. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- curl
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- api.notion.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- NOTION_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Notion loads about 759 tokens when it runs. Until then it costs about 28 tokens; SKILL.md has 202 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~28
When it runs · the whole SKILL.md, loaded when a task matches: ~759

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from HybridAIOne/hybridclaw at commit 8162701, republished under its MIT licence (© HybridAIOne). 202 words, ~759 tokens.

Download SKILL.mdSave it as .claude/skills/notion/SKILL.md (or your agent's skills folder).

name: notion
description: Search, create, update, and organize Notion pages, databases, notes, and trackers through the Notion API.
user-invocable: true

Notion Workspace Operations

Use the Notion API for page, block, and data-source work.

Setup

If NOTION_API_KEY is not already configured:

Create an internal integration in Notion.
Save the token outside the repo, usually as NOTION_API_KEY.
Share the target pages or databases with that integration.

Do not assume the integration can see a page until the user confirms sharing.

API Basics

Before API calls, write a private temp curl config and register cleanup so the Notion token stays off the shell command line and the auth file is removed on exit:

bash

AUTH_CURL="$(mktemp)"
chmod 600 "$AUTH_CURL"
trap 'rm -f "$AUTH_CURL"' EXIT INT TERM
cat >"$AUTH_CURL" <<EOF
header = "Authorization: Bearer $NOTION_API_KEY"
header = "Notion-Version: 2025-09-03"
EOF

All requests need:

bash

curl -s "https://api.notion.com/v1/..." -K "$AUTH_CURL"

Common Operations

Search:

bash

curl -s -X POST "https://api.notion.com/v1/search" \
  -K "$AUTH_CURL" \
  -H "Content-Type: application/json" \
  -d '{"query":"release notes"}'

Get page metadata:

bash

curl -s "https://api.notion.com/v1/pages/PAGE_ID" -K "$AUTH_CURL"

Get page blocks:

bash

curl -s "https://api.notion.com/v1/blocks/PAGE_ID/children" -K "$AUTH_CURL"

Query a data source:

bash

curl -s -X POST "https://api.notion.com/v1/data_sources/DATA_SOURCE_ID/query" \
  -K "$AUTH_CURL" \
  -H "Content-Type: application/json" \
  -d '{"page_size":20}'

Create a page in a database:

bash

curl -s -X POST "https://api.notion.com/v1/pages" \
  -K "$AUTH_CURL" \
  -H "Content-Type: application/json" \
  -d '{"parent":{"database_id":"DATABASE_ID"},"properties":{"Name":{"title":[{"text":{"content":"New item"}}]}}}'

Append blocks:

bash

curl -s -X PATCH "https://api.notion.com/v1/blocks/PAGE_ID/children" \
  -K "$AUTH_CURL" \
  -H "Content-Type: application/json" \
  -d '{"children":[{"object":"block","type":"paragraph","paragraph":{"rich_text":[{"text":{"content":"Hello"}}]}}]}'

Important Notes

Notion now distinguishes database_id from data_source_id.
Use database_id when creating pages.
Use data_source_id when querying data.
Read first, write second.
If you are done before the shell exits, run rm -f "$AUTH_CURL" and trap - EXIT INT TERM.

Rules

Confirm the exact parent page or database before creating content.
Show the proposed page title, properties, and key block content before writing.
Prefer databases for structured tasks, trackers, and meeting logs instead of ad hoc bullet pages.
Respect rate limits and avoid large write bursts.

Files

Just SKILL.md in skills/notion of HybridAIOne/hybridclaw.

Open the folder on GitHubat commit 8162701

Compare with similar skills

Notion next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Notion compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Notion this skillHybridAIOne/hybridclaw	159	—	~759	Automated safety check: Pass	MIT	yesterday
Xiaohei Chinese Article Illustrationshelloianneo/ian-xiaohei-illustrations	12k	3 repos	~470	Automated safety check: Warn	MIT	16 days ago
ComposioComposioHQ/composio	30k	1 repos	~1.7k	Automated safety check: Pass	MIT	yesterday
Debug SkillTypeCellOS/BlockNote	10k	—	~1.8k	Automated safety check: Pass	Custom licence	yesterday
Marketing PlanNexus-JPF/note-companion	870	5 repos	~5.2k	Automated safety check: Pass	MIT	4 days ago
Docs SkillTypeCellOS/BlockNote	10k	—	~1.9k	Automated safety check: Pass	Custom licence	yesterday

Similar skills

Xiaohei Chinese Article Illustrations
helloianneo/ian-xiaohei-illustrations
Plans and generates 16:9 hand-drawn illustrations for Chinese articles on a white background, with a recurring black character and a few red, orange and blue handwritten notes.
12k GitHub starsUsed in 3 repos~470 tokens
Media & CreativeAuto-check: warnings
Composio
ComposioHQ/composio
Route and complete Composio work across Composio For You and Composio Platform.
30k GitHub starsUsed in 1 repo~1.7k tokens
Productivity & AutomationAuto-check passed
Debug Skill
TypeCellOS/BlockNote
Instructions for navigating and debugging BlockNote in a browser.
10k GitHub stars~1.8k tokensUpdated yesterday
DevelopmentAuto-check passed
Marketing Plan
Nexus-JPF/note-companion
When the user needs a comprehensive marketing plan for a client, a company they advise, or their own product.
870 GitHub starsUsed in 5 repos~5.2k tokens
Marketing & SEOAuto-check passed
Docs Skill
TypeCellOS/BlockNote
Conventions and verification workflow for writing and restructuring the documentation site (docs/content).
10k GitHub stars~1.9k tokensUpdated yesterday
Frontend & DesignAuto-check passed
Lead Magnets
coreyhaines31/marketingskills
When the user wants to create, plan, or optimize a lead magnet for email capture or lead generation.
54k GitHub starsUsed in 5 repos~2.8k tokens
Marketing & SEOAuto-check passed

Questions about Notion

What does Notion do?

Search, create, update, and organize Notion pages, databases, notes, and trackers through the Notion API. Notion is an agent skill from HybridAIOne/hybridclaw. Search, create, update, and organize Notion pages, databases, notes, and trackers through the Notion API.

How do I install Notion in Claude Code?

Run `npx skills add HybridAIOne/hybridclaw --skill notion -a claude-code`. Or copy the skill folder (skills/notion in HybridAIOne/hybridclaw) into .claude/skills/notion in your project. Claude Code loads it when a task matches its description.

How do I install Notion in Codex?

Run `npx skills add HybridAIOne/hybridclaw --skill notion -a codex`. Or copy the skill folder (skills/notion in HybridAIOne/hybridclaw) into .agents/skills/notion in your project. Codex loads it when a task matches its description.

Can I use Notion in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add HybridAIOne/hybridclaw --skill notion -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/notion, .gemini/skills/notion, .github/skills/notion and .opencode/skills/notion in your project.

What does Notion need to run?

Going by SKILL.md and its folder, Notion needs the command-line tools its instructions call (curl) and credentials named NOTION_API_KEY. Our summary lists: A credential in NOTION_API_KEY.

Does Notion access the network?

SKILL.md names 1 domain. In commands or code: api.notion.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Notion safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Notion use?

Notion is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Notion use?

About 759 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Notion?

Skills that share tags, products or a category with Notion: Xiaohei Chinese Article Illustrations (helloianneo/ian-xiaohei-illustrations, 12k stars), Composio (ComposioHQ/composio, 30k stars), Debug Skill (TypeCellOS/BlockNote, 10k stars) and Marketing Plan (Nexus-JPF/note-companion, 870 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Notion?

HybridAIOne (a GitHub organization) maintains it in HybridAIOne/hybridclaw, which has 159 GitHub stars. The repository holds 72 skills in this directory. The repository was last updated on October 9, 2026.

Source: HybridAIOne/hybridclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Notion

Install Notion

Facts

At a glance

What it does

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Notion Workspace Operations

Setup

API Basics

Common Operations

Important Notes

Rules

Files

Compare with similar skills

Similar skills

Xiaohei Chinese Article Illustrations

Composio

Debug Skill

Marketing Plan

Docs Skill

Lead Magnets

More from HybridAIOne/hybridclaw

Hermes3000 Writing

Manim Video

Skill Creator

XLSX

Excalidraw

Google Ads

Questions about Notion

Install Notion

Facts

At a glance

What it does

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Notion Workspace Operations

Setup

API Basics

Common Operations

Important Notes

Rules

Files

Compare with similar skills

Similar skills

More from HybridAIOne/hybridclaw

Related

Questions about Notion