Agent skill

Human Gate

by alirezarezvani in alirezarezvani/claude-skills

Runs the human-verification lane of an agent loop, and proves review happened before work is called done.

MITAuto-check passedFrontend & Design

Install Human Gate

skills CLI
$ npx skills add alirezarezvani/claude-skills --skill human-gate -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install alirezarezvani/claude-skills human-gate --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/engineering/human-gate/skills/human-gate .claude/skills/human-gate && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
human-gate
GitHub stars
28k
Token cost
~1.5k tokens
SKILL.md length
614 words
Files
9 (incl. scripts, references, assets)
Skills in repo
342
Repo updated
First seen
Licence
MIT

At a glance

Runs the human-verification lane of an agent loop, and proves review happened before work is called done.

  • Works in 6 steps: Never report done while close exits 2.… → Never invent a reviewer name to satisfy… → Never paraphrase an EDIT's after —… → …
  • Any irreversible action needs human sign-off before shipping
  • SKILL.md covers The loop, The sidecar, Gate rules and Hard rules, plus 2 more sections
  • Runs Python scripts from its folder; calls python3 and npx

What it does

Human Gate is an agent skill from alirezarezvani/claude-skills. Runs the human-verification lane of an agent loop, and proves review happened before work is called done. Builds a single-file HTML review page, collects batched feedback as a structured artifact instead of chat prose, and runs a gate that refuses to close while a BLOCKER is open, the reviewer is unnamed, or nobody has reviewed at all. Use when a plan, spec, RFC, report, landing page, migration, or any irreversible action needs human sign-off before shipping, or on requests such as 'get sign-off', 'have someone…

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including scripts, reference files and assets (for example `assets/batch.v1.schema.json`, `assets/example_review_sidecar.md` and `references/feedback_batching.md`).

It sits in Frontend & Design, covering Code review, Landing pages and HTML artifacts. The repository describes itself as: 380 Claude Code skills & agent skills & plugins (30+ Agents, 70+ custom commands, 380+ skills, customizable references, scripts)for Claude Code, Codex, Gemini CLI, Cursor, and 8… The licence is MIT.

When your agent uses it

  • Any irreversible action needs human sign-off before shipping
  • On requests such as get sign-off
  • Have someone check this
  • Hold until reviewed

Example prompts

  • “get sign-off”
  • “have someone check this”
  • “hold until reviewed”
  • “/human-gate”

Requirements

  • Python 3
  • Node.js

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Never report done while close exits 2. Say what is open instead.
  2. Never invent a reviewer name to satisfy G3. No reviewer is the finding.
  3. Never paraphrase an EDIT's after — verbatim, or a human was silently overruled. Apply
  4. Never block-poll for a human. Hand over the path and end the turn; open detects a
  5. Never auto-fetch and run unpinned code. The richer editor at petergyang/human-review
  6. Never treat the review page as source of truth. It is a viewing surface.

What it can do on your machine

Read from SKILL.md and the folder at commit 19392f7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Human Gate loads about 1.5k tokens when it runs, and up to ~7.2k if it reads all its reference files. Until then it costs about 180 tokens; SKILL.md has 614 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~180
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from alirezarezvani/claude-skills at commit 19392f7, republished under its MIT licence (© alirezarezvani). 614 words, ~1,464 tokens.

Download SKILL.mdSave it as .claude/skills/human-gate/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.
name
human-gate
description
Runs the human-verification lane of an agent loop, and proves review happened before work is called done. Builds a single-file HTML review page, collects batched feedback as a structured artifact instead of chat prose, and runs a gate that refuses to close while a BLOCKER is open, the reviewer is unnamed, or nobody has reviewed at all. Use when a plan, spec, RFC, report, landing page, migration, or any irreversible action needs human sign-off before shipping, or on requests such as 'get sign-off', 'have someone check this', 'hold until reviewed', 'needs approval first'. NOT for making AI text sound human (use content-humanizer or behuman). NOT for reviewing code diffs (use md-review or code-reviewer).
license
MIT
metadata.version
1.0.0
metadata.author
Alireza Rezvani
metadata.category
engineering
metadata.updated
2026-08-09

Human Gate

You are the part of the loop that refuses to let an agent mark its own homework. Machine verification answers "do the checks pass?" — engineering/agent-harness does that. This answers what no script can: has a person looked at this, and are their objections resolved? Feedback becomes a machine-parseable artifact rather than a message — anchored, severity-graded, countable — and a gate either passes or names what is still open. Before starting, establish: which artifact (.md/.html), who the named reviewer is (a person, not "the team" — G3 enforces it), whether the work is reversible, and whether a human is available now. Read human-gate-context.md first if it exists.

The loop

sh
S=engineering/human-gate/skills/human-gate/scripts

python3 $S/human_gate.py open plan.md --launch   # build page, start round N → END YOUR TURN
python3 $S/human_gate.py status plan.md          # non-blocking: 0 clear·2 blocked·3 collect·4 none
python3 $S/human_gate.py collect plan.md --output json   # batch.v1 — apply every item
python3 $S/human_gate.py close plan.md           # exit 2 = NOT done

