Who it is forA writer or reviewer who has an HTML document, possibly edited by hand or by an agent, and needs to confirm it still follows the Notion-style template before it goes out.
The problemHand edits and agent output can quietly add shadows, gradients, inline styles, or classes that are not in the template, breaking the consistent look.
The outcomeA list of errors such as css-drift or unknown-class for the file, so the author can fix each one by picking from the template's block set.
What you need first
- Codex or Claude Code installed
- Python 3 available as python3 for the lint script
- A local clone of heyman333/agent-notion-template-docs when running lint.py directly
Steps
- Clone the repo with
git clone https://github.com/heyman333/agent-notion-template-docsand change into the folder. (inferred, check the README) - Run
python3 skills/notion-doc/lint.py mydoc.htmlwith the path to your document. - Read each ERROR line, which names the rule such as css-drift or unknown-class.
- Replace new CSS, inline styles, or invented classes with blocks from the template.
- Run the same lint command again until the file reports no errors.
Prompt for your agent
In the cloned heyman333/agent-notion-template-docs repo, run `python3 skills/notion-doc/lint.py <path-to-document>.html` and fix every ERROR it reports by using only classes and CSS from skills/notion-doc/template.html. Save the corrected file in place. Verify that the final lint run prints no ERROR lines for that file.
Caveat. The linter checks against template.html only, so a document can pass lint and still need a human review for content and tone.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for heyman333/agent-notion-template-docs and "Check an HTML document for style drift before sharing it"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer