CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

commit-guards

Load to add, tune, or debug a commit guard lane, its git hooks, or COMMIT_GUARDS_* settings.

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/commit-guards/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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.

An exceptionally actionable reference: exact commands, a complete configuration table, precise formats, explicit hook chains, and error remedies. Its weaknesses are density — long subordinated prose with restated scope rules — and inlined deep-dive material alongside two doc references that do not resolve in the bundle.

Suggestions

Move the pre-push scope derivation and the generated-inventory error handling into a reference document (or into the already-cited DEVELOPMENT.md/CHECKS.md), keeping a two-to-three line summary plus the link in SKILL.md.

Tighten the pre-push section: state the scope rule once, drop the repeated byte-ceiling/baseline restatements and the duplicated DEVELOPMENT.md scope link within the same passage.

Ship CHECKS.md and README.md inside the bundle (or link their canonical hosted URLs the way DEVELOPMENT.md is linked) so the relative references resolve where the skill is installed.

DimensionReasoningScore

Conciseness

There is no beginner-concept padding and every sentence carries real configuration or behavior detail, but the prose is baroque ("Two refusals keep the verdict about the thing being pushed, since every range scope there ends at HEAD...") and restates facts — the byte-ceiling baseline rule appears twice in one paragraph and the index/HEAD scope rule repeats across paragraphs — so noticeable tightening is possible. It is above anchor 2 because nothing is filler or material Claude already knows.

3 / 5

Actionability

The opening block gives copy-paste-ready commands with flags ("commit-guards all --staged", "install-git-hooks --check"), the checks table states exact per-check verdict rules, the configuration table enumerates every key with its default and meaning, and the excludes/baseline line formats are specified precisely — fully executable guidance covering the common cases.

5 / 5

Workflow Clarity

The pre-commit order is given as an explicit chain ("doc-limits --staged when installed -> preflight --staged when installed -> one review-file check -> commit-guards all --staged"), exit codes are defined, "install-git-hooks --check" serves as a read-only verification step, and failure remedies are explicit (run "kendex refresh", install jq). It falls short of anchor 5 because no ordered procedure exists for the skill's own load-time tasks, such as enabling byte-ceiling or adding a local pre-commit entry.

4 / 5

Progressive Disclosure

Section headers are clear, links are well signaled, and every cited script path (scripts/commit-guards, scripts/md-refs, scripts/lib/comment-text.sh, etc.) resolves in the bundle — but the multi-paragraph pre-push scope derivation and the generated-inventory jq error handling are inlined detail that belongs in a reference file, and the relative links to CHECKS.md and README.md do not resolve within this bundle, leaving "Full check shapes and scopes" unreachable locally. Structure and signaling are too good for anchor 2, but the inlining and dangling references block anchor 4.

3 / 5

Total

15

/

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 tight, third-person description with concrete verbs, named targets, and product-specific namespaces that keep conflict risk minimal. Its only real gap is that the when-side trigger is terse and the guard chain's actual checks are left to the summary field.

DimensionReasoningScore

Specificity

"add, tune, or debug" names three concrete actions applied to specific targets ("a commit guard lane, its git hooks, or COMMIT_GUARDS_* settings"), matching the several-specific-actions anchor; it stops short of anchor 5 because it never states what the guards actually check (markers, bytes, secrets, commit messages).

4 / 5

Completeness

The what is clear (add/tune/debug lanes, hooks, and settings) and "Load to add, tune, or debug..." functions as explicit trigger guidance, so it rises above anchor 3; it falls short of anchor 5 because the trigger is purpose-shaped rather than concrete phrases a user would utter (e.g. "when the user asks to install pre-commit hooks").

4 / 5

Trigger Term Quality

"commit guard", "git hooks", and "COMMIT_GUARDS_*" are terms users would naturally say when seeking this skill, but common variations like "pre-commit hook", "commit message", or "lint" are absent, so it fits the good-coverage-with-a-few-missing anchor rather than the comprehensive one.

4 / 5

Distinctiveness Conflict Risk

"commit guard lane" and the COMMIT_GUARDS_* settings namespace name a clear niche specific to this toolchain, so the description is unlikely to fire for unrelated skills despite touching the broadly shared "git hooks" territory.

5 / 5

Total

17

/

20

Passed

Validation

75%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 12 missing

Warning

referenced_paths_exist

Referenced path issues: 1 deeper-than-1-level

Warning

Total

12

/

16

Passed

Repository

vanillagreencom/kendex

Path

skills/commit-guards/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.