{
 "schema_version": 1,
 "generated": "2026-10-24",
 "id": "heyman333-agent-notion-template-docs--lint-html-docs-against-template",
 "repo": "heyman333/agent-notion-template-docs",
 "repo_url": "https://github.com/heyman333/agent-notion-template-docs",
 "repo_slug": "heyman333-agent-notion-template-docs",
 "title": "Check an HTML document for style drift before sharing it",
 "page_title": "How to check an HTML document for style drift before sharing it with Agent Notion Template Docs",
 "summary": "Run lint.py on an HTML file to catch new CSS, inline styles, or invented classes.",
 "who": "A 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.",
 "problem": "Hand edits and agent output can quietly add shadows, gradients, inline styles, or classes that are not in the template, breaking the consistent look.",
 "outcome": "A 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.",
 "steps": [
  "Clone the repo with `git clone https://github.com/heyman333/agent-notion-template-docs` and change into the folder. (inferred, check the README)",
  "Run `python3 skills/notion-doc/lint.py mydoc.html` with 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."
 ],
 "agent_prompt": "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.",
 "agents": [
  "any"
 ],
 "difficulty": "Intermediate",
 "time": "15 minutes",
 "basis": "readme",
 "caveat": "The linter checks against template.html only, so a document can pass lint and still need a human review for content and tone.",
 "category": "Work and operations",
 "tags": [
  "Work and operations"
 ],
 "lang": "python",
 "requirements": [
  "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"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": false,
 "score": 0.9,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/heyman333-agent-notion-template-docs/lint-html-docs-against-template/",
 "md": "https://dedupedai.com/use-cases/heyman333-agent-notion-template-docs/lint-html-docs-against-template/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/heyman333-agent-notion-template-docs--lint-html-docs-against-template.json",
 "api_version": "v1"
}