All skills
openai avatar

/notion-knowledge-capture

@136d58a official
by openaiopenai/skills28k stars
1,891

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

Use this Skill: https://skilld.dev/gh/openai/skills/notion-knowledge-capture

This session only. Nothing lands on disk.

referencedocumentation-database.md

≈687 tokens on demand. Your agent reads this file only when SKILL.md points to it.

General Documentation Database

Purpose: Store all types of documentation in a searchable, organized database.

Schema

Property Type Options Purpose
Title title - Document name
Type select How-To, Concept, Reference, FAQ, Decision, Post-Mortem Categorize content type
Category select Engineering, Product, Design, Operations, General Organize by department/topic
Tags multi_select - Additional categorization (languages, tools, topics)
Status select Draft, In Review, Final, Deprecated Track document lifecycle
Owner people - Document maintainer
Created created_time - Auto-populated creation date
Last Updated last_edited_time - Auto-populated last edit
Last Reviewed date - Manual review tracking

Usage

Create pages with properties:
{
  "Title": "How to Deploy to Production",
  "Type": "How-To",
  "Category": "Engineering",
  "Tags": "deployment, production, DevOps",
  "Status": "Final",
  "Owner": [current_user],
  "Last Reviewed": "2025-10-01"
}

Views

By Type: Group by Type property By Category: Group by Category property
Recent Updates: Sort by Last Updated descending Needs Review: Filter where Last Reviewed > 90 days ago Draft Docs: Filter where Status = "Draft"

Creating This Database

Use Notion:notion-create-database:

{
  "parent": {"page_id": "wiki-page-id"},
  "title": [{"text": {"content": "Team Documentation"}}],
  "properties": {
    "Type": {
      "select": {
        "options": [
          {"name": "How-To", "color": "blue"},
          {"name": "Concept", "color": "green"},
          {"name": "Reference", "color": "gray"},
          {"name": "FAQ", "color": "yellow"}
        ]
      }
    },
    "Category": {
      "select": {
        "options": [
          {"name": "Engineering", "color": "red"},
          {"name": "Product", "color": "purple"},
          {"name": "Design", "color": "pink"}
        ]
      }
    },
    "Tags": {"multi_select": {"options": []}},
    "Owner": {"people": {}},
    "Status": {
      "select": {
        "options": [
          {"name": "Draft", "color": "gray"},
          {"name": "Final", "color": "green"},
          {"name": "Deprecated", "color": "red"}
        ]
      }
    }
  }
}

Best Practices

  1. Start with this schema - most flexible for general documentation
  2. Use relations to connect related docs
  3. Create views for common use cases
  4. Review properties quarterly - remove unused ones
  5. Document the schema in database description
  6. Train team on property usage and conventions

Source: SKILL.md on GitHub

1 warning16d5 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    This skill allows for the structured capture of conversations and notes into Notion pages. While it processes user-provided data, this is consistent with its intended documentation purpose. The skill follows established patterns for service integration.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

  • Runlayer7mo

    16/16 files flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 136d58a. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Activeupdated 10 months ago
metadata
{
  "short-description": "Capture conversations into structured Notion pages"
}

README badge

README badge for openai/skills/notion-knowledge-capture

Captures conversations and notes into structured Notion pages for team wikis, how-tos, decision logs, and FAQs. Uses Notion MCP to fetch context, create pages with proper schemas, and link related records across databases.

Generated from the current SKILL.md.

Does this skill work with any Notion workspace, or do I need specific setup?
You need to connect the Notion MCP (Codex integration) first using OAuth. The skill includes setup instructions; if the MCP is not connected, it will pause and guide you through `codex mcp add notion` and login.
What types of content can I capture with this skill?
The skill supports decisions, how-to guides, FAQs, wiki/concept entries, learning notes, and documentation pages. It provides templates and schemas for each type in the `reference/` directory.
Can I update an existing Notion page or does this only create new ones?
You can do both. The skill can search and fetch existing pages with `Notion:notion-search` and `Notion:notion-fetch`, then update them via `Notion:notion-update-page` if you're revising prior content.
How does this skill handle linking and cross-references?
After creating or updating a page, the skill adds relations and backlinks to hub pages, related specs, and team records, then updates status and owner fields as the source evolves.
Do I need to know the Notion database schema beforehand?
No. The skill includes reference guides for each database type (team wiki, how-to, FAQ, decision log, etc.) that show required properties like title, tags, owner, and status.

Generated from the current SKILL.md. These answers refresh after source changes.