CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

review-agent-setup

Configure human-in-the-loop gating for AI agent review actions in Claude Code. Use when setting up a project where an agent may post PR reviews, comments, merges, or edit CI configuration, and you want a cryptographically auditable approval trail with Cedar-enforced gates.

Quality

86%

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

82%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.

Highly actionable content with copy-paste-ready commands, clearly sequenced one-time and per-session workflows, and explicit receipt verification with exit-code semantics. The main deductions are minor: version-pinned prose that could be tightened, no recovery loop for failed verification, and no use of reference files to slim the main body.

DimensionReasoningScore

Conciseness

The body is dense and operational with no padding or teaching of known concepts, but a few passages could be trimmed — version-specific prose ("protect-mcp 0.7.4 `sign` does not create the key...") not placed in a deprecated/old-patterns section, and the hook-mechanics explanation in 'Composing with protect-mcp' — matching the efficient-with-minor-trimmables anchor.

4 / 5

Actionability

Fully executable throughout: copy-paste install/cp/key-gen commands with conditionals and chmod, the touch/rm flag-file flow, the /approve-review slash command with a concrete reason string, the node-based public-key extraction plus npx verify pipeline, and a worked 4-step example covering the common case (approving a PR review).

5 / 5

Workflow Clarity

Sequences are clear (numbered one-time setup, explicit open-window → act → close session flow, numbered worked example) with an explicit validation checkpoint (verify command with exit codes 0/1/2 explained), but there is no error-recovery loop once verification fails — it diagnoses the cause without a fix-and-retry step — so it stops short of the feedback-loops anchor.

4 / 5

Progressive Disclosure

No bundle files exist, and the 178-line body is well-sectioned with one clearly signaled external pointer ("See `../agents/review-policy-author.md` for guidance on authoring review policies"); however, nothing is split into reference files and sections like 'Composing with protect-mcp' and 'Standards' could live separately, matching good-structure-with-minor-gaps rather than an appropriately split overview.

4 / 5

Total

17

/

20

Passed

Description

83%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.

A strong description: concrete actions, explicit 'Use when' triggers, and third-person voice throughout. Trigger coverage is good though not exhaustive of synonyms, and PR-review keywords create slight overlap risk with skills that perform reviews rather than gate them.

DimensionReasoningScore

Specificity

Lists several concrete gated actions ("PR reviews, comments, merges, or edit CI configuration") and concrete outputs ("cryptographically auditable approval trail with Cedar-enforced gates"), matching the several-specific-actions anchor with minor gaps — issue triage, releases, and protected-branch pushes are covered only in the body, not the description.

4 / 5

Completeness

Explicitly answers both: what ("Configure human-in-the-loop gating for AI agent review actions in Claude Code") and when ("Use when setting up a project where an agent may post PR reviews, comments, merges, or edit CI configuration...") with concrete trigger conditions — a clear match for the top anchor.

5 / 5

Trigger Term Quality

Includes natural terms users would say ("PR reviews", "comments", "merges", "CI configuration"), giving good keyword coverage; a few natural variants are missing ("pull request" spelled out, "workflows", "protected branches"), so it falls short of the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

The governance/setup framing plus Cedar and signed-receipt specifics carve a clear niche, but "PR reviews" and "comments" could overlap with skills that actually perform code reviews, giving minor overlap risk with closely related skills rather than minimal conflict.

4 / 5

Total

17

/

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

wshobson/agents

Path

plugins/review-agent-governance/skills/review-agent-setup/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.