CtrlK
BlogDocsLog inGet started
Tessl Logo

use-modern-go

Apply modern Go syntax guidelines based on project's Go version. Use when user ask for modern Go code guidelines.

64

Quality

74%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./claude/modern-go-guidelines/skills/use-modern-go/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

57%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description provides a clear 'Use when' clause and targets a specific language (Go), but lacks specificity about what concrete actions or guidelines it applies. It would benefit from listing specific capabilities (e.g., which syntax features, which Go versions) and expanding trigger terms to cover more natural user phrasings.

Suggestions

Add specific concrete actions, e.g., 'Applies range-over-int, structured logging with slog, generic type constraints, and other version-specific Go syntax patterns.'

Expand trigger terms to include natural variations like 'Go best practices', 'Go idioms', 'Go style', 'Go conventions', 'idiomatic Go', or specific version mentions like 'Go 1.21', 'Go 1.22'.

DimensionReasoningScore

Specificity

The description says 'apply modern Go syntax guidelines' which is vague — it doesn't list any concrete actions like specific syntax features, patterns, or transformations. 'Guidelines' is abstract.

1 / 3

Completeness

It answers both 'what' (apply modern Go syntax guidelines based on project's Go version) and 'when' (when user asks for modern Go code guidelines) with an explicit 'Use when' clause.

3 / 3

Trigger Term Quality

Includes 'Go', 'Go code', 'modern Go', and 'guidelines' which are somewhat relevant keywords, but misses common variations like 'Go best practices', 'Go idioms', 'Go style', 'Go conventions', or specific version references.

2 / 3

Distinctiveness Conflict Risk

It's specific to Go syntax guidelines which narrows the domain, but could overlap with general Go coding skills, Go linting skills, or Go style guide skills. The phrase 'modern Go syntax' provides some distinction but is not highly precise.

2 / 3

Total

8

/

12

Passed

Implementation

92%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is an excellent, highly actionable skill that provides concrete, version-aware Go coding guidelines with clear before/after examples. The version detection mechanism and behavioral instructions are well-designed. The only weakness is that the document is quite long and could benefit from splitting detailed feature references into a separate file, though the version-organized structure partially mitigates this.

Suggestions

Consider splitting the detailed 'Features by Go Version' reference into a separate file (e.g., GO_FEATURES.md) and keeping only a summary table or the most critical patterns in SKILL.md to improve progressive disclosure.

DimensionReasoningScore

Conciseness

The skill is highly token-efficient. It assumes Claude's Go competence, provides no unnecessary explanations of what Go is or how packages work, and every entry is a terse before/after pattern or one-liner showing the modern idiom. No filler text.

3 / 3

Actionability

Every feature includes concrete, copy-paste-ready code examples with clear before/after patterns. The version detection uses an executable shell command, and the behavioral instructions for Claude are specific and unambiguous.

3 / 3

Workflow Clarity

The workflow is clear and well-sequenced: detect version → communicate to user → apply features up to that version. The decision tree for unknown vs. known versions is explicit. This is fundamentally a reference/lookup skill rather than a destructive multi-step process, so no validation checkpoints are needed.

3 / 3

Progressive Disclosure

The content is well-organized with clear version-based sections and a logical hierarchy, but it's a long monolithic document (~200+ lines) with no references to external files. The Go 1.24+ features with before/after examples could be split into a separate reference file to keep the main skill leaner.

2 / 3

Total

11

/

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
JetBrains/go-modern-guidelines
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.