CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

verify-gate

Runs project compile, test, and lint commands between implementation and quality review. Gates simplify-and-harden behind machine verification. If checks fail, routes back to implementation with diagnostics for a fix loop. If checks pass, signals ready for the quality pass. Use after any implementation work completes and before simplify-and-harden. Essential for the inner loop's verify step.

Quality

89%

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

92%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 excellent workflow skill body: highly executable with per-ecosystem commands, explicit phase-gated validation with a bounded fix loop, and textbook just-in-time loading of the agent-qa and playwright references. The only weakness is minor verbosity in the motivational lines and the three-example mcp-scripts YAML block.

DimensionReasoningScore

Conciseness

The body is dense imperative procedure with almost no explanation of concepts Claude already knows; only minor instances could be trimmed, e.g. the three-script mcp-scripts YAML example could be one, and the closing editorial line ("This moves project-specific invariants from 'knowledge in your head'...") plus "Without it, the agent hands off code with zero machine signal" are motivational padding. Efficient overall, so this sits above the 'mostly efficient but includes some unnecessary explanation' midpoint but below the every-token-earns-its-place top anchor.

4 / 5

Actionability

Fully executable guidance throughout: named config sources in priority order (package.json scripts with lockfile-aware runner selection, Makefile/Justfile targets, cargo build/test/clippy, pytest/mypy/ruff, go build/test/vet, deno task), exit-code decision rules per phase, copy-paste gate-signal templates, and a concrete .verify-gate.yml config example covering the common cases.

5 / 5

Workflow Clarity

Clear multi-step sequence (discover → verify phases 1-5 with stop-at-first-failure → fix loop → gate signal) with explicit validation checkpoints (Exit 0 / Exit non-zero branches per phase), a feedback loop that re-runs only the failed phase with an attempt counter, explicit fix-loop limits and escalation, and checklists in the PASSED/BLOCKED templates — a direct match for the top anchor including the feedback-loop requirement for batch verification operations.

5 / 5

Progressive Disclosure

SKILL.md is a clear workflow overview with well-signaled, conditionally gated, one-level-deep references ("If the selected project tests use agent-qa, read [agent-qa verification evidence](references/agent-qa.md)"); both referenced files exist in the bundle and contain no further nested file references (only external URLs). Tool-specific evidence is appropriately split out of the main flow, matching the top anchor; only the inline mcp-scripts example block is arguably bulk that could be split, which is not enough to drop below the anchor since navigation is easy and references are precisely gated.

5 / 5

Total

19

/

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 third-person actions, explicit what-and-when structure, and clear pipeline positioning. The main gaps are missing synonyms (build, typecheck, CI) and omission of the custom-checks and outcome-acceptance phases the skill actually performs.

DimensionReasoningScore

Specificity

The description lists several concrete third-person actions ("Runs project compile, test, and lint commands", "routes back to implementation with diagnostics for a fix loop", "signals ready for the quality pass"), but omits capabilities the body covers such as custom checks and outcome acceptance, leaving minor gaps in coverage.

4 / 5

Completeness

It clearly answers what the skill does ("Runs project compile, test, and lint commands...") and explicitly answers when with a concrete Use clause ("Use after any implementation work completes and before simplify-and-harden"). The when-clause is explicit and specific with concrete trigger points, matching the top anchor rather than the 'could be more explicit' level below.

5 / 5

Trigger Term Quality

Natural keywords like "compile", "test", "lint", "checks fail", "fix loop", and "verification" are present and would be said by users needing this skill, but common synonyms such as "build", "typecheck", and "CI" are missing.

4 / 5

Distinctiveness Conflict Risk

The pipeline framing ("between implementation and quality review", "inner loop's verify step", "Gates simplify-and-harden") carves out a distinct niche, but the opening "Runs project compile, test, and lint commands" could overlap with a generic run-tests or build skill, leaving minor conflict risk.

4 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

pskoett/pskoett-ai-skills

Path

plugin/skills/verify-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.