CtrlK
BlogDocsLog inGet started
Tessl Logo

golang-design-patterns

Idiomatic Golang design patterns — functional options, constructors, error flow and cascading, resource management and lifecycle, graceful shutdown, resilience, architecture, dependency injection, data handling, and streaming. Apply when designing Go APIs, structuring applications, choosing between patterns, making design decisions, architectural choices, or production hardening.

87

Quality

86%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

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 a strong skill description that clearly enumerates specific Go design patterns, uses natural trigger terms a Go developer would use, and includes an explicit 'Apply when...' clause covering multiple relevant scenarios. The description is concise yet comprehensive, covering both the capability scope and activation conditions effectively.

DimensionReasoningScore

Specificity

Lists multiple specific concrete patterns and actions: functional options, constructors, error flow and cascading, resource management and lifecycle, graceful shutdown, resilience, architecture, dependency injection, data handling, and streaming. These are concrete, recognizable Go design concepts.

3 / 3

Completeness

Clearly answers both 'what' (idiomatic Golang design patterns covering functional options, constructors, error flow, etc.) and 'when' ('Apply when designing Go APIs, structuring applications, choosing between patterns, making design decisions, architectural choices, or production hardening'). The explicit 'Apply when...' clause satisfies the trigger guidance requirement.

3 / 3

Trigger Term Quality

Includes strong natural keywords users would say: 'Golang', 'Go APIs', 'functional options', 'graceful shutdown', 'dependency injection', 'error flow', 'design patterns', 'production hardening', 'architectural choices'. These cover a wide range of terms a Go developer would naturally use.

3 / 3

Distinctiveness Conflict Risk

Clearly scoped to Go/Golang design patterns specifically, with distinct triggers like 'Go APIs', 'Golang', 'functional options', and 'graceful shutdown'. Unlikely to conflict with general coding skills or skills for other languages due to the language-specific and pattern-specific terminology.

3 / 3

Total

12

/

12

Passed

Implementation

72%

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 Go design patterns skill that provides strong actionable code examples and excellent progressive disclosure through cross-references to companion skills and reference files. The content is mostly concise but includes some explanatory commentary that Claude doesn't need. The workflow clarity is adequate for a pattern reference but could benefit from more explicit checklists for the review mode.

Suggestions

Trim explanatory phrases Claude already knows, such as 'runs implicitly, makes testing harder, and creates hidden dependencies' for init() — the rule itself is sufficient.

Add a concrete checklist for Review mode (e.g., '1. Check for init() usage, 2. Check for unbounded resources, 3. Check for missing timeouts...') to make the review workflow more actionable.

DimensionReasoningScore

Conciseness

Generally efficient with good use of tables and code examples, but some explanations are unnecessary for Claude (e.g., explaining why init() is bad, explaining what defer does). The best practices summary is dense and useful, but some inline commentary like 'they scale better as APIs evolve' and 'later code changes can accidentally skip cleanup' explain things Claude already knows.

2 / 3

Actionability

Provides fully executable, copy-paste ready Go code examples for functional options, regexp compilation, embed directives, resource management, and timeout patterns. The code is complete and idiomatic, not pseudocode.

3 / 3

Workflow Clarity

This is a pattern reference rather than a multi-step workflow, so strict sequencing is less critical. However, the two operational modes (Design mode and Review mode) are described but lack concrete validation steps — Review mode says 'scan for issues, report findings before suggesting refactors' but doesn't provide a checklist or explicit sequence for the review process.

2 / 3

Progressive Disclosure

Excellent progressive disclosure with a clear overview in the main file and well-signaled one-level-deep references to both internal files (references/data-handling.md, references/resource-management.md, references/architecture.md, etc.) and cross-referenced skills. The detailed guides table is particularly well-organized for navigation.

3 / 3

Total

10

/

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.