Human Gate runs the human-verification lane of an agent loop, ensuring a named person reviews work before it is marked done. It builds a single-file HTML review page, collects feedback as a structured artifact, and enforces a gate that refuses to close while blockers are open or review is missing.

✨ What it does

  • Builds a single-file HTML review page from Markdown/HTML artifacts.
  • Collects feedback as a structured batch.v1 artifact with severity grades (BLOCKER, MAJOR, MINOR, NIT, NOTE, APPROVE, EDI
  • Enforces gate rules G1-G7, refusing to close when no review, open blockers, unnamed reviewer, or integrity issues exist.
  • Supports explicit waivers with recorded reasons, except for G1 which is never waivable.
  • Provides non-blocking status checks and round caps with escalation.
  • Sanitizes reviewed HTML and validates quotes against raw and rendered text.

🎯 When to use it

  • When a plan, spec, RFC, report, landing page, or migration needs human sign-off before shipping.
  • When asked to get sign-off, 'have someone check this', 'hold until reviewed', or 'needs approval first'.
  • When an irreversible action requires explicit human approval.
  • When you need to prove that human review happened and objections were resolved.

🚀 How to use

Trigger by asking for human sign-off or approval on an artifact. The skill expects an artifact file (Markdown/HTML) and a named reviewer. Use the provided scripts: open, status, collect, and close. Example prompts:

Get sign-off on plan.md from Reza.
Hold this report until a human reviews it.

📄 Output: A single-file HTML review page and a structured feedback artifact (sidecar .review.md) that gate the completion of the work.

📦 Add this skill to Claude Code

# 1. Get the skills repo
git clone --depth 1 https://github.com/alirezarezvani/claude-skills /tmp/claude-skills

# 2. Copy this skill into your project (or ~/.claude/skills for all projects)
mkdir -p .claude/skills
cp -r /tmp/claude-skills/engineering/human-gate/skills/human-gate .claude/skills/human-gate

Skill source: engineering/human-gate/skills/human-gate/SKILL.md

⚠️ Good to know

Requires a named human reviewer and an artifact file; cannot substitute for actual human review, and the review page is not the source of truth.

❓ FAQ

Can I waive the requirement for any review?

No, G1 (no round collected) is never waivable; a waiver can only accept objections raised by a reviewer, not replace review happening.

What happens if a severity is mistyped?

A mistyped severity silently downgrades to NIT, which could lose a real blocker; the gate refuses to close if integrity problems are unresolved.

Can I invent a reviewer name to satisfy G3?

No, never invent a reviewer name; no reviewer is the finding, and the gate will not close without a named person.

🤖 Overview, features, install steps and FAQ were generated from the project's SKILL.md on Sep 4, 2026. Always check the original source before running commands.