Official agent skill

Notion Knowledge Capture

by JetBrains in JetBrains/skills

Capture conversations and decisions into structured Notion pages; use when turning chats/notes into wiki entries, how-tos, decisions, or FAQs with proper linking.

OfficialMITAuto-check passedSales & Support

Install Notion Knowledge Capture

skills CLI
$ npx skills add JetBrains/skills --skill notion-knowledge-capture -a claude-code

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

GitHub CLI
$ gh skill install JetBrains/skills notion-knowledge-capture --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/JetBrains/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/notion-knowledge-capture .claude/skills/notion-knowledge-capture && 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-knowledge-capture
GitHub stars
366
Used in
5 other repos
Token cost
~855 tokens
SKILL.md length
376 words
Files
18 (incl. assets)
Skills in repo
76
Repo updated
First seen
Licence
MIT

At a glance

Capture conversations and decisions into structured Notion pages; use when turning chats/notes into wiki entries, how-tos, decisions, or FAQs with proper linking.

  • Works in 6 steps: If any MCP call fails because Notion MCP… → Define the capture → Locate destination → …
  • Turning chats/notes into wiki entries
  • SKILL.md covers Quick start, Workflow and References and examples
  • Calls codex; reaches mcp.notion.com

What it does

Notion Knowledge Capture is an agent skill from JetBrains/skills, published by the product's own GitHub organization. Capture conversations and decisions into structured Notion pages; use when turning chats/notes into wiki entries, how-tos, decisions, or FAQs with proper linking.

Its SKILL.md is about 860 tokens, which your agent loads only when the skill is triggered. The skill folder holds 22 other files, including assets (for example `agents/openai.yaml`, `evaluations/README.md` and `evaluations/conversation-to-wiki.json`).

It sits in Sales & Support, covering Help center and FAQ content. It works with Notion and Model Context Protocol. The repository describes itself as: Curated agent skills collection verified by JetBrains. The licence is MIT.

When your agent uses it

  • Turning chats/notes into wiki entries
  • FAQs with proper linking

Example prompts

  • “/notion-knowledge-capture”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. If any MCP call fails because Notion MCP is not connected, pause and set it up
  2. Define the capture
  3. Locate destination
  4. Extract and structure
  5. Create/update in Notion
  6. Link and surface

What it can do on your machine

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

    • codex

    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:

    • mcp.notion.com

    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 Knowledge Capture loads about 855 tokens when it runs. Until then it costs about 47 tokens; SKILL.md has 376 words of instructions outside code blocks.

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

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 JetBrains/skills at commit e0f258b, republished under its MIT licence (© JetBrains). 376 words, ~855 tokens.

Download SKILL.mdSave it as .claude/skills/notion-knowledge-capture/SKILL.md (or your agent's skills folder). This skill also uses 17 other files; get the full folder from GitHub.
name
notion-knowledge-capture
description
Capture conversations and decisions into structured Notion pages; use when turning chats/notes into wiki entries, how-tos, decisions, or FAQs with proper linking.
metadata.short-description
Capture conversations into structured Notion pages
metadata.author
OpenAI
metadata.source
https://github.com/openai/skills/tree/main/skills/.curated/notion-knowledge-capture

Knowledge Capture

Convert conversations and notes into structured, linkable Notion pages for easy reuse.

Quick start

  1. Clarify what to capture (decision, how-to, FAQ, learning, documentation) and target audience.
  2. Identify the right database/template in reference/ (team wiki, how-to, FAQ, decision log, learning, documentation).
  3. Pull any prior context from Notion with Notion:notion-search → Notion:notion-fetch (existing pages to update/link).
  4. Draft the page with Notion:notion-create-pages using the database’s schema; include summary, context, source links, and tags/owners.
  5. Link from hub pages and related records; update status/owners with Notion:notion-update-page as the source evolves.

Workflow

0) If any MCP call fails because Notion MCP is not connected, pause and set it up:
  1. Add the Notion MCP:
    • codex mcp add notion --url https://mcp.notion.com/mcp
  2. Enable remote MCP client:
    • Set [features].rmcp_client = true in config.toml or run codex --enable rmcp_client
  3. Log in with OAuth:
    • codex mcp login notion

After successful login, the user will have to restart codex. You should finish your answer and tell them so when they try again they can continue with Step 1.

1) Define the capture
  • Ask purpose, audience, freshness, and whether this is new or an update.
  • Determine content type: decision, how-to, FAQ, concept/wiki entry, learning/note, documentation page.
