Creates explicit validation checkpoints (verification gates) between project phases to catch errors early and ensure quality before proceeding. Use when the user asks about quality gates, milestone checks, phase transitions, approval steps, go/no-go decision points, or preventing cascading errors across a multi-step workflow. Produces acceptance criteria checklists, automated CI gate configurations, manual sign-off requirements, and conditional review rules for scenarios such as security changes, API changes, or database migrations.
73
67%
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 ./packages/core/src/methodology/packs/planning/verification-gates/SKILL.mdQuality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that clearly articulates what the skill does, when to use it, and provides specific trigger terms and output artifacts. It uses proper third-person voice throughout, lists concrete deliverables, and includes scenario examples that further clarify scope. The description is comprehensive yet not overly verbose.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Creates explicit validation checkpoints', 'produces acceptance criteria checklists, automated CI gate configurations, manual sign-off requirements, and conditional review rules' with specific scenarios like 'security changes, API changes, or database migrations'. | 3 / 3 |
Completeness | Clearly answers both 'what' (creates validation checkpoints, produces checklists, CI gate configs, sign-off requirements, conditional review rules) and 'when' (explicit 'Use when...' clause listing quality gates, milestone checks, phase transitions, approval steps, go/no-go decisions, preventing cascading errors). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'quality gates', 'milestone checks', 'phase transitions', 'approval steps', 'go/no-go decision points', 'preventing cascading errors', 'multi-step workflow', 'verification gates'. These are terms users would naturally use when seeking this functionality. | 3 / 3 |
Distinctiveness Conflict Risk | Occupies a clear niche around validation checkpoints and quality gates between project phases. The specific focus on phase transitions, go/no-go decisions, and CI gate configurations makes it highly distinguishable from general project management or CI/CD skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
35%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is overly verbose, restating standard software development lifecycle phases as verification gates without adding much that Claude wouldn't already know. The CI/CD YAML examples and gate documentation template provide some concrete value, but the bulk of the content consists of generic checklists with obvious items. The skill would benefit greatly from being condensed to focus on the novel aspects (conditional gates, CI integration, gate metrics) while dropping the textbook SDLC material.
Suggestions
Cut the five 'Standard Verification Gates' section dramatically—Claude already knows SDLC phases. Instead, focus on the pattern of creating custom gates with the template, and provide 1-2 concrete examples rather than 5 generic ones.
Move the CI/CD integration examples and conditional gates table to the top as the primary actionable content, since these are the most concrete and useful parts.
Add concrete failure-recovery examples showing what happens when a gate fails (e.g., a specific error message and the corrective action), rather than just placeholder text in the template.
Split detailed CI configurations and the gate documentation template into separate reference files, keeping SKILL.md as a concise overview with the quick reference table and links to details.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose for what it communicates. Much of this is generic project management knowledge Claude already knows (what requirements verification is, what code review involves, etc.). The five standard gates are textbook SDLC phases restated as checklists with obvious items like 'code compiles/runs without errors'. Could be reduced to ~30% of its length without losing actionable value. | 1 / 3 |
Actionability | Provides some concrete artifacts (CI YAML configs, GitHub Actions example, checklist templates) that are copy-paste ready, but the majority of content is generic checklists with items like 'ambiguities have been resolved with stakeholders' that describe rather than instruct. The CI examples are useful but the standard gates are more descriptive than executable. | 2 / 3 |
Workflow Clarity | The five-gate sequence is clearly ordered and the ASCII flow diagram helps visualize the process. However, the failure/recovery paths are only mentioned in the template ('Failure Actions') but never actually demonstrated with concrete examples. The gate documentation template mentions failure actions but leaves them as placeholders rather than showing real feedback loops. | 2 / 3 |
Progressive Disclosure | The content is a monolithic wall of text at ~200+ lines that could benefit from splitting detailed gate definitions, CI examples, and templates into separate reference files. The 'Integration with Other Skills' section at the end hints at cross-references but the main content is all inline. The quick reference table at the end is helpful but comes too late. | 2 / 3 |
Total | 7 / 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 |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
dfa8d12
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.