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

76%

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

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-structured orchestration skill: lean table-driven content, a fully sequenced five-phase workflow with validation checkpoints and explicit error recovery, and clean one-level-deep disclosure into real reference and script files. The only notable gaps are minor redundancy in the output format presentation, an underspecified 'gate interaction' mechanism, and an orphaned bundle file (co-change.md) that the body never points to.

DimensionReasoningScore

Conciseness

The body is table-heavy and terse, assuming Claude's competence with no background-concept explanations. Minor redundancy keeps it below anchor 5: the gate output format appears in both the Phase 4 block and the Output Examples section, and severity categorization is shown in both the Phase 3 table and the Severity Reference section.

4 / 5

Actionability

Mostly executable guidance: a copy-paste-ready command ('node ${SKILL_DIR}/scripts/static-checks.js ${PROJECT_ROOT}'), a concrete JSON output schema, real template file paths for subagent prompts, and concrete decision/commit-annotation formats. Below anchor 5 because 'Present findings via gate interaction' leaves the interaction mechanism abstract (which tool, what format) and subagent prompts are delegated rather than shown.

4 / 5

Workflow Clarity

Five clearly sequenced phases with an explicit validation checkpoint up front (static checks must run and produce pass/fail/warn before expert review), an error-handling table covering script failure, timeout, and clean states, and a fix-then-await-approval loop in Phase 5. This matches anchor 5: clear sequence, explicit validation, feedback loops for error recovery.

5 / 5

Progressive Disclosure

The body is an orchestration-level overview with well-signaled, one-level-deep references (criteria.md, review-checklists.md, verification.md) that all exist as real files, and the script bundle matches the body's claims about orchestrator/layers. Below anchor 5 because references/co-change.md exists in the bundle but is never referenced from SKILL.md, a minor navigation gap.

4 / 5

Total

17

/

20

Passed

Description

61%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 trigger-oriented description with excellent 'when' coverage — multiple natural, well-varied trigger phrases and an explicit invocation path — but it front-loads triggering at the expense of saying what the skill actually does. The capability side (static checks + parallel expert review + severity-categorized findings) is entirely absent from the description, leaving the reader to infer the mechanism from the verbs.

Suggestions

Open the description with a compact 'what' clause, e.g. 'Runs static protocol-consistency checks and parallel expert-review subagents, synthesizing findings by severity (Critical/Concern/Note).' before the trigger phrases, to raise completeness and specificity.

State the artifact domain more concretely (e.g. 'protocol SKILL.md definitions' or naming the check layers) so the scope of 'validate definitions' is unambiguous and less likely to trigger for unrelated validation requests.

Add one or two missing natural trigger synonyms users might say, such as 'lint protocols' or 'sanity-check the protocol', to round out trigger coverage.

DimensionReasoningScore

Specificity

The description names the domain (epistemic protocol verification) only through trigger verbs like "verify protocols" and "validate definitions", but never states what the skill actually does (static checks, parallel expert-review subagents, severity synthesis). This matches the anchor 'names domain and 1-2 concrete actions, but not comprehensive' — above anchor 2 because the actions are domain-specific rather than generic, below anchor 4 because no list of specific capabilities is given.

3 / 5

Completeness

The 'when' is explicit and strong (trigger phrases plus 'Invoke explicitly with /verify for pre-commit validation'), but the 'what' is only weakly implied through the trigger verbs — no separate statement of the skill's capabilities or mechanism. This sits between anchor 3 ('what' weakly implied) and anchor 4 ('when' could be more explicit), landing at 3 since the what-side is the weaker half.

3 / 5

Trigger Term Quality

Six quoted natural phrases ('verify protocols', 'check consistency before commit', 'validate definitions', 'run pre-commit checks', 'verify soundness') with good synonym variation across verify/check/validate/ensure. Good coverage but not comprehensive — natural terms like 'lint' or 'sanity check' are absent — placing it at anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

The niche (epistemic protocol consistency before commit) is mostly distinct with clear commit-time triggers, though phrases like 'verify soundness' overlap with generic verification/lint skills. Minor overlap risk with closely related skills — anchor 4, not 5 (not a fully clear niche) and not 3 (triggers are well-differentiated).

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.

Validation — 15 / 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.