CtrlK
BlogDocsLog inGet started
Tessl Logo

golang-error-handling

Idiomatic Golang error handling — creation, wrapping with %w, errors.Is/As, errors.Join, custom error types, sentinel errors, panic/recover, the single handling rule, structured logging with slog, HTTP request logging middleware, and samber/oops for production errors. Built to make logs usable at scale with log aggregation 3rd-party tools. Apply when creating, wrapping, inspecting, or logging errors in Go code.

81

Quality

78%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/golang-error-handling/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

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

This is an excellent skill description that clearly defines a specific niche (Go error handling), lists comprehensive concrete capabilities, includes abundant natural trigger terms, and provides an explicit 'Apply when...' clause. It is well-scoped and distinctive, making it easy for Claude to select appropriately from a large skill set.

DimensionReasoningScore

Specificity

Lists numerous specific concrete actions and concepts: error creation, wrapping with %w, errors.Is/As, errors.Join, custom error types, sentinel errors, panic/recover, structured logging with slog, HTTP request logging middleware, and samber/oops. This is highly specific and comprehensive.

3 / 3

Completeness

Clearly answers 'what' (idiomatic Go error handling with specific techniques listed) and 'when' with an explicit trigger clause: 'Apply when creating, wrapping, inspecting, or logging errors in Go code.'

3 / 3

Trigger Term Quality

Includes many natural keywords a Go developer would use: 'error handling', 'wrapping', '%w', 'errors.Is', 'errors.As', 'errors.Join', 'sentinel errors', 'panic/recover', 'slog', 'Go code', 'logging errors'. These cover a wide range of terms users would naturally mention.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive — narrowly scoped to Go error handling specifically, with Go-specific terminology (errors.Is/As, %w, slog, samber/oops) that would not conflict with general coding skills or error handling in other languages.

3 / 3

Total

12

/

12

Passed

Implementation

57%

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

This is a well-structured skill with excellent progressive disclosure and a comprehensive best practices summary. Its main weaknesses are the lack of inline executable code examples (all deferred to reference files) and some verbosity in the persona/modes section that doesn't directly contribute to actionable guidance. The workflow descriptions would benefit from explicit validation checkpoints, especially for the audit mode.

Suggestions

Add at least 2-3 inline executable Go code snippets demonstrating key patterns (e.g., wrapping with %w, errors.Is/As usage, slog error logging) to make the SKILL.md actionable without requiring reference file access.

Add explicit validation/feedback steps to the audit mode workflow — e.g., what to do when a sub-agent finds violations, how to prioritize fixes, and how to verify corrections.

Trim the persona and modes sections — the persona description and mode explanations could be condensed to 2-3 lines total, saving tokens for more actionable content.

DimensionReasoningScore

Conciseness

The content is mostly efficient with a well-structured summary list and clear references, but includes some unnecessary verbosity — the persona section, mode descriptions, and the community default note add tokens without much actionable value. The best practices summary is tight, but the detailed reference descriptions repeat information that could be left to the referenced files.

2 / 3

Actionability

The best practices summary provides specific, concrete rules (e.g., 'use fmt.Errorf("{context}: %w", err)'), but there are no executable code examples in the SKILL.md itself — all concrete code is deferred to reference files. The guidance is specific enough to act on but falls short of copy-paste ready without the referenced files.

2 / 3

Workflow Clarity

The three modes (Coding, Review, Audit) provide some workflow structure, and the parallel sub-agent audit breakdown is well-organized. However, there are no explicit validation checkpoints or feedback loops — for example, the audit mode doesn't specify what to do when violations are found, and the coding mode's background sub-agent suggestion lacks concrete steps for handling discovered issues.

2 / 3

Progressive Disclosure

Excellent progressive disclosure structure: a concise overview with numbered best practices, clearly signaled one-level-deep references to three detailed files (error-creation.md, error-wrapping.md, error-handling.md), cross-references to related skills, and external library references. Navigation is clear and well-organized.

3 / 3

Total

9

/

12

Passed

Validation

81%

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

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

9

/

11

Passed

Repository
samber/cc-skills-golang
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.