Przejdź do treści
Biblioteka skilli
Dokumenty i biuro · Integracja z narzędziem

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.

Repozytorium
agent-skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
19.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
8
Skrypty
1
Komentarze HTML
4
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 19.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 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

  1. Current MCP Reality
  2. Activation Conditions
  3. Practical Workflow
  4. Operational Notes
  5. Documentation Stack Reference
  6. Cross-Client Portability
  7. MCP Availability And Fallback
  8. Anti-Patterns
  9. Verification Protocol
  10. References & Resources
Sekcje z nagłówków SKILL.md, w oryginale · 106 linii, 774 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.