CtrlK
BlogDocsLog inGet started
Tessl Logo

tessl-labs/go-error-handling

Error handling for Go HTTP servers — structured error responses, error wrapping,

88

1.80x
Quality

81%

Does it follow best practices?

Impact

99%

1.80x

Average score across 5 eval scenarios

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

Quality

Discovery

89%

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 a strong skill description with excellent trigger terms and completeness. It clearly defines when to apply the skill and targets a specific technical niche. The main weakness is that it describes problems prevented rather than specific actions/patterns provided, which slightly reduces specificity.

Suggestions

Add 1-2 specific concrete actions the skill provides, e.g., 'Implements recovery middleware, structured error responses, and graceful shutdown handlers'

DimensionReasoningScore

Specificity

Names the domain (Go HTTP server error handling) and mentions what it prevents ('panic crashes, inconsistent error formats, swallowed errors, dropped connections'), but doesn't list the specific concrete actions/patterns it provides - only the problems it solves.

2 / 3

Completeness

Clearly answers both what ('Production error handling patterns') and when ('Apply whenever building, extending, or scaffolding a Go backend -- even if the task only asks for routes or CRUD endpoints'). The 'Apply whenever' clause serves as explicit trigger guidance.

3 / 3

Trigger Term Quality

Excellent coverage of natural terms: 'Go HTTP server', 'Go backend', 'routes', 'CRUD endpoints', 'net/http', 'Chi', 'Gin', 'Echo', 'error handling', 'panic crashes'. These are terms developers would naturally use when working on Go backends.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with clear niche: Go-specific, HTTP server-specific, error handling-specific. The mention of specific frameworks (Chi, Gin, Echo) and the focus on production patterns creates a clear, non-conflicting scope.

3 / 3

Total

11

/

12

Passed

Implementation

64%

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

This is a solid, actionable skill with excellent code examples that are production-ready and copy-paste executable. The main weaknesses are verbosity in explanatory sections, a monolithic structure that could benefit from progressive disclosure, and missing explicit implementation sequencing for what claims to be a 'from day one' pattern set.

Suggestions

Trim the 'Why This Matters From Day One' section to 2-3 bullet points - Claude understands why error handling matters

Add an explicit implementation order at the top: '1. Add errors.go, 2. Add response.go, 3. Wire recovery middleware, 4. Add graceful shutdown'

Consider splitting 'Common Patterns' section into a separate PATTERNS.md file and linking to it, keeping SKILL.md focused on the core infrastructure

DimensionReasoningScore

Conciseness

The skill includes valuable content but has some verbosity, particularly in the 'Why This Matters From Day One' section which explains concepts Claude likely understands. The RIGHT/WRONG pattern comparisons add value but could be more compact.

2 / 3

Actionability

Excellent executable code examples throughout - complete, copy-paste ready implementations for error types, middleware, graceful shutdown, and common patterns. Every pattern includes working Go code with proper imports.

3 / 3

Workflow Clarity

The checklist at the end provides clear requirements, but the document lacks explicit sequencing for implementation order. For a 'from day one' skill, it would benefit from a clear 'implement in this order' workflow with validation steps.

2 / 3

Progressive Disclosure

Content is well-organized with clear sections, but it's a monolithic document (~300 lines) that could benefit from splitting detailed patterns (database errors, validation, external services) into separate reference files while keeping SKILL.md as a concise overview.

2 / 3

Total

9

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Reviewed

Table of Contents