CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

verification-loop

A comprehensive verification system for Claude Code sessions. Use when verifying a Claude Code session's work before claiming it is complete.

56

Quality

71%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/verification-loop/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is a strong, executable workflow: six ordered verification phases with concrete bash commands, early stop-and-fix gates, and a concrete report format. Minor weaknesses are the missing failure-handling loops in later phases, some per-language branch ambiguity, and light padding in the Continuous Mode and Hooks sections.

DimensionReasoningScore

Conciseness

The phase commands are lean and assume competence, but the Continuous Mode section ('Set a mental checkpoint... Run: /verify') and the Hooks section ('This skill complements PostToolUse hooks... comprehensive review') are padded relative to their value. Anchor 4 ('efficient; minor instances of over-explanation that could be trimmed'), not 5.

4 / 5

Actionability

Every phase has concrete, executable bash commands (npm run build, npx tsc --noEmit, ruff check, grep secret scans, git diff --stat) plus a structured report template. Not 5 because phases present per-language OR-branches rather than one definitive path, the '/verify' reference is undefined, and coverage is only a comment, not an enforced check.

4 / 5

Workflow Clarity

Six phases are clearly sequenced with explicit stop-and-fix gates in Phase 1 ('If build fails, STOP and fix before continuing') and Phase 2 ('Fix critical ones before continuing'), plus a final report. Anchor 4 ('clear sequence with most checkpoints present; minor validation gaps') — not 5 because Phases 3-6 lack feedback loops specifying what to do on failure.

4 / 5

Progressive Disclosure

No bundle files exist; the skill is a single, well-sectioned file (~120 lines) with clear headers (When to Use, Verification Phases, Output Format, Continuous Mode, Integration with Hooks) and no nested or dangling references. It exceeds the under-50-line simple-skill allowance, so anchor 4 rather than 5.

4 / 5

Total

16

/

20

Passed

Description

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

The description has an explicit and well-formed 'Use when' trigger clause, but the 'what' side is generic — 'a comprehensive verification system' names no concrete actions, so a model cannot tell what the skill actually does (build/type/lint/test/security verification). Trigger terms are relevant but miss natural synonyms. Overall a mediocre description that relies on the body to carry the substance.

Suggestions

Replace 'A comprehensive verification system' with the concrete actions it performs, e.g. 'Runs build, type-check, lint, test, and secret-scan phases and produces a pass/fail verification report.'

Add natural trigger variations users would actually say, such as 'verify the work', 'quality gates', or 'before opening a PR'.

Sharpen distinctiveness by naming the output ('a VERIFICATION REPORT with a READY/NOT READY verdict') so it doesn't collide with generic testing or code-review skills.

DimensionReasoningScore

Specificity

The description names the domain ('A comprehensive verification system for Claude Code sessions') but lists no concrete actions — none of the body's actual capabilities (build, type check, lint, tests, security scan) appear. It matches anchor 2 ('names the domain but actions are minimal or generic') rather than 3, which requires 1-2 concrete actions.

2 / 5

Completeness

Both parts are present: an explicit 'Use when verifying a Claude Code session's work before claiming it is complete' (what/when guidance) plus a what ('comprehensive verification system'). It is not 5 because the 'what' is vague ('comprehensive system') with no concrete capability detail; not 3 because the 'when' clause is explicit and specific.

4 / 5

Trigger Term Quality

Terms like 'verification', 'verifying', and 'Claude Code session' are relevant but lack common variations users would naturally say ('verify the work', 'quality gate', 'before the PR', 'check tests'). Anchor 3 ('some relevant keywords but missing common variations or synonyms') fits; not 4 because several natural trigger phrases are absent.

3 / 5

Distinctiveness Conflict Risk

Scoping to 'Claude Code sessions' helps, but 'verification' is a generic term that overlaps with testing, code-review, and PR-readiness skills. Anchor 3 ('somewhat specific but could still overlap with similar skills') fits; not 4 because the trigger surface is broad.

3 / 5

Total

12

/

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

affaan-m/ECC

Path

.agents/skills/verification-loop/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.