notion-doc plugin
Plugin that styles agent documents in a Notion look: one HTML template, blocks, themes and a linter against invented CSS.
- 107 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- A hook runs the `notion-doc-lint.py` script after the agent writes files; the script is local and reads only the call payload.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/notion-docDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- A hook runs the `notion-doc-lint.py` script after the agent writes files; the script is local and reads only the call payload.
This is third-party code. Review the repository files before installing.
What it does
notion-doc handles presentation only: the agent still decides the content and structure of the document. The skill copies `template.html` and fills it in without writing CSS: 720 px content width, `#2C2C2B` text colour, Notion light and dark palettes as variables. The template has page icons, tags, breadcrumbs, callouts in five colours, a table of contents, tables, two columns, `<details>` toggles, checklists, quotes, bookmarks and code blocks highlighted with Prism. The theme follows the viewer setting and switches to light for print and PDF export. `lint.py` catches CSS drift and classes outside the template, and a hook checks every written file.
Who it is for. Anyone asking an agent for a report, postmortem or note who wants tidy HTML instead of template gradients.
Good fit when
- An incident postmortem comes out as a finished HTML document with callouts and a table of contents.
- A report must be printed or saved to PDF in the light theme.
- Korean text must not break in the middle of words.
- A team wants one document look across different agents.
Not a fit when
- A custom brand style is needed instead of the Notion look.
- The document has to live in Notion itself rather than in an HTML file.
- A page structure invented in advance is needed, and the skill does not set one.
Example request
Write a postmortem for yesterday's incident as a Notion-style document: callouts for causes, an action checklist, a table of contents.Limitations
The skill creates no content or structure, only presentation. A class outside the template or edited CSS is rejected by the linter. With a manual install the lint hook is not wired up by itself and is added to `hooks.json`. For Cursor, Gemini CLI and other agents there are only ready snippets for rule files. Line breaking is tuned for Korean text (`word-break: keep-all`), so check the look for other languages. Last commit in October 2026.
How to disable. In Claude Code run `/plugin uninstall notion-doc@agent-notion-template-docs`. For a manual copy, delete `skills/notion-doc` and remove the hook entry from `hooks.json`.
FAQ
How do I invoke the skill explicitly?
With `$notion-doc` in Codex and `/notion-doc:notion-doc` in Claude Code. It usually turns on by itself when a document is requested.
What does the linter catch?
CSS that differs from the template and classes missing from the block dictionary. Run `python3 skills/notion-doc/lint.py mydoc.html`.
How does dark mode work?
It follows the viewer theme. For print and PDF export the document returns to the light palette.
Does the plugin suit Cursor?
Ready snippets exist for `.cursor/rules`, `AGENTS.md` and `GEMINI.md`. The lint hook is available only in Codex and Claude Code.
Can the skill be installed by hand?
Yes. Copy `skills/notion-doc` into the agent skills directory and add the lint hook to `hooks.json`: it does not connect by itself with a manual copy.
Discussion
No questions or reviews yet.
Related
PluginsA skill that typesets resumes, one-pagers, letters, reports and slides from templates into PDF, PNG and PPTX and checks the result before delivery
A skill to convert Markdown to Word and back through Pandoc with ready styling templates and Lua filters
A plugin with three skills that learns your Word, PowerPoint or Excel template and generates new documents in the same brand style
Skill turns the agent into a deck producer: brief, storyboard, slide posters, QA and a PDF or editable PPTX.
A document pipeline skill: anything to markdown, markdown to clean html and publisher-grade docx, and html back to markdown
Two skills for Nuxt documentation: one builds a Docus site for a project, the other audits finished pages and writes a report.
README in short
The agent invents no CSS and fills one approved template, and the linter notices any deviation.