CtrlK
BlogDocsLog inGet started
Tessl Logo

verify

This skill should be used when the user asks to "verify protocols", "check consistency before commit", "validate definitions", "run pre-commit checks", "verify soundness", or wants to ensure epistemic protocol quality. Invoke explicitly with /verify for pre-commit validation.

60

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 ./.claude/skills/verify/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 content is well-structured and actionable, using a clean phased workflow with concrete commands, output schemas, and an excellent progressive-disclosure layout that offloads detail to real reference files. The main gaps are minor: the Task-subagent invocation syntax is not shown and the post-fix re-verification loop is implicit.

DimensionReasoningScore

Conciseness

The body is efficient — tables, a single executable command, and one-line pointers to references instead of inlined explanations — but the two full Output Examples and the opaque Integration Notes (Prothesis/Syneidesis) are minor padding that could be trimmed, fitting 'efficient; minor instances of over-explanation'.

4 / 5

Actionability

Concrete, copy-paste-ready guidance is present (the `node ${SKILL_DIR}/scripts/static-checks.js ${PROJECT_ROOT}` command, the JSON output schema, and the exact gate-interaction format), but Phase 2 only describes spawning Task subagents in prose without showing the actual Task invocation syntax, a minor executable gap.

4 / 5

Workflow Clarity

The five phases are clearly sequenced with an error-handling table and a gate-interaction decision table providing most checkpoints; however the validate→fix→re-verify feedback loop is implied rather than explicit after 'Fix critical', leaving a minor validation gap below the score-5 anchor.

4 / 5

Progressive Disclosure

The body is a genuine overview that splits detail into one-level-deep, clearly-signaled references (verification.md, criteria.md, review-checklists.md) and the static-checks.js script, all of which exist in the bundle, matching the 'clear overview with well-signaled one-level-deep references' anchor.

5 / 5

Total

17

/

20

Passed

Description

65%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 excels at explicit trigger guidance with strong 'when' coverage, but is weaker on articulating concrete capabilities — it relies on generic verification verbs rather than describing what the skill mechanically does. Distinctiveness is solid thanks to the specific /verify invocation and protocol domain.

Suggestions

State the concrete mechanism in the description, e.g. 'Runs static checks and parallel expert review against protocol definitions to surface consistency issues before commit.'

Add one or two plain-language capability verbs beyond verify/check/validate (e.g. 'audits', 'flags drift') to broaden natural-term coverage beyond the single verification concept.

Tighten 'ensure epistemic protocol quality' into a more specific capability statement so the 'what' is as concrete as the 'when'.

DimensionReasoningScore

Specificity

The description names the domain (epistemic protocols) but the stated actions are generic verbs — "verify protocols", "check consistency", "validate definitions", "ensure ... quality" — with no concrete mechanism described, fitting the 'actions are minimal or generic' anchor rather than the 'concrete actions' of score 3.

2 / 5

Completeness

Both halves are present: a stated 'what' ("ensure epistemic protocol quality") and a very explicit 'when' (multiple quoted triggers plus "Invoke explicitly with /verify for pre-commit validation"); the 'what' is adequate but somewhat abstract, keeping it just below the fully concrete score-5 anchor.

4 / 5

Trigger Term Quality

It provides good natural-phrase coverage with synonyms (verify/check/validate/ensure) and context cues ("pre-commit", "before commit"), though the terms cluster around a single verification concept and "epistemic protocol" leans jargon-heavy, leaving a few plain-language variants missing.

4 / 5

Distinctiveness Conflict Risk

The niche (epistemic protocol verification pre-commit, invoked via /verify) is mostly distinct with a dedicated command trigger, but the generic verify/validate/check verbs carry minor overlap risk with other validation-style skills.

4 / 5

Total

14

/

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository
jongwony/epistemic-protocols
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.