2) Locate destination
  • Pick the correct database using reference/*-database.md guides; confirm required properties (title, tags, owner, status, date, relations).
  • If multiple candidate databases, ask the user which to use; otherwise, create in the primary wiki/documentation DB.
Show full SKILL.md (140 more words)Show less
3) Extract and structure
  • Extract facts, decisions, actions, and rationale from the conversation.
  • For decisions, record alternatives, rationale, and outcomes.
  • For how-tos/docs, capture steps, pre-reqs, links to assets/code, and edge cases.
  • For FAQs, phrase as Q&A with concise answers and links to deeper docs.
4) Create/update in Notion
  • Use Notion:notion-create-pages with the correct data_source_id; set properties (title, tags, owner, status, dates, relations).
  • Use templates in reference/ to structure content (section headers, checklists).
  • If updating an existing page, fetch then edit via Notion:notion-update-page.
  • Add relations/backlinks to hub pages, related specs/docs, and teams.
  • Add a short summary/changelog for future readers.
  • If follow-up tasks exist, create tasks in the relevant database and link them.

References and examples

  • reference/ — database schemas and templates (e.g., team-wiki-database.md, how-to-guide-database.md, faq-database.md, decision-log-database.md, documentation-database.md, learning-database.md, database-best-practices.md).
  • examples/ — capture patterns in practice (e.g., decision-capture.md, how-to-guide.md, conversation-to-faq.md).

© JetBrains, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 17 other files (assets) in notion-knowledge-capture of JetBrains/skills.

  • SKILL.md
  • LICENSE.txt
  • agents/openai.yaml
  • assets/notion-small.svg
  • assets/notion.png
  • evaluations/README.md
  • evaluations/conversation-to-wiki.json
  • evaluations/decision-record.json
  • examples/conversation-to-faq.md
  • examples/decision-capture.md
  • examples/how-to-guide.md
  • reference/database-best-practices.md
  • reference/decision-log-database.md
  • reference/documentation-database.md
  • reference/faq-database.md
  • reference/how-to-guide-database.md
  • … and 2 more

Open the folder on GitHubat commit e0f258b

Used in 5 other repositories

We found 5 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 5 other GitHub owners. This page covers the copy in JetBrains/skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Notion Knowledge Capture 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 Knowledge Capture compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Notion Knowledge Capture this skillJetBrains/skills3665 repos~855Automated safety check: PassMIT
OpenheardHeilonng23/openheard177—~1.5kAutomated safety check: PassAGPL-3.0
Zsxqunnoo/zsxq-skill304—~3.8kAutomated safety check: PassMIT
Sales OsromangojiberryAI/gojiberryai-sales-os139—~2kAutomated safety check: PassMIT
Zach Sif Cvr Threshold Analyzerzach22-1999/amazon-skills2081 repos~982Automated safety check: NotesMIT
Claap Weekly RecapOthmane-Khadri/YALC-the-GTM-operating-system317—~5.4kAutomated safety check: PassMIT

Similar skills

  • Openheard

    Heilonng23/openheard

    Run an openheard feedback board through its MCP server - connect it, set up a workspace from a website, install the widget in this codebase, triage and dedupe feedback, reply, ship and announce…

    177 GitHub stars~1.5k tokensUpdated 5 days ago
    Sales & SupportAuto-check passed
  • Zsxq

    unnoo/zsxq-skill

    知识星球 CLI(zsxq-cli)与底层接口完整操作指南,涵盖星球和内容管理、Skill Pay 微信支付场景。当用户提到知识星球、zsxq、小密圈、星球、登录/认证、发帖、评论、回答、编辑、删除主题、定时发布/定时任务/定时回答、投票、问答主题、markdown 正文、AI…

    304 GitHub stars~3.8k tokensUpdated 18 days ago
    Sales & SupportAuto-check passed
  • Sales Os

    romangojiberryAI/gojiberryai-sales-os

    A complete outbound sales department in one skill. An agent skill from romangojiberryAI/gojiberryai-sales-os.

    139 GitHub stars~2k tokensUpdated 1 mo ago
    Sales & SupportAuto-check passed
  • Zach Sif Cvr Threshold Analyzer

    zach22-1999/amazon-skills

    基于领星 ASIN 360 或同类日业务报表,以及用户自己 SIF MCP 导出的日级关键词自然排名 JSON,回测 CVR 与核心词/稳定词自然排名波动的关系,并输出观察线、危险线、广告 CVR 确认线。

    208 GitHub starsUsed in 1 repo~982 tokens
    Sales & SupportAuto-check: notes
  • Claap Weekly Recap

    Othmane-Khadri/YALC-the-GTM-operating-system

    Turns a week of Claap-recorded sales calls into action items and focus blocks on a Notion Kanban, delivered with a Slack summary.

    317 GitHub stars~5.4k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed
  • Call Prep

    breakstageaxe61/genspark-claw

    Prepare an AI phone call end-to-end — research the callee, set a concrete objective and fallback, draft a natural call script with branching, and produce a post-call summary template.

    159 GitHub stars~986 tokensUpdated 13 days ago
    Sales & SupportAuto-check passed

More from JetBrains/skills

All 76 skills in this repo
  • Playwright

    JetBrains/skills

    Official

    A skill your agent uses when the task requires automating a real browser from the terminal (navigation, form filling, snapshots, screenshots, data extraction, UI-flow debugging) via playwright-cli…

    366 GitHub starsUsed in 11 repos~986 tokens
    Auto-check passed
  • Skill Creator

    JetBrains/skills

    Official

    Guide for creating effective skills. An agent skill from JetBrains/skills.

    366 GitHub starsUsed in 122 repos~4.7k tokens
    Auto-check passed
  • Transcribe

    JetBrains/skills

    Official

    Transcribe audio files to text with optional diarization and known-speaker hints.

    366 GitHub starsUsed in 4 repos~776 tokens
    Auto-check passed
  • Imagegen

    JetBrains/skills

    Official

    A skill your agent uses when the user asks to generate or edit images via the OpenAI Image API (for example: generate image, edit/inpaint/mask, background removal or replacement, transparent…

    366 GitHub starsUsed in 3 repos~2.5k tokens
    Auto-check passed
  • Speech

    JetBrains/skills

    Official

    A skill your agent uses when the user asks for text-to-speech narration or voiceover, accessibility reads, audio prompts, or batch speech generation via the OpenAI Audio API; run the bundled CLI…

    366 GitHub starsUsed in 3 repos~1.9k tokens
    Auto-check passed
  • Screenshot

    JetBrains/skills

    Official

    A skill your agent uses when the user explicitly asks for a desktop or system screenshot (full screen, specific app or window, or a pixel region), or when tool-specific capture capabilities are…

    366 GitHub starsUsed in 6 repos~2k tokens
    Auto-check passed

Categories

Questions about Notion Knowledge Capture

What does Notion Knowledge Capture do?

Capture conversations and decisions into structured Notion pages; use when turning chats/notes into wiki entries, how-tos, decisions, or FAQs with proper linking. Notion Knowledge Capture is an agent skill from JetBrains/skills, published by the product's own GitHub organization. Capture conversations and decisions into structured Notion pages; use when turning chats/notes into wiki entries, how-tos, decisions, or FAQs with proper linking.

When should I use Notion Knowledge Capture?

Notion Knowledge Capture fits situations like: turning chats/notes into wiki entries; FAQs with proper linking.

How do I install Notion Knowledge Capture in Claude Code?

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

How do I install Notion Knowledge Capture in Codex?

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

Can I use Notion Knowledge Capture 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 JetBrains/skills --skill notion-knowledge-capture -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-knowledge-capture, .gemini/skills/notion-knowledge-capture, .github/skills/notion-knowledge-capture and .opencode/skills/notion-knowledge-capture in your project.

What does Notion Knowledge Capture need to run?

Going by SKILL.md and its folder, Notion Knowledge Capture needs the command-line tools its instructions call (codex).

Does Notion Knowledge Capture access the network?

SKILL.md names 1 domain. In commands or code: mcp.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 Knowledge Capture 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 Knowledge Capture use?

Notion Knowledge Capture is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Notion Knowledge Capture use?

About 855 tokens (SKILL.md is roughly 3.4k 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 Knowledge Capture?

Skills that share tags, products or a category with Notion Knowledge Capture: Openheard (Heilonng23/openheard, 177 stars), Zsxq (unnoo/zsxq-skill, 304 stars), Sales Os (romangojiberryAI/gojiberryai-sales-os, 139 stars) and Zach Sif Cvr Threshold Analyzer (zach22-1999/amazon-skills, 208 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Notion Knowledge Capture?

JetBrains (a GitHub organization, an official publisher) maintains it in JetBrains/skills, which has 366 GitHub stars. The repository holds 76 skills in this directory. The repository was last updated on June 29, 2026.

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