humanizer-gate

name	humanizer-gate
description	Enforcement gate for all external prose. Strips AI slop patterns and calibrates to user voice before commits, PRs, docs, and chat summaries.
version	1.1.0
platforms	["linux","macos","windows"]
metadata	{"hermes":{"tags":["humanizer","prose","writing","quality","slop-filter","enforcement"],"related_skills":["humanizer","complexity-triage","local-model-router"]}}

Humanizer Gate

Intercept all human-facing writes and filter through the humanizer gateway.

When to trigger

Before ANY of these writes:

• Git commit messages
• GitHub PR titles and descriptions
• Documentation files (README, CHANGELOG, guides)
• Chat summaries sent to the user

When to skip (bypass)

• Internal dispatch prompts to the coding engine
• Kanban task notes and internal status updates
• Cron job output (internal)
• Any context where --bypass is appropriate

Dispatch

terminal(
    command="python3 ~/.hermes-coder/scripts/humanizer_gateway.py --text '<draft>' --type commit --repo '<project-dir>'",
    workdir="~/.hermes-coder",
    timeout=180
)

For longer text, pipe via stdin:

terminal(
    command="echo '<draft>' | python3 ~/.hermes-coder/scripts/humanizer_gateway.py - --type doc --repo '<project-dir>'",
    workdir="~/.hermes-coder",
    timeout=180
)

Artifact type behavior

Type	Behavior
commit	Aggressive: lowercase, active verb, strip all fluff, max 72 chars
pr	Moderate: preserve template structure, strip body fluff
doc	Full: voice calibration + LLM anti-AI pass (via claude -p) + rule filtering
chat	Light: strip obvious slop, preserve conversational tone

LLM pass (default harness)

The LLM anti-AI pass runs through the default coding harness (claude -p), not a local model. Local models are intentionally not used for this work (see SOUL.md). Because the pass shells out to the harness it can take longer than a rule-only run — call with timeout=180.

Fallback (harness unavailable)

Exit code 3 means the LLM harness was unreachable (or timed out). The gateway still outputs rule-filtered text to stdout. This is safe to use — rule-based filtering catches the most egregious patterns without LLM assistance. Log a warning but do not block the write.

Integration with humanizer skill

This gate enforces the patterns documented in the creative/humanizer SKILL.md. The gateway script compiles 29 patterns into regexes for rule-based filtering. The LLM pass sends the rule-filtered draft to claude -p as a single text-in/text-out rewrite (no tools, --max-turns 2), guided by the same anti-AI tells from the SKILL.md self-check workflow.