CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

go-directive-bump-needs-ci-go-version

Use when raising the go directive in go.mod, or CI fails with 'go.mod requires go >= X (running go Y; GOTOOLCHAIN=local)'. Make CI install the go.mod version.

Quality

89%

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

92%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 exemplary lean, single-purpose skill: the fix is copy-paste-ready YAML, the trigger includes the exact CI error, and the Why section supplies genuinely non-obvious toolchain knowledge (setup-go@v6's GOTOOLCHAIN=local behavior) rather than restating what Claude already knows. The only deduction is for un-quarantined version-sensitive claims (setup-go@v6 behavior, the 1.26.x example) that will age and are not placed in an 'old patterns' section.

Suggestions

Move version-sensitive claims (setup-go@v6 sets GOTOOLCHAIN=local; older versions keep auto) into a short 'Old patterns / version notes' section so the main flow stays evergreen.

Generalize the concrete example versions (go 1.26.10 vs 1.26.9) to placeholders like 'go >= X (running go Y)' to match the description and avoid staleness.

DimensionReasoningScore

Conciseness

The body is lean with no filler and no explanation of concepts Claude already knows; the Trigger/Fix/Why structure earns its tokens. It misses score 5 because it embeds time-sensitive version claims — 'actions/setup-go@v6 sets GOTOOLCHAIN=local', 'A range such as go-version: 1.26.x', 'Older setup-go versions keep GOTOOLCHAIN=auto', and a concrete 1.26.10/1.26.9 error example — that are not quarantined in an 'old patterns'/'deprecated' section, per the guideline penalizing version-specific information in the main flow.

4 / 5

Actionability

The Fix section is a complete, copy-paste-ready YAML snippet ('uses: actions/setup-go@v6 / with: go-version-file: go.mod') that directly resolves the stated trigger, matching the 'fully executable; copy-paste ready' anchor. The Why section adds the non-obvious factual detail (GOTOOLCHAIN behavior differences across setup-go versions) that makes the fix trustworthy rather than magical.

5 / 5

Workflow Clarity

This is a simple, single-purpose skill and the single action is unambiguous — the scoring notes allow a 5 in that case. Trigger, Fix, and Why are clearly separated; the fix is a one-line configuration change, not a destructive or batch operation, so no validation checkpoint is required.

5 / 5

Progressive Disclosure

The skill is under 20 lines with no need for external references (verified: no references/, scripts/, or assets/ directories exist), and the content is organized into clear Trigger/Fix/Why sections. Per the guideline for skills under 50 lines with no need for external references, this matches the top anchor for a self-contained skill.

5 / 5

Total

19

/

20

Passed

Description

81%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, tightly-scoped description with excellent trigger terms: it quotes the exact CI error a user would paste, and the 'when' guidance is fully explicit. The main weakness is the thin 'what' — a single terse outcome sentence with no concrete fix mechanism — which leaves specificity and completeness slightly below the top anchors.

Suggestions

Make the 'what' more concrete by naming the actual fix mechanism, e.g. 'Configures actions/setup-go to read the Go version from go.mod (go-version-file) instead of a hardcoded range.'

Add one or two natural trigger variations users might phrase differently, such as 'bump/upgrade the Go version in go.mod' or 'setup-go picks an older Go than go.mod', to broaden the when-clause without adding fluff.

DimensionReasoningScore

Specificity

The description names the domain ('go directive in go.mod', 'CI') and one concrete action ('Make CI install the go.mod version'), but does not enumerate the specific mechanisms (e.g., setup-go with go-version-file) or multiple capability actions. It fits the 'names domain and 1-2 concrete actions, but not comprehensive' anchor — above score 2 because the action is genuinely concrete, below score 4 because coverage of what the skill actually does is a single terse outcome statement.

3 / 5

Completeness

'When' is explicit and concrete (two triggers, one an exact error message), and 'what' is present ('Make CI install the go.mod version'), so both boxes are checked as in the score-4 anchor. It falls short of score 5 because the 'what' is a single high-level outcome statement that omits the concrete fix mechanism (setup-go/go-version-file), leaving the what-side less explicit than the when-side.

4 / 5

Trigger Term Quality

It includes the natural terms a user would say or paste in this niche: 'raising the go directive', 'go.mod', 'CI fails', and the verbatim error string 'go.mod requires go >= X (running go Y; GOTOOLCHAIN=local)' — including the GOTOOLCHAIN detail and file name. Coverage is comprehensive for this domain (synonym 'raising the go directive' for 'bump go version', the literal CI error text), matching the top anchor rather than the 'a few natural terms missing' anchor at 4.

5 / 5

Distinctiveness Conflict Risk

The trigger is a narrow, well-defined niche — the go.mod go directive plus a specific CI toolchain error — with distinct trigger phrases that no other plausible skill would claim, matching the 'clear niche with distinct triggers; minimal conflict risk' anchor. It is clearly above score 4, which requires only minor overlap risk with closely related skills.

5 / 5

Total

17

/

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

coralogix/terraform-provider-coralogix

Path

.claude/skills/go-directive-bump-needs-ci-go-version/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.