Agent skill

Notion

by refly-ai in refly-ai/refly-skills

Integrate with Notion for knowledge management and collaboration.

No licenceAuto-check passed

Install Notion

skills CLI
$ npx skills add refly-ai/refly-skills --skill notion -a claude-code

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

GitHub CLI
$ gh skill install refly-ai/refly-skills 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/refly-ai/refly-skills.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/

Facts

Skill name
notion
GitHub stars
204
Token cost
~275 tokens
SKILL.md length
63 words
Files
2
Skills in repo
48
Repo updated
First seen
Licence
None found

At a glance

Integrate with Notion for knowledge management and collaboration.

  • Create and update Notion pages and databases
  • SKILL.md covers Installation and Usage
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Search and query database content

What it does

Notion is an agent skill from refly-ai/refly-skills. Integrate with Notion for knowledge management and collaboration. Use when you need to: (1) create and update Notion pages and databases, (2) search and query database content, (3) manage page properties and relations, or (4) organize workspace content and structure.

Its SKILL.md is about 280 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `README.md`).

It works with Notion. The repository describes itself as: Refly skills repository.

When your agent uses it

  • Create and update Notion pages and databases
  • Search and query database content
  • Manage page properties and relations
  • Organize workspace content and structure

Example prompts

  • “/notion”

What it can do on your machine

Read from SKILL.md and the folder at commit 5a546d2. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Notion loads about 275 tokens when it runs. Until then it costs about 69 tokens; SKILL.md has 63 words of instructions outside code blocks.

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

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 63 words (~275 tokens).

“Integrate with Notion for knowledge management and collaboration. Use when you need to: (1) create and update Notion pages and databases, (2) search and query database content, (3) manage page properties and relations, or (4) organize workspace content and structure.”

— opening of SKILL.md by refly-ai
name
notion
skillId
skp-vlqedjjgqciz6kuyllu6ls3w
workflowId
c-dk9dgpbtk2tm0ov2awozzcv1
triggers
- notion - notion page - notion database - knowledge base
tags
- productivity - knowledge - database - collaboration
version
1.0.0

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in skills/notion of refly-ai/refly-skills.

  • SKILL.md
  • README.md

Open the folder on GitHubat commit 5a546d2

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
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Notion this skillrefly-ai/refly-skills204—~275Automated safety check: PassNone
Code Design Rationale Investigatorcursor/plugins10k9 repos~2.6kAutomated safety check: PassNone
Xiaohei Chinese Article Illustrationshelloianneo/ian-xiaohei-illustrations12k3 repos~470Automated safety check: WarnMIT
ComposioComposioHQ/composio30k1 repos~1.7kAutomated safety check: PassMIT
Debug SkillTypeCellOS/BlockNote10k—~1.8kAutomated safety check: PassCustom licence
Marketing PlanNexus-JPF/note-companion8705 repos~5.2kAutomated safety check: PassMIT

Similar skills

  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    10k GitHub starsUsed in 9 repos~2.6k tokens
    DevelopmentAuto-check passed
  • 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 today
    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 today
    Frontend & DesignAuto-check passed

More from refly-ai/refly-skills

All 48 skills in this repo
  • Airtable

    refly-ai/refly-skills

    Integrate with Airtable for database management. An agent skill from refly-ai/refly-skills.

    204 GitHub stars~493 tokensUpdated 2 mo ago
    Auto-check passed
  • Apollo

    refly-ai/refly-skills

    Search sales leads with Apollo.io. An agent skill from refly-ai/refly-skills.

    204 GitHub stars~470 tokensUpdated 2 mo ago
    Auto-check passed
  • Asana

    refly-ai/refly-skills

    Integrate with Asana for task management. An agent skill from refly-ai/refly-skills.

    204 GitHub stars~470 tokensUpdated 2 mo ago
    Auto-check passed
  • Excel

    refly-ai/refly-skills

    Integrate with Microsoft Excel for spreadsheets. An agent skill from refly-ai/refly-skills.

    204 GitHub stars~545 tokensUpdated 2 mo ago
    Auto-check passed
  • Fal Audio

    refly-ai/refly-skills

    Generate AI audio using Fal.ai audio models. An agent skill from refly-ai/refly-skills.

    204 GitHub stars~602 tokensUpdated 2 mo ago
    Auto-check passed
  • Fal Image

    refly-ai/refly-skills

    Generate AI images using Fal.ai Flux models. An agent skill from refly-ai/refly-skills.

    204 GitHub stars~847 tokensUpdated 2 mo ago
    Auto-check passed

Works with

Questions about Notion

What does Notion do?

Integrate with Notion for knowledge management and collaboration. Notion is an agent skill from refly-ai/refly-skills. Integrate with Notion for knowledge management and collaboration.

When should I use Notion?

Notion fits situations like: create and update Notion pages and databases; search and query database content; manage page properties and relations; organize workspace content and structure.

How do I install Notion in Claude Code?

Run `npx skills add refly-ai/refly-skills --skill notion -a claude-code`. Or copy the skill folder (skills/notion in refly-ai/refly-skills) 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 refly-ai/refly-skills --skill notion -a codex`. Or copy the skill folder (skills/notion in refly-ai/refly-skills) 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 refly-ai/refly-skills --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?

SKILL.md names no scripts, command-line tools or credentials: Notion is instructions for the agent only.

Does Notion access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. 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?

No licence was found for Notion or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Notion use?

About 275 tokens (SKILL.md is roughly 1.1k 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: Code Design Rationale Investigator (cursor/plugins, 10k stars), Xiaohei Chinese Article Illustrations (helloianneo/ian-xiaohei-illustrations, 12k stars), Composio (ComposioHQ/composio, 30k stars) and Debug Skill (TypeCellOS/BlockNote, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Notion?

refly-ai (a GitHub organization) maintains it in refly-ai/refly-skills, which has 204 GitHub stars. The repository holds 48 skills in this directory. The repository was last updated on July 20, 2026.

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