Who it is forA developer who installs the skill by hand in Codex instead of as a plugin and wants every agent-written HTML file checked without a manual lint step.
The problemA manual install does not include the lint hook, so agent-written documents can drift from the template without any warning.
The outcomeEach HTML file the agent writes or edits triggers the hook, which reports what needs fixing or reminds the agent to use the skill.
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
- Copy the skill with
mkdir -p ~/.agents/skills && cp -r skills/notion-doc ~/.agents/skills/for all projects. - Open
~/.codex/hooks.json, or create it if it does not exist. - Add a PostToolUse entry with matcher
Write|Edit|apply_patchthat runs/path/to/agent-notion-template-docs/hooks/notion-doc-lint.py. - Start a new Codex session so the skill and hook are picked up.
- Ask for a document and confirm the hook reports any problems in the written HTML.
Prompt for your agent
Configure Codex on this machine to run the notion-doc lint hook from the heyman333/agent-notion-template-docs repo as a PostToolUse command for Write, Edit, and apply_patch in ~/.codex/hooks.json. Keep any existing hook entries. Verify by writing a test HTML file and confirming the hook prints a lint result.
Caveat. The README says a manual install does not bring the hook along, so this JSON edit must be done by hand and the hook only covers document files, not apps or build output.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for heyman333/agent-notion-template-docs and "Run the lint hook on every HTML write in Codex"
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