CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

human-gate

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).

78

Quality

98%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

96%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exceptionally strong skill body: executable commands with exit-code semantics, a gated multi-step workflow with explicit validation and escalation, and well-signaled one-level-deep references that all exist. The only deductions are inline time-sensitive details (pinned version, dated audit path) and a dangling audit reference, which cost it slightly on conciseness and progressive disclosure.

Suggestions

Move the pinned-version and dated-audit details (npx -y human-review@0.6.0, audit/human-review-2026-08/) into a dedicated 'Maintenance / pinned dependencies' section or a reference file, so time-sensitive values are isolated from the evergreen instructions.

Trim inline rationale clauses (e.g., the G7 typo explanation in the gate table) to their rule statements and move the 'why' to references/review_loop_discipline.md, which already covers loop discipline reasoning.

Either include the audit/human-review-2026-08/ artifact in the bundle or drop the pointer, since it currently leads nowhere for a reader of this skill.

DimensionReasoningScore

Conciseness

The body is dense and high-signal — a terse sh loop block, a gate-rule table, hard rules — with no explanation of concepts Claude already knows. However, it inlines time-sensitive details ('always pinned (`npx -y human-review@0.6.0`)', 'See `audit/human-review-2026-08/`') outside any old-patterns/deprecated section, and rationale clauses like 'a mistyped severity silently downgrades to NIT, so a real blocker can be lost to a typo' could be trimmed. Anchor 4 (efficient, minor trimming possible) fits better than 5.

4 / 5

Actionability

Fully executable, copy-paste-ready commands with exact script paths and flags: 'python3 $S/human_gate.py open plan.md --launch', 'collect plan.md --output json', 'close plan.md', plus '--sample' covering the whole loop in ~1s. Exit-code semantics ('exit 2 = NOT done', '0 clear·2 blocked·3 collect·4 none') make outcomes unambiguous — matches anchor 5.

5 / 5

Workflow Clarity

The loop is a clear sequence (open → END TURN → status → collect → apply every item → close) with explicit validation checkpoints: the exit-2 gate, G4 (sidecar changed after last collect), G7 (integrity), and round-cap exhaustion that 'escalate[s], never pass[es]'. Batch feedback handling includes validation (quotes checked against raw and rendered text), so no cap applies; anchor 5's explicit validation and feedback loop are present.

5 / 5

Progressive Disclosure

References are one level deep, clearly signaled, and real: 'Reasoning lives in `references/` — human-in-the-loop canon, feedback batching, loop discipline' (all three files exist) and 'Worked example and JSON contract are in `assets/`'. Minor gap: the cited 'audit/human-review-2026-08/' path is absent from this bundle, and some inline rationale (the derivation note, forcing-question commentary) could live in references. Anchor 4 fits; not 5 because of the dangling pointer.

4 / 5

Total

18

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: concrete third-person capabilities, explicit 'Use when…' triggers with natural user phrasings, and explicit NOT-for boundaries against adjacent skills. Both what and when are answered comprehensively with no padding.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Builds a single-file HTML review page, collects batched feedback as a structured artifact… runs a gate that refuses to close while a BLOCKER is open, the reviewer is unnamed, or nobody has reviewed at all' — with comprehensive coverage and third-person voice. It matches the anchor-5 example's completeness; a 4 would require minor gaps in coverage, which are absent.

5 / 5

Completeness

Both 'what' (build review page, collect batched feedback artifact, run gate with named refusal conditions) and 'when' (explicit 'Use when a plan, spec, RFC… needs human sign-off before shipping, or on requests such as…' with concrete trigger phrases) are answered explicitly, plus NOT-for exclusions. This is the anchor-5 pattern exactly.

5 / 5

Trigger Term Quality

It includes natural phrases users would actually say, quoted directly: 'get sign-off', 'have someone check this', 'hold until reviewed', 'needs approval first', plus artifact-type keywords (plan, spec, RFC, report, landing page, migration). This matches anchor 5's comprehensive coverage including phrasing variations.

5 / 5

Distinctiveness Conflict Risk

It carves a clear niche (human sign-off/approval) and explicitly disambiguates the nearest conflicting skills: 'NOT for making AI text sound human (use content-humanizer or behuman). NOT for reviewing code diffs (use md-review or code-reviewer)'. Distinct triggers and minimal conflict risk match anchor 5.

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

alirezarezvani/claude-skills

Path

engineering/human-gate/skills/human-gate/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.