enforces engineering-governance checks before code changes that may be unnecessary, risky, architectural, or scope-widening. use when the user asks whether to refactor, clean up, redesign, choose a next development step, review a proposed implementation, evaluate architectural consistency, review a pull request, or prevent development drift. do not use as the primary implementation skill for routine debugging, bug fixes, feature coding, or language-specific coding unless a no-op, minimal-diff, or architecture-conflict judgment is needed.
90
88%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Quality
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 a strong skill description that clearly defines a governance-oriented role distinct from implementation skills. It excels in providing explicit trigger terms, clear 'use when' and 'do not use' guidance, and specific concrete actions. The inclusion of negative boundaries ('do not use as the primary implementation skill for...') is particularly effective for disambiguation in a multi-skill environment.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description lists multiple specific concrete actions: enforcing engineering-governance checks, evaluating whether changes are unnecessary/risky/architectural/scope-widening, reviewing pull requests, evaluating architectural consistency, and making no-op/minimal-diff/architecture-conflict judgments. | 3 / 3 |
Completeness | Clearly answers both 'what' (enforces engineering-governance checks before code changes that may be unnecessary, risky, architectural, or scope-widening) and 'when' (explicit 'use when' clause with multiple trigger scenarios), plus includes a helpful 'do not use' clause that further clarifies boundaries. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'refactor', 'clean up', 'redesign', 'next development step', 'review a proposed implementation', 'architectural consistency', 'review a pull request', 'development drift'. These are terms developers naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | The description carves out a very clear niche as a governance/gatekeeping skill distinct from implementation skills. The explicit 'do not use' clause for routine debugging, bug fixes, and feature coding effectively prevents conflicts with coding-focused skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong governance-oriented skill with highly actionable checklists, clear decision frameworks, and well-structured workflows. Its main weakness is moderate verbosity—some principles are restated across sections, and the inline examples, while valuable, contribute to length. The referenced bundle files don't exist, slightly undermining the progressive disclosure structure.
Suggestions
Consolidate overlapping principles (e.g., the no-op stance appears in the Mandatory Governance Check, No-Op Rules, and Cleanup Classification sections) to reduce redundancy and improve conciseness.
Consider moving the two worked examples into a separate references/governance-examples.md file to keep the main skill leaner while preserving their value.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient and avoids explaining concepts Claude already knows, but there is some repetition across sections (e.g., the no-op principle is restated in multiple places, and the option framing pattern is somewhat verbose). The examples, while useful, add length that could be tightened. | 2 / 3 |
Actionability | The skill provides highly concrete, actionable guidance: a specific 7-point governance checklist, an A-D classification system for cleanup requests, a structured option framing template with exact labels, and two worked examples showing the exact output format. Claude can follow these instructions directly without ambiguity. | 3 / 3 |
Workflow Clarity | The multi-step governance check is clearly sequenced (7 numbered steps), with an explicit validation checkpoint ('if no material defect, risk, or benefit exists, stop and recommend no change'). The cleanup classification (A-D) provides a clear decision gate, and the option framing rule includes explicit proceed/refuse conditions that serve as feedback loops. | 3 / 3 |
Progressive Disclosure | The skill references five supporting files in a references directory, which is good progressive disclosure design. However, no bundle files are provided, so these references are aspirational rather than functional. The main content itself is well-structured with clear sections but includes substantial inline detail (examples, option framing templates) that could potentially be split out for a cleaner overview. | 2 / 3 |
Total | 10 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
c7974e2
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.