CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

go-best-practices

Provides Go patterns for type-first development with custom types, interfaces, functional options, and error handling. Must use when reading or writing Go files.

1.10x
Quality

83%

Does it follow best practices?

Impact

91%

1.10x

Average score across 3 eval scenarios

SecuritybySnyk

—

The risk profile of this skill

SKILL.md
Quality
Evals
Security

Quality

Content

75%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-structured, code-dense skill body that provides concrete, mostly executable Go patterns with a clear type-first workflow. The main weaknesses are redundant example repetitions, a few placeholder implementations, and no explicit error-recovery feedback loops in the workflow.

Suggestions

Deduplicate examples: define the User struct once and show the exhaustive switch only in its strongest form (typed Status), removing the string-based processStatus repetition in the Examples section.

Replace '// implementation' placeholder bodies with minimal real implementations and add the missing imports (time, context, io, fmt) so snippets are copy-paste ready.

Add a short feedback-loop note to the type-first workflow (e.g., what to do when the compiler rejects a design or boundary validation fails), and consider moving the Configuration section to a references/ file to keep the core skill leaner.

DimensionReasoningScore

Conciseness

The body is lean and code-forward with minimal hand-holding, but the User struct is defined three times (domain model, embed example) and the exhaustive-switch-with-default lesson is demonstrated twice (typed Status and string versions). Not 5 because this redundancy could be trimmed; not 3 because the prose is otherwise efficient.

4 / 5

Actionability

Most patterns ship as concrete, near-executable code (functional options, LoadConfig, ProcessStatus, slog usage), but several snippets carry placeholder bodies ('// implementation') and omit imports (time, context, io, fmt). Not 5 because of those gaps; not 3 because the guidance is mostly executable rather than pseudocode.

4 / 5

Workflow Clarity

The type-first development workflow is a clearly sequenced numbered list (define structs, define signatures, implement, validate at boundaries) with the boundary-validation step acting as a checkpoint. Not 5 because there are no explicit feedback loops or error-recovery guidance for when the compiler-guided process goes wrong; not 3 because the sequence is coherent with most checkpoints present.

4 / 5

Progressive Disclosure

With no bundle files present, the single-file structure is well organized with clear ## and ### sections and no nested references. Not 5 because at ~265 lines the Examples and Configuration sections are substantial enough that they could arguably live in reference files; not 3 because the structure and content placement are good, not merely adequate.

4 / 5

Total

16

/

20

Passed

Description

83%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 that clearly states what the skill covers and when it must be used, with a concrete Go-file trigger. Main improvement opportunities are adding common synonyms ('golang', '.go') and distinguishing it from other Go skills.

DimensionReasoningScore

Specificity

Names the domain (Go) and lists several concrete capability areas — 'custom types, interfaces, functional options, and error handling' — with only minor gaps in coverage. Falls short of 5 because 'patterns' and 'type-first development' frame topics somewhat abstractly rather than enumerating comprehensive concrete actions.

4 / 5

Completeness

Explicitly answers both questions: what it does ('Provides Go patterns for type-first development with custom types, interfaces, functional options, and error handling') and when to use it ('Must use when reading or writing Go files'), a concrete trigger phrase matching the top anchor. Not below 5 because the 'when' clause is explicit, not implied.

5 / 5

Trigger Term Quality

'Must use when reading or writing Go files' is a natural phrase users would say, and the topic keywords (interfaces, functional options, error handling) add trigger coverage. Not 5 because common variations like 'golang' or '.go' file references are missing.

4 / 5

Distinctiveness Conflict Risk

The Go-specific niche and file-based trigger are mostly distinct, but 'reading or writing Go files' would also fire for any other Go-related skill (e.g., testing or build skills), creating minor overlap risk with closely related skills. Not 3 because the domain is specific rather than broadly overlapping.

4 / 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

NeverSight/learn-skills.dev

Path

data/skills-md/0xbigboss/claude-code/go-best-practices/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.