notion-docs
/notion-docs
Zarządza przestrzenią Notion przez MCP: tworzy bazy danych, strony, komentarze i bazy wiedzy, na przykład przy dokumentacji i wiki projektowych.
- Autor
- PracticalSwan ↗
- Repozytorium
- agent-skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 19.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 8
- Skrypty
- 1
- Komentarze HTML
- 4
- Adresy URL w SKILL.md
- 1
Brak sygnałów. Repozytorium zmienione 19.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
- SKILL.md zawiera komentarze HTML (4). Nie widać ich w podglądzie Markdown, a model je czyta.
Skrypty: scripts/notion-templates.js
Co robi i kiedy
Zarządza przestrzenią Notion przez MCP: tworzy bazy danych, strony, komentarze i bazy wiedzy, na przykład przy dokumentacji i wiki projektowych.
Oryginalny opis (EN)
Notion workspace management via MCP - create databases, pages, comments, and knowledge bases. Use when building Notion documentation, organizing project wikis, or managing Notion content.
Jak działa
- Current MCP Reality
- Activation Conditions
- Practical Workflow
- Operational Notes
- Documentation Stack Reference
- Cross-Client Portability
- MCP Availability And Fallback
- Anti-Patterns
- Verification Protocol
- References & Resources
Podgląd SKILL.md
--- name: notion-docs version: "2.0" last_updated: 2026-09-08 tags: [notion, docs, writing, quality, templates] description: "Notion workspace management via MCP - create databases, pages, comments, and knowledge bases. Use when building Notion documentation, organizing project wikis, or managing Notion content." --- # Notion Documentation > Tech Stack Target / Version: Notion API current version, Markdown-to-Notion transforms, and local template scripts. Use this skill when Notion is the system of record for specs, runbooks, project tracking, or knowledge management. - Leverage native parallel subagent dispatch and 200k+ context windows where available. ## Current MCP Reality As of March 2026, Notion documents two supported ways to use its MCP server: - Hosted remote MCP endpoint: `https://mcp.notion.com/mcp` - Local stdio server package: `@notionhq/notion-mcp-server` Hosted mode uses OAuth. Local mode uses an internal integration token. Official docs also list supported tools for searching content, reading pages, comments, users, and working with pages and databases. ## Activation Conditions Use symptom -> action triggers: when one matches, apply this skill and verify with the protocol below. - Creating or updating Notion pages - Building project trackers or engineering knowledge bases - Organizing specs, ADRs, and onboarding docs in Notion - Adding review comments or using database-backed workflows ## Practical Workflow 1. Confirm whether the client exposes the hosted Notion MCP server or a local stdio connection. 2. Read or search existing pages before creating duplicates. 3. Use databases for tracked work and pages for long-form documents. 4. Keep properties simple: owner, status, last reviewed, tags. 5. If MCP is unavailable in the current client, fall back to local content prep using the included script and templates. ## Operational Notes - Official Notion guidance currently documents an average rate limit of 20 requests per second for integrations. - Tool names can vary slightly by MCP host, but the supported capabilities are stable: search, fetch page content, create or update pages, create or update databases, manage comments, and read user context. ## Documentation Stack Reference Inherit the shared stack from [documentation-patterns](../documentation-patterns/SKILL.md#shared-documentation-stack): source-of-truth discovery, audience framing, structure selection, verification, and freshness checks. Keep this skill focused on Notion conversion and workspace behavior instead of restating the full stack. <!-- MCP:START --> <!-- PORTABILITY:START --> ## Cross-Client Portability This skill is written to stay usable across GitHub Copilot, Claude Code, and Codex. - GitHub Copilot: keep the folder in a Copilot-visible skill path or wrap the workflow in project instructions when folder discovery is unavailable. - Claude Code: keep the folder in a local skills directory or a compatible plugin source. - Codex: install or sync the folder into `$CODEX_HOME/skills/notion-docs` and restart Codex after major changes. <!-- PORTABILITY:END --> ## MCP Availability And Fallback Preferred MCP Server: Notion MCP - Fallback prompt: "Use the Notion Documentation skill without MCP. Follow the documented local or manual fallback, show the selected tool surface, and report the verification evidence." - Draft content locally in Markdown or JSON, then use `scripts/notion-templates.js` and the Notion web UI for final publishing. - Prefer page and database templates from this skill to avoid duplicate structures when working without MCP. - Do not claim an MCP operation was used when the active host does not expose it. <!-- MCP:END --> ## Anti-Patterns - Writing for the author instead of the reader: It bakes in unstated context and leaves the actual audience unsure what to do next. - Skipping concrete examples or commands: Abstract guidance is easy to approve and hard to apply correctly. - Letting links, screenshots, or versions drift: Polished formatting does not help if the instructions are no longer true. ## Verification Protocol Before claiming "skill applied successfully": 1. Pass/fail: The Notion Docs output identifies audience, purpose, source of truth, and freshness requirements. 2. Pass/fail: Shared documentation-stack guidance is referenced instead of duplicating another documentation skill. 3. Pass/fail: Claims, links, commands, examples, and screenshots are verified or explicitly marked unverified. 4. Pressure-test scenario: Apply the skill to a doc request with a stale command, missing owner, and conflicting audience. 5. Success metric: Zero undocumented assumptions; every reader-facing claim is sourced or scoped. ## References & Resources ### Documentation - [Notion Markdown Spec](./references/notion-markdown-spec.md) - Notion-flavored Markdown constraints and conversion notes - [Database Properties](./references/database-properties.md) - Practical property patterns for docs and project trackers - [Notion MCP Quickstart](./references/notion-mcp-quickstart.md) - Hosted endpoint, local package, auth options, and usage notes ### Scripts - [Notion Templates](./scripts/notion-templates.js) - Local page and database template helpers for environments without Notion MCP access ### Examples - [Workspace Setup Example](./examples/workspace-setup-example.md) - Example team workspace structure using pages, databases, and review comments ## Related Skills - [documentation-authoring](../documentation-authoring/SKILL.md): Use it when the workflow also needs drafting structured technical or product documents. - [documentation-patterns](../documentation-patterns/SKILL.md): Use it when the workflow also needs reusable documentation structures and templates. - [documentation-quality](../documentation-quality/SKILL.md): Use it when the workflow also needs documentation review standards and quality gates. - [documentation-verification](../documentation-verification/SKILL.md): Use it when the workflow also needs final documentation validation before publishing.
Pliki w paczce (8)
- CHANGELOG.md 6 KB
- LICENSE.txt 1 KB
- SKILL.md 6 KB
- examples/workspace-setup-example.md 16 KB
- references/database-properties.md 13 KB
- references/notion-markdown-spec.md 8 KB
- references/notion-mcp-quickstart.md 1 KB
- scripts/notion-templates.js 8 KB
Wersje
W bazie nie ma innych skilli o nazwie notion-docs.
Migawka bazy z 13.11.2026 · wersja paczki f65bc356ed30 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 96notion
Przeszukuje, czyta, tworzy i aktualizuje strony oraz bazy danych w Notion przez API. - 100notion
Tworzy, wyszukuje i aktualizuje strony i bazy Notion przez API Notion, do dokumentowania pracy, generowania runbooków i automatyzacji bazy wiedzy. - 100notion
Tworzy, wyszukuje i aktualizuje strony i bazy Notion przez API Notion, do dokumentowania pracy, generowania runbooków i automatyzacji bazy wiedzy. - 95notion
Wyszukuje, czyta, dopisuje i tworzy strony oraz bazy danych w Notion przez REST API, na przykład przy logowaniu wpisów do bazy w przestrzeni roboczej. - 100notion
Obsługuje Notion z terminala lub agenta przez skrypt notion-cli, domyślnie tylko do odczytu, z potwierdzeniem przy każdej zmianie: strony, bazy, wyszukiwanie i właściwości. - 90notion
Czyta, szuka, zapisuje i aktualizuje treści w przestrzeni Notion przez serwer MCP z listą dozwolonych baz danych.