CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

golang-samber-oops

Structured error handling in Golang with samber/oops — error builders, stack traces, error codes, error context, error wrapping, error attributes, user-facing vs developer messages, panic recovery, and logger integration. Apply when using or adopting samber/oops, or when the codebase already imports github.com/samber/oops.

69

Quality

87%

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

82%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, highly actionable reference skill: executable code examples dominate, best practices are framed as concrete DO/DON'T patterns, and advanced material is correctly pushed to a real, clearly signaled reference file. The main improvement opportunities are trimming duplicated rationale in the intro and offloading the full API table to the references directory.

DimensionReasoningScore

Conciseness

The body is dense and example-driven with almost no explanation of concepts Claude already knows, but the "Why use samber/oops" bullet list repeats the low-cardinality point already made in the intro, and the persona/cross-reference prose could be trimmed — minor instances of padding that fit the anchor-4 example.

4 / 5

Actionability

Fully executable, copy-paste-ready Go snippets cover the common cases (repository, HTTP handler, service-layer reusable builder, panic recovery, context propagation, output formats), supplemented by a complete builder-method table and DO/DON'T contrasts — matching the top anchor.

5 / 5

Workflow Clarity

This is a pattern/reference skill rather than a multi-step process, and each pattern is unambiguous with clear layering guidance ("at least once per package boundary"). No validation checkpoints are needed for this non-destructive domain, but there is no explicit adoption/migration sequence, placing it just below the top anchor.

4 / 5

Progressive Disclosure

The single bundle file (references/advanced.md) is real, one level deep, and clearly signaled ("For assertions, configuration, and additional logger examples, see [Advanced patterns](./references/advanced.md)"), matching its actual content. However, the full builder-method API table and output-format details are inlined in SKILL.md where a reference file could carry them — good structure with minor organization gaps.

4 / 5

Total

17

/

20

Passed

Description

88%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 concretely lists the library's capabilities and pairs them with an explicit, well-targeted trigger clause. Trigger-term coverage is good but could add common phrasings, and the broad 'error handling in Golang' framing carries slight overlap risk with general Go error-handling skills.

DimensionReasoningScore

Specificity

The description enumerates concrete capabilities — "error builders, stack traces, error codes, error context, error wrapping, error attributes, user-facing vs developer messages, panic recovery, and logger integration" — giving comprehensive coverage of the library's feature surface with no significant gaps.

5 / 5

Completeness

It explicitly answers both what (the structured-error-handling capability list) and when ("Apply when using or adopting samber/oops, or when the codebase already imports github.com/samber/oops") with concrete trigger phrases, matching the top anchor exactly.

5 / 5

Trigger Term Quality

Good natural keyword coverage ("samber/oops", "github.com/samber/oops", "error handling", "error wrapping", "stack traces", "panic recovery", "Golang"), but common variations users might say — plain "Go errors", "wrap errors", "err" — are missing, matching the 'good coverage, a few natural terms missing' anchor rather than the comprehensive one.

4 / 5

Distinctiveness Conflict Risk

The import-path trigger ("codebase already imports github.com/samber/oops") is highly distinct, but the opening phrase "Structured error handling in Golang" overlaps with general Go error-handling skills — the body itself cross-references a sibling `golang-error-handling` skill — so minor overlap risk remains.

4 / 5

Total

18

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

samber/cc-skills-golang

Path

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