CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

guv

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.

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

88%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-governed instruction skill: concrete templates, explicit decision gates, and a clean References section backed by a real bundle whose five files all exist. The only refinements are trimming the one duplicative example and inlining per-section reference links.

DimensionReasoningScore

Conciseness

The body is lean and imperative with no explanations of concepts Claude already knows. The one trimmable redundancy: the 'Next Development Step' example restates the Option Framing pattern nearly verbatim, and the Pushback Standard partially overlaps the No-Op rules. This matches 'efficient; minor instances of over-explanation that could be trimmed' — not 5, since one example is duplicative padding; not 3, since there is no true verbosity.

4 / 5

Actionability

For an instruction-only skill the guidance is fully executable: a numbered 7-item governance check, an A–D classification scheme with an explicit proceed gate ('Only proceed with B, C, or D when the benefit is explicit'), a copy-paste-ready option framing template, and two worked examples covering the common cases (cleanup request, next-step request). This matches 'specific examples cover the common cases'.

5 / 5

Workflow Clarity

The workflow is clearly sequenced with explicit validation checkpoints: the mandatory 7-step check, a hard stop gate ('If no material defect, risk, or benefit exists, stop and recommend no change'), the classification gate before proceeding, and a refusal rule for hard safety boundaries ('If an option crosses a hard safety boundary... do not offer it as a choice'). It is a checklist-driven process with decision feedback loops, matching the anchor-5 description; anchor 4 would require missing or merely implicit checkpoints, which are not missing here.

5 / 5

Progressive Disclosure

All five referenced files exist in references/, are one level deep, and are listed in a dedicated References section with consult-when-relevant guidance plus a fallback ('If these files are absent, apply the governance principles defined in this skill directly'). Scored against the actual bundle per the rubric guideline, this is 'good structure; references mostly clear' — the minor gap versus anchor 5 is that pointers are a flat generic list rather than inline, topic-labeled links from each corresponding body section (e.g., No-Op Rules → no-op-policy.md).

4 / 5

Total

18

/

20

Passed

Description

78%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 strong description with an explicit and rich 'use when' clause plus valuable negative (do-not-use) guidance that most descriptions lack. The main weakness is that the 'what' side is a single abstract action, leaving the concrete deliverables of the governance check implicit.

Suggestions

Enumerate the concrete outputs in the 'what' clause, e.g. 'returns a 7-point governance check (purpose, defect/benefit, no-op assessment, architecture constraints, risks, smallest safe change, acceptance test) and classifies cleanup requests A–D' — this would lift specificity from 3 to 4-5.

Add the natural trigger variations users actually say — 'simplify', 'polish', 'should I refactor', 'what should we build next' — to close the synonym gap in trigger_term_quality.

Disambiguate the PR-review trigger from generic code-review skills, e.g. 'use when reviewing a PR for unnecessary or scope-widening changes, not for finding correctness bugs'.

DimensionReasoningScore

Specificity

The description names its domain ('enforces engineering-governance checks before code changes that may be unnecessary, risky, architectural, or scope-widening') but rests on a single abstract action — 'enforces checks' — without enumerating the concrete outputs it produces (governance checklist, A–D cleanup classification, option pre-labeling). It matches the anchor 'names domain and 1-2 concrete actions, but not comprehensive'; a 4 would require several specific actions listed.

3 / 5

Completeness

Both what and when are explicit: 'enforces engineering-governance checks before code changes that may be unnecessary, risky, architectural, or scope-widening' plus a full 'use when...' clause with eight concrete triggers, and an explicit do-not-use clause ('do not use as the primary implementation skill for routine debugging...'). This matches the anchor 'clearly and explicitly answers both what AND when with concrete trigger phrases' — anchor 4 would require the when-clause to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Natural user phrasings are well covered: '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'. A few common variations ('simplify', 'polish', 'should I refactor', 'what should we build next') are absent, so it falls just short of the comprehensive-with-synonyms anchor 5 but clearly above anchor 3.

4 / 5

Distinctiveness Conflict Risk

The governance/no-op/minimal-diff niche is fairly distinct, and the do-not-use clause ('do not use as the primary implementation skill for routine debugging, bug fixes, feature coding') actively reduces mis-triggering. However, 'review a pull request' and 'review a proposed implementation' overlap with general code-review skills, so it is 'mostly distinct; minor overlap risk' rather than the minimal-conflict anchor 5.

4 / 5

Total

16

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

benJephunneh/guv

Path

SKILL.md

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.