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

83%

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

The canonical home for this skill is verify-gate in pskoett/pskoett-ai-skills

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-engineered verification workflow with exceptional actionability and an exemplary fix-loop structure — explicit checkpoints, bounded retries, and escalation paths. The main cost is token weight: redundant framing, a long config example, and wordy acceptance prose keep it from being lean.

Suggestions

Delete the opening paragraph that restates the description verbatim, keeping only the non-duplicate framing sentence.

Move the mcp-scripts example YAML and the .verify-gate.yml configuration block into a references file (e.g. references/configuration.md), keeping a one-line summary and pointer inline.

Tighten the 'Define acceptance evidence' section: the enumeration of non-substitutable proofs ('an iframe src is not a rendered app...') can be compressed to the general rule plus two examples.

DimensionReasoningScore

Conciseness

The body is mostly efficient and procedural, but it re-states the description verbatim in the opening paragraph, includes motivational padding ('hands off code with zero machine signal'), a three-script mcp-scripts YAML example, and wordy acceptance-evidence prose — matching anchor 3 ('mostly efficient but could be tightened') rather than anchor 4's 'minor instances of over-explanation'.

3 / 5

Actionability

Fully executable throughout: per-ecosystem commands ('cargo build', 'go test ./...', 'pytest, mypy, ruff'), lockfile-based package-manager preferences, exact fix-loop limits ('3 per phase', '20% of the original implementation effort'), and copy-paste-ready config YAML and PASSED/BLOCKED report templates.

5 / 5

Workflow Clarity

A clearly sequenced pipeline (discover → phases 1–5 → fix loop → gate signal) with explicit exit-code validation checkpoints, a bounded feedback loop with precise attempt-counting semantics, escalation rules, and template outputs — anchor 5's 'explicit validation steps; feedback loops for error recovery'.

5 / 5

Progressive Disclosure

Two real, one-level-deep references ([agent-qa.md](references/agent-qa.md), [playwright.md](references/playwright.md)) are conditionally loaded and clearly signaled in Phase 2, and the body is well sectioned. Minor gap: the ~45-line mcp-scripts configuration example is inlined where anchor 5 would keep the overview leaner by splitting such config detail out.

4 / 5

Total

17

/

20

Passed

Description

78%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 with explicit what/when structure, third-person voice, and concrete actions. Its weaknesses are a pipeline-internal trigger clause that references sibling skills rather than natural user phrasing, and slight under-coverage of the skill's full phase set.

Suggestions

Replace or supplement the pipeline-internal trigger ('Use after any implementation work completes and before simplify-and-harden') with user-observable phrasing such as 'Use when asked to verify, build, test, or lint recent changes' to improve trigger term quality.

Mention the outcome-acceptance and custom-check phases so the description's capability list matches the skill's actual coverage.

DimensionReasoningScore

Specificity

Lists several specific actions in third person ('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 actually covers such as custom checks and outcome acceptance — minor gaps in coverage rather than anchor 5's comprehensive coverage.

4 / 5

Completeness

Both are present: the 'what' ('Runs project compile, test, and lint commands between implementation and quality review') and an explicit 'when' clause ('Use after any implementation work completes and before simplify-and-harden'). The 'when' is procedural and pipeline-internal rather than the concrete user-observable trigger phrases that distinguish anchor 5.

4 / 5

Trigger Term Quality

'compile', 'test', 'lint', 'verification', and 'fix loop' are terms users naturally say when they need this skill, but common variations like 'build', 'CI', or 'run the test suite' are missing — good coverage with a few natural terms absent, matching anchor 4 over anchor 3 (which requires missing common variations) and below anchor 5 (comprehensive synonyms).

4 / 5

Distinctiveness Conflict Risk

A clear niche with distinct triggers: 'Gates simplify-and-harden behind machine verification' and 'between implementation and quality review' — no other plausible skill would claim this trigger context, matching anchor 5.

5 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

pskoett/pskoett-ai-skills

Path

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