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.

Quality

68%

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 lean, well-sequenced verification playbook: concrete executable commands per phase, explicit stop-and-fix checkpoints, a dense target-acceptance section, and a fully specified output report template. Remaining weaknesses are minor — undefined pass/fail thresholds for lint/security, no retry loop in later phases, and a little padding in the Hooks and Continuous Mode sections.

DimensionReasoningScore

Conciseness

The body is command-first and terse ('If build fails, STOP and fix before continuing'), with only minor trimmable padding: the opening line repeats the frontmatter description, the 'Integration with Hooks' section explains a comparison Claude could infer, and the 'Continuous Mode' markdown block ('Set a mental checkpoint') is fluffy. This matches 'Efficient; minor instances of over-explanation' rather than score 5's every-token-earns-its-place.

4 / 5

Actionability

Every phase gives concrete, copy-paste-ready commands (`npm run build 2>&1 | tail -20`, `npx tsc --noEmit 2>&1 | head -30`, `pyright .`, `ruff check .`, specific grep patterns, `git diff --stat`), and the output template is fully specified. Minor gaps keep it below 5: alternatives are offered without selection guidance ('npm run build # OR pnpm build'), thresholds for lint/security failures are not defined, and the test-report fields are placeholders ('Total tests: X').

4 / 5

Workflow Clarity

Phases 1-6 are clearly sequenced with explicit checkpoints and some feedback loops ('If build fails, STOP and fix before continuing'; 'Fix critical ones before continuing'), plus a final report checklist — matching 'Clear sequence with most checkpoints present'. Not 5 because lint, test, and security phases say only 'Report' with no fix-and-retry loop or pass/fail criteria; not 3 since validation is explicit in the early phases and the skill is not destructive/batch, so no cap applies.

4 / 5

Progressive Disclosure

The skill is a single self-contained file (~140 lines) with clean, well-labeled sections (When to Use, six phases, Target Acceptance, Output Format) and no buried or nested references — matching 'Good structure; most content is appropriately placed'. Not 5 under the simple-skill note since it exceeds the under-50-line threshold, and the 'Continuous Mode' section is slightly underorganized.

4 / 5

Total

16

/

20

Passed

Description

45%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 reasonably natural 'Use when' trigger, but the capability statement is vague buzzword ('comprehensive verification system') with no concrete actions, weak keyword coverage, and notable overlap risk with review/testing skills. It reads closer to 'Processes PDF files' than to a well-specified trigger-rich description.

Suggestions

Replace 'A comprehensive verification system' with the concrete phases the skill actually runs, e.g., 'Runs build, type-check, lint, test-with-coverage, secret scan, and diff review phases, then produces a pass/fail verification report'.

Add natural trigger phrases users would say, such as 'verify my work', 'run quality checks', 'before opening a PR', or 'is this ready to commit', to improve trigger_term_quality.

State what the skill verifies (builds, types, lint, tests, coverage, secrets, diff) to sharpen the 'what' half of completeness and reduce overlap with generic code-review skills.

DimensionReasoningScore

Specificity

The description names the domain ('verification system for Claude Code sessions') but the only action offered is the generic 'verifying', with no concrete verbs for what is actually verified (build, types, lint, tests, security, diff). It matches the anchor 'Names the domain but actions are minimal or generic' — not score 3, which requires 1-2 concrete actions, and not score 1, since the domain is stated with a specific triggering condition.

2 / 5

Completeness

The 'when' is explicitly present ('Use when verifying a Claude Code session's work before claiming it is complete') but the 'what' is buzzword-vague: 'A comprehensive verification system' states no concrete capability. It sits between anchor 3 (clear what, weak when) and anchor 4 (both present, when improvable) — below 4 because the 'what' clause is pure abstraction, above 2 because an explicit 'Use when' trigger exists.

3 / 5

Trigger Term Quality

Relevant keywords exist ('verifying', 'verification', 'before claiming it is complete') but common natural variations users would say are missing: 'run the tests', 'check my work', 'quality gates', 'before opening a PR', 'pre-commit check'. This matches 'Some relevant keywords but missing common variations or synonyms' rather than score 4's 'Good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

'Verification system for Claude Code sessions' is somewhat specific but 'verification' is broad and would overlap with code review, testing, and CI-related skills, matching 'Somewhat specific but could still overlap with similar skills'. Not 4, since no distinctive trigger (e.g., 'before claiming work is done' alone) cleanly separates it from a general review/test skill.

3 / 5

Total

11

/

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.