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.

referencefaq-database.md

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

FAQ Database

Purpose: Organize frequently asked questions with answers.

Schema

Property Type Options Purpose
Question title - The question being asked
Category select Product, Engineering, Support, HR, General Question topic
Tags multi_select - Specific topics (auth, billing, onboarding, etc.)
Answer Type select Quick Answer, Detailed Guide, Link to Docs Response format
Last Reviewed date - When answer was verified
Helpful Count number - Track usefulness (optional)
Audience select Internal, External, All Who should see this
Related Questions relation Links to related FAQs Connect similar topics

Usage

Create FAQ entries with properties:
{
  "Question": "How do I reset my password?",
  "Category": "Support",
  "Tags": "authentication, password, login",
  "Answer Type": "Quick Answer",
  "Last Reviewed": "2025-10-01",
  "Audience": "External"
}

Content Template

Each FAQ page should include:

  • Short Answer: 1-2 sentence quick response
  • Detailed Explanation: Full answer with context
  • Steps (if applicable): Numbered procedure
  • Screenshots (if helpful): Visual guidance
  • Related Questions: Links to similar FAQs
  • Additional Resources: External docs or videos

Views

By Category: Group by Category Recently Updated: Sort by Last Reviewed descending Needs Review: Filter where Last Reviewed > 180 days ago External FAQs: Filter where Audience contains "External" Popular: Sort by Helpful Count descending (if tracking)

Best Practices

  1. Use clear questions: Write questions as users would ask them
  2. Provide quick answers: Lead with the direct answer, then elaborate
  3. Link related FAQs: Help users discover related information
  4. Review regularly: Keep answers current and accurate
  5. Track what's helpful: Use feedback to improve frequently accessed FAQs

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.