> **notion-knowledge-capture** — chapter 21 of 44 in [openai/skills](https://skillsdocs.com/openai/skills). > > Book (all chapters, one file): https://skillsdocs.com/openai/skills.md > Machine manifest: https://skillsdocs.com/openai/skills/.well-known/agent-skills/index.json > Install the book: `npx skills add openai/skills` > Upstream: https://github.com/openai/skills/blob/main/skills/.curated/notion-knowledge-capture/SKILL.md @ `main` > Raw bytes, no header: https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-knowledge-capture/SKILL.md > Base for relative paths: https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-knowledge-capture/ > Licence: Declared in LICENSE.txt — https://github.com/openai/skills/blob/main/skills/.curated/notion-knowledge-capture/LICENSE.txt > > Bundled files (17), referenced from this skill's directory: > - `agents/openai.yaml` — https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-knowledge-capture/agents/openai.yaml > - `assets/notion-small.svg` — https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-knowledge-capture/assets/notion-small.svg > - `assets/notion.png` — https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-knowledge-capture/assets/notion.png > - `evaluations/conversation-to-wiki.json` — https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-knowledge-capture/evaluations/conversation-to-wiki.json > - `evaluations/decision-record.json` — https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-knowledge-capture/evaluations/decision-record.json > - `evaluations/README.md` — https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-knowledge-capture/evaluations/README.md > - `examples/conversation-to-faq.md` — https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-knowledge-capture/examples/conversation-to-faq.md > - `examples/decision-capture.md` — https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-knowledge-capture/examples/decision-capture.md > - `examples/how-to-guide.md` — https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-knowledge-capture/examples/how-to-guide.md > - `LICENSE.txt` — https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-knowledge-capture/LICENSE.txt > - `reference/database-best-practices.md` — https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-knowledge-capture/reference/database-best-practices.md > - `reference/decision-log-database.md` — https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-knowledge-capture/reference/decision-log-database.md > - `reference/documentation-database.md` — https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-knowledge-capture/reference/documentation-database.md > - `reference/faq-database.md` — https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-knowledge-capture/reference/faq-database.md > - `reference/how-to-guide-database.md` — https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-knowledge-capture/reference/how-to-guide-database.md > - `reference/learning-database.md` — https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-knowledge-capture/reference/learning-database.md > - `reference/team-wiki-database.md` — https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-knowledge-capture/reference/team-wiki-database.md > > Content © its authors, served unmodified. Takedown: https://github.com/kyleledbetter/skillsdocs/issues/new?labels=takedown&title=Takedown+request --- 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 --- # 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. ### 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`. ### 5) Link and surface - 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`).