human_gate.py --sample runs the whole loop, refusals included, in ~1s. It drives review_page_builder.py (Markdown/HTML → single-file anchored page that makes no network request of its own and sanitizes reviewed HTML — on*, javascript:, iframe dropped) and feedback_parser.py (sidecar → batch.v1, quotes checked against raw and rendered text).

The sidecar

Feedback lands in <artifact>.review.md. The page exports it; anyone can also write it by hand in any editor — which keeps this working over SSH and in CI. Worked example and JSON contract are in assets/.

markdown
<!-- human-gate:v1 target=plan.md round=1 -->
reviewer: reza

## BLOCKER b2
> We expect a 40% lift in activation.
No source, and it drives the whole plan. Cite it or cut it.

Severities BLOCKER / MAJOR / MINOR / NIT (matching markdown-html/md-review, from Google's code-review guidance), plus NOTE, APPROVE, and EDIT — a replacement the reviewer already wrote, as - before: / + after: lines.

Gate rules

Refuses to close when
G1no round collectedG4sidecar changed after the last collect
G2a BLOCKER or MAJOR is openG5round cap exhausted → escalate, never pass
G3no named reviewerG6waiver used without a recorded reason
G7the round carries unresolved integrity problems — a mistyped severity silently downgrades to NIT, so a real blocker can be lost to a typo

Overrides must be explicit — close plan.md --waive "<reason>" — but G1 is never waivable: a waiver accepts objections a reviewer raised; it cannot stand in for review happening.

Show full SKILL.md (306 more words)Show less

Hard rules

  1. Never report done while close exits 2. Say what is open instead.
  2. Never invent a reviewer name to satisfy G3. No reviewer is the finding.
  3. Never paraphrase an EDIT's after — verbatim, or a human was silently overruled. Apply it to whatever generates the artifact too, or it dies on the next build.
  4. Never block-poll for a human. Hand over the path and end the turn; open detects a headless host. Rounds are capped and exhaustion escalates.
  5. Never auto-fetch and run unpinned code. The richer editor at petergyang/human-review is opt-in, asked-first, and always pinned (npx -y human-review@0.6.0) — unpinned npx -y runs whatever was published most recently. Its poll blocks and it rewrites HTML in place, so wrap both. It changes the editor, never the gate. See audit/human-review-2026-08/.
  6. Never treat the review page as source of truth. It is a viewing surface.

Forcing questions

One at a time when scope is fuzzy: Who, by name, signs off? · What would make them reject it outright? (name it before reading — Klein's pre-mortem) · Is this reversible? (if not, require explicit APPROVE, not merely no blockers) · The artifact or its generator? (both) · How many rounds is this worth? · Is a human available now? (if not, hand over and stop). Two consecutive NIT-only rounds means it is done — say so rather than opening a third.

engineering/agent-harness — machine verification; this is the human lane it lacks. markdown-html/md-review — renders a code review to HTML, one-way; use when the agent reviews, human-gate when a person does. engineering/grill-me — interrogates a plan before an artifact exists. content-humanizer/behuman — human voice, not approval.

Reasoning lives in references/ — human-in-the-loop canon, feedback batching, loop discipline. Conceptual derivation of the batched-review pattern from petergyang/human-review (MIT © 2026 Peter Yang); no upstream code is used — stdlib Python, no server, non-blocking, plus a gate upstream lacks.

© alirezarezvani, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 8 other files (scripts, references, assets) in engineering/human-gate/skills/human-gate of alirezarezvani/claude-skills.

  • SKILL.md
  • assets/batch.v1.schema.json
  • assets/example_review_sidecar.md
  • references/feedback_batching.md
  • references/human_in_the_loop_canon.md
  • references/review_loop_discipline.md
  • scripts/feedback_parser.py
  • scripts/human_gate.py
  • scripts/review_page_builder.py

Open the folder on GitHubat commit 19392f7

Compare with similar skills

Human Gate next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Human Gate compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Human Gate this skillalirezarezvani/claude-skills28k—~1.5kAutomated safety check: PassMIT
Auteuragiwhitelist/auteur1k—~5kAutomated safety check: PassMIT
Taste Skillyc-software/qm15k—~1.2kAutomated safety check: PassMIT
Design Anti SlopKartikLabhshetwar/better-shot2.4k—~2.5kAutomated safety check: PassCustom licence
Viral Product Evaluatorluongnv89/skills131—~2.8kAutomated safety check: PassMIT
Slop Evalfabricioctelles/skills106—~5.4kAutomated safety check: PassApache-2.0

Similar skills

  • Auteur

    agiwhitelist/auteur

    Design and build complete web experiences from scratch — award-level product and marketing pages, cinematic scroll-directed sites where the page is directed like a film, and multi-screen products…

    1k GitHub stars~5k tokensUpdated 2 mo ago
    Frontend & DesignAuto-check passed
  • Taste Skill

    yc-software/qm

    Design taste and process for anything a person will look at in a browser — landing page, dashboard, prototype, deck.

    15k GitHub stars~1.2k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Design Anti Slop

    KartikLabhshetwar/better-shot

    Detect and fix AI design slop — the convergent look that shows up across AI-generated landing pages and dashboards (purple/indigo gradients, rounded-2xl everywhere, three-box feature grids, bento…

    2.4k GitHub stars~2.5k tokensUpdated 7 days ago
    Frontend & DesignAuto-check passed
  • Viral Product Evaluator

    luongnv89/skills

    Review a product codebase and landing page against 32 viral principles and produce a Virality Score plus ranked fixes.

    131 GitHub stars~2.8k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Slop Eval

    fabricioctelles/skills

    Objectively evaluate a UI/web design against the pols.dev anti-slop design law: detect catalogued slop tells with cited evidence, score 8 weighted axes (color, type, components, layout, motion…

    106 GitHub stars~5.4k tokensUpdated 4 days ago
    Frontend & DesignAuto-check passed
  • Design Taste Frontend

    caorushizi/oss-client

    Anti-slop frontend skill for landing pages, portfolios, and redesigns.

    113 GitHub starsUsed in 22 repos~22k tokens
    Frontend & DesignAuto-check passed

More from alirezarezvani/claude-skills

All 342 skills in this repo
  • Agile Product Owner

    alirezarezvani/claude-skills

    Writes INVEST-checked user stories with acceptance criteria, splits epics, plans sprints from velocity and ranks the backlog with a weighted score.

    28k GitHub starsUsed in 3 repos~3.2k tokens
    Auto-check passed
  • Product Strategist

    alirezarezvani/claude-skills

    OKR cascade toolkit for product leaders: generates aligned company-to-team OKRs from five strategy types and scores how well they line up.

    28k GitHub starsUsed in 2 repos~1.8k tokens
    Auto-check passed
  • App Store Optimization

    alirezarezvani/claude-skills

    App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store.

    28k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • AWS Solution Architect

    alirezarezvani/claude-skills

    Design AWS architectures for startups using serverless patterns and IaC templates.

    28k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Campaign Analytics

    alirezarezvani/claude-skills

    Calculates attribution, funnel and ROI figures for marketing campaigns with three Python scripts that need only the standard library.

    28k GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check passed
  • Code to PRD

    alirezarezvani/claude-skills

    Reverse-engineers a frontend, backend or fullstack codebase into a product requirements document with per-page docs, an enum dictionary and an API inventory.

    28k GitHub starsUsed in 1 repo~4.9k tokens
    Auto-check passed

Questions about Human Gate

What does Human Gate do?

Runs the human-verification lane of an agent loop, and proves review happened before work is called done. Human Gate is an agent skill from alirezarezvani/claude-skills. Runs the human-verification lane of an agent loop, and proves review happened before work is called done.

When should I use Human Gate?

Human Gate fits situations like: any irreversible action needs human sign-off before shipping; on requests such as get sign-off; have someone check this; hold until reviewed.

How do I install Human Gate in Claude Code?

Run `npx skills add alirezarezvani/claude-skills --skill human-gate -a claude-code`. Or copy the skill folder (engineering/human-gate/skills/human-gate in alirezarezvani/claude-skills) into .claude/skills/human-gate in your project. Claude Code loads it when a task matches its description.

How do I install Human Gate in Codex?

Run `npx skills add alirezarezvani/claude-skills --skill human-gate -a codex`. Or copy the skill folder (engineering/human-gate/skills/human-gate in alirezarezvani/claude-skills) into .agents/skills/human-gate in your project. Codex loads it when a task matches its description.

Can I use Human Gate in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alirezarezvani/claude-skills --skill human-gate -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/human-gate, .gemini/skills/human-gate, .github/skills/human-gate and .opencode/skills/human-gate in your project.

What does Human Gate need to run?

Going by SKILL.md and its folder, Human Gate needs Python for the scripts in its folder and the command-line tools its instructions call (python3 and npx). Our summary lists: Python 3; Node.js.

Does Human Gate access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Human Gate safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Human Gate use?

Human Gate is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Human Gate use?

About 1.5k tokens (SKILL.md is roughly 5.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.7k tokens, read only when the agent opens those files.

What are the alternatives to Human Gate?

Skills that share tags, products or a category with Human Gate: Auteur (agiwhitelist/auteur, 1k stars), Taste Skill (yc-software/qm, 15k stars), Design Anti Slop (KartikLabhshetwar/better-shot, 2.4k stars) and Viral Product Evaluator (luongnv89/skills, 131 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Human Gate?

alirezarezvani (a GitHub user) maintains it in alirezarezvani/claude-skills, which has 27,829 GitHub stars. The repository holds 342 skills in this directory. The repository was last updated on August 30, 2026.

Source: alirezarezvani/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.