skilld
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.

Ask your Agent

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

This session only. Nothing lands on disk.

referencelearning-database.md

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

Learning/Post-Mortem Database

Purpose: Capture learnings from incidents, projects, or experiences.

Schema

Property Type Options Purpose
Title title - Event or project name
Date date - When it happened
Type select Incident, Project, Experiment, Retrospective Learning type
Severity select Critical, Major, Minor Impact level (for incidents)
Team people - Who was involved
Key Learnings number - Count of learnings
Action Items relation Links to tasks Follow-up actions

Content Template

Each learning page should include:

  • What Happened: Situation description
  • What Went Well: Success factors
  • What Didn't Go Well: Problems encountered
  • Root Causes: Why things happened
  • Learnings: Key takeaways
  • Action Items: Improvements to implement

Best Practices

  1. Blameless approach: Focus on systems and processes, not individuals
  2. Document quickly: Capture while memory is fresh
  3. Identify root causes: Go beyond surface-level problems
  4. Create action items: Turn learnings into improvements
  5. Follow up: Track that action items are completed
  6. Share widely: Make learnings accessible to entire team

Source: SKILL.md on GitHub

Third-party checks

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

Provenance

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

Capability

metadata
{
  "short-description": "Capture conversations into structured Notion pages"
}

Topics

README badge

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

What it does

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.

Frequently asked

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.