CtrlK
BlogDocsLog inGet started
Tessl Logo

golang-patterns

Idiomatic Go patterns, best practices, and conventions for building robust, efficient, and maintainable Go applications. Use when writing or reviewing Go code and idiomatic structure or conventions are in question.

58

Quality

68%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/golang-patterns/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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-organized, code-dense Go patterns reference with strong actionable examples and a useful tooling section. Its main weaknesses are length-driven redundancy — much of it restates standard Go knowledge Claude already has — and a fully monolithic structure with no progressive disclosure into reference files.

Suggestions

Split the body into one-level-deep reference files (e.g. references/error-handling.md, references/concurrency.md, references/tooling.md) and keep SKILL.md as a lean overview with a quick-reference table, cutting the inline catalog to the patterns that are genuinely non-obvious.

Trim examples that restate what Claude already knows (strings.Join, sync.Pool basics, standard io.Reader/Writer definitions) and drop duplicated 'Bad/Good' pairs where the bad version is self-evidently bad.

Add brief usage checkpoints to the tooling section (e.g. 'run go vet and staticcheck before considering a review complete; fix or explicitly justify every finding') so the sequence of checks has explicit validation semantics.

DimensionReasoningScore

Conciseness

The body is lean in style — terse code examples with one-line commentary, no tutorial prose — but at ~670 lines it extensively documents concepts Claude already knows well (error wrapping, worker pools, sync.Pool, strings.Join, functional options), with some redundancy (three join variants, 'Best: use standard library' restating the obvious). This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than anchor 4, because large sections restate standard Go knowledge that adds little beyond what Claude already has.

3 / 5

Actionability

Nearly all guidance is concrete, executable Go with copy-paste-ready patterns plus a real command cheatsheet (go vet, golangci-lint, go test -race) and a concrete .golangci.yml. It falls short of anchor 5 because many snippets depend on undefined helpers (db.FindUser, process(job), fetch(url)) and omit import blocks, making them illustrative templates rather than fully runnable code — 'mostly executable... with minor gaps'.

4 / 5

Workflow Clarity

As a reference/catalog skill there is no multi-step process to sequence; sections are clearly ordered (When to Activate, Core Principles, Error Handling, Concurrency, Interface Design, Package Organization, Struct Design, Performance, Tooling, Anti-Patterns) with a quick-reference idiom table. This earns anchor 4 ('good structure, minor gaps') rather than 5 because anchor 5's explicit validation checkpoints/feedback loops are absent — the closest analog, the tooling section, lists commands but never says when to run them or how to act on failures.

4 / 5

Progressive Disclosure

The body has real section structure and is scannable, so it is above anchor 2's 'minimal structure'. But the entire ~670-line catalog lives inline in SKILL.md with no references/ split — error handling, concurrency, linter configuration, and performance sections are each substantial enough to be separate files — which matches anchor 3 exactly: 'some structure but could be better organized; content that should be separate is inline'.

3 / 5

Total

14

/

20

Passed

Description

73%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 solid description that explicitly states both what the skill covers and when to use it, with a clear Go-specific niche and natural trigger phrasing around writing/reviewing Go code. Its main weakness is that the 'what' is expressed in generic category nouns (patterns, best practices, conventions) rather than concrete capabilities, and it misses common synonyms like 'Golang'.

Suggestions

Replace generic category nouns with concrete capability phrases, e.g. 'Apply error-wrapping, concurrency (worker pools, errgroup, context cancellation), interface design, and package-layout patterns for Go'.

Add natural synonyms and variations to the trigger clause, e.g. 'Use when writing, reviewing, or refactoring Go (Golang) code, or when Go style, idioms, or conventions are in question'.

Keep the third-person declarative style and avoid padding; the description is already close to optimal length.

DimensionReasoningScore

Specificity

The description names the domain ("Idiomatic Go patterns, best practices, and conventions for building robust, efficient, and maintainable Go applications") but the stated capabilities are generic category nouns rather than concrete actions — there is no parallel to 'extract text, fill forms, merge documents'. It sits between anchor 2 ('actions are minimal or generic') and anchor 3 ('domain and 1-2 concrete actions'), and the enumerated pattern/best-practice/convention categories keep it at 3 rather than 2.

3 / 5

Completeness

Both 'what' ("Idiomatic Go patterns, best practices, and conventions...") and 'when' ("Use when writing or reviewing Go code and idiomatic structure or conventions are in question") are explicitly present, so it clears the anchor-3 cap for missing triggers. It does not reach anchor 5 because the 'what' is broad and abstract rather than concrete trigger-linked capabilities, and the 'when' clause ('idiomatic structure or conventions are in question') is slightly stilted compared to the anchor-5 phrasing.

4 / 5

Trigger Term Quality

"Use when writing or reviewing Go code and idiomatic structure or conventions are in question" captures natural phrases users would say (writing/reviewing Go code, idiomatic, conventions, best practices). It falls short of anchor 5's comprehensive synonym/extension coverage — e.g. 'Golang', 'Go code review', 'Go style' — but beats anchor 3's 'missing common variations'.

4 / 5

Distinctiveness Conflict Risk

The Go-specific framing ("Go code", "Go applications", "idiomatic") carves out a clear niche with distinct triggers, matching anchor 5's 'clear niche with distinct triggers; minimal conflict risk'. The only overlap risk is with generic code-review skills when 'reviewing Go code' is said, but the explicit Go domain marker keeps that minimal, so it does not drop to anchor 4.

5 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (677 lines); consider splitting into references/ and linking

Warning

metadata_version

'metadata.version' is missing

Warning

Total

14

/

16

Passed

Repository
affaan-m/ECC
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.