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.
69
62%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.claude/skills/verify/SKILL.mdQuality
Discovery
40%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 focuses heavily on trigger conditions and invocation patterns but fails to explain what the skill actually does in concrete terms. The domain ('epistemic protocol quality') is niche but poorly defined, and the lack of specific actions makes it difficult to understand the skill's purpose. It reads more like a list of aliases than a functional description.
Suggestions
Add concrete descriptions of what the skill does, e.g., 'Validates epistemic protocol definitions for structural consistency, checks cross-references between protocols, and reports missing or conflicting entries.'
Define the domain more clearly — explain what 'epistemic protocols' are or what types of files/artifacts are being validated, so Claude can distinguish this from generic code linting or validation skills.
Reduce jargon like 'epistemic protocol quality' and 'verify soundness' by pairing them with plain-language explanations of the specific checks performed.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description lacks concrete actions. Terms like 'verify protocols', 'check consistency', 'validate definitions', and 'verify soundness' are vague and do not describe specific, concrete operations. There is no explanation of what the skill actually does beyond abstract validation language. | 1 / 3 |
Completeness | The 'when' is well-covered with explicit trigger phrases and a 'Use when' equivalent. However, the 'what' is essentially missing — the description never explains what the skill concretely does, what it checks, or what outputs it produces. It only describes when to invoke it, not what it accomplishes. | 2 / 3 |
Trigger Term Quality | It includes several trigger phrases like 'verify protocols', 'check consistency before commit', 'validate definitions', 'run pre-commit checks', and 'verify soundness', plus the /verify command. However, these terms are somewhat jargon-heavy ('epistemic protocol quality') and the domain is unclear, reducing their natural usability. | 2 / 3 |
Distinctiveness Conflict Risk | The mention of 'epistemic protocol quality' and the /verify command provide some distinctiveness, but terms like 'check consistency', 'validate definitions', and 'pre-commit checks' are generic enough to overlap with linting, code validation, or other verification skills. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured verification skill with strong actionability and workflow clarity. The 5-phase process is clearly defined with concrete commands, output formats, and decision handling. The main weakness is that the full subagent prompt templates are inlined in the body when they could be referenced from the already-mentioned review-checklists.md file, which would significantly reduce token consumption while the skill already references that file for exactly this purpose.
Suggestions
Move the three full subagent prompt templates to `references/review-checklists.md` (which is already referenced) and replace them with brief summaries of each perspective's focus area, reducing the body by ~40 lines.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is moderately efficient but includes some verbose sections, particularly the full subagent prompt templates inlined in the body (which could be referenced from the checklists files mentioned later) and the detailed integration notes. The tables and structured format help, but the overall length is substantial for what could be more tightly organized. | 2 / 3 |
Actionability | The skill provides concrete, executable commands (the bash script invocation), specific JSON output formats, detailed subagent prompts with exact file paths, clear severity categorization tables, and specific output examples. The gate interaction format and user decision handling are fully specified with copy-paste ready templates. | 3 / 3 |
Workflow Clarity | The 5-phase workflow is clearly sequenced with explicit validation checkpoints. Phase 3 synthesizes and categorizes findings, Phase 4 surfaces them via gate interaction with specific options, and Phase 5 handles user decisions with a clear decision matrix. Error handling covers failure modes with fallback actions. The feedback loop (fix → re-validate) is implicit but the user agency model (surface, don't enforce) with explicit proceed/fix/cancel options provides appropriate checkpoints. | 3 / 3 |
Progressive Disclosure | The skill provides a clear overview with well-signaled one-level-deep references to `references/criteria.md` for severity definitions and `references/review-checklists.md` for detailed templates. The main body contains the workflow essentials while deferring detailed reference material appropriately. The structure flows logically from principles through phases to error handling. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
Total | 10 / 11 Passed | |
a3403de
Table of Contents
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.