CtrlK
BlogDocsLog inGet started
Tessl Logo

golang-concurrency

Golang concurrency patterns. Use when writing or reviewing concurrent Go code involving goroutines, channels, select, locks, sync primitives, errgroup, singleflight, worker pools, or fan-out/fan-in pipelines. Also triggers when you detect goroutine leaks, race conditions, channel ownership issues, or need to choose between channels and mutexes.

84

1.39x
Quality

81%

Does it follow best practices?

Impact

92%

1.39x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

62%

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 concurrency skill with strong organizational choices — the mode definitions, decision tables, and checklist are effective. Its main weaknesses are the lack of inline executable code examples (all deferred to reference files that aren't provided) and some unnecessary explanatory text that Claude already knows. The workflow clarity is strong with explicit validation checkpoints and clear multi-mode operation.

Suggestions

Add at least 2-3 inline executable code examples for the most critical patterns (e.g., errgroup with context, proper goroutine shutdown with context.Done in select) rather than deferring all code to reference files.

Trim the opening paragraph and principle explanations — remove 'Go's concurrency model is built on goroutines and channels' and similar statements Claude already knows; keep only the non-obvious guidance.

Provide the referenced bundle files (references/channels-and-select.md, references/sync-primitives.md, references/pipelines.md) to make the progressive disclosure structure functional.

DimensionReasoningScore

Conciseness

The skill is mostly efficient with good use of tables and checklists, but includes some unnecessary explanatory text (e.g., 'Go's concurrency model is built on goroutines and channels' and explanations of what goroutines are). The opening paragraph and some principle explanations tell Claude things it already knows. The persona and modes section adds useful framing but the 'community default' note is meta-noise.

2 / 3

Actionability

The skill provides concrete guidance through tables, checklists, and specific tool references (errgroup.SetLimit, goleak, -race flag), but lacks executable code examples in the main body. The audit mode sub-agent instructions are actionable, but core patterns like worker pools and channel usage defer all code to reference files. For a concurrency skill, at least one inline code snippet demonstrating a key pattern would significantly improve actionability.

2 / 3

Workflow Clarity

The three modes (Write, Review, Audit) are clearly defined with distinct workflows. The concurrency checklist provides an explicit pre-flight validation sequence. The audit mode has a clear 5-step parallel process. The common mistakes table serves as a validation reference. For write mode, the checklist acts as a checkpoint before spawning goroutines, which is the critical validation step for this domain.

3 / 3

Progressive Disclosure

The skill references multiple external files (references/channels-and-select.md, references/sync-primitives.md, references/pipelines.md) and cross-references other skills, which is good structure. However, no bundle files were provided, so these references are unverifiable. The main body contains substantial inline content (multiple large tables) that could arguably be split out, while the code examples that would be most useful inline are deferred to reference files.

2 / 3

Total

9

/

12

Passed

Description

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 its scope (Go concurrency patterns), lists specific concrete capabilities and concepts, and provides explicit trigger guidance with both a 'Use when' and 'Also triggers when' clause. The description is concise yet comprehensive, uses third-person voice appropriately, and includes a rich set of natural trigger terms that developers would actually use.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions and concepts: goroutines, channels, select, locks, sync primitives, errgroup, singleflight, worker pools, fan-out/fan-in pipelines, goroutine leaks, race conditions, channel ownership issues, and choosing between channels and mutexes.

3 / 3

Completeness

Clearly answers both 'what' (Golang concurrency patterns, writing/reviewing concurrent Go code) and 'when' with an explicit 'Use when...' clause listing specific triggers, plus an additional 'Also triggers when...' clause for detection scenarios.

3 / 3

Trigger Term Quality

Excellent coverage of natural terms a user would use: 'goroutines', 'channels', 'select', 'locks', 'sync primitives', 'errgroup', 'singleflight', 'worker pools', 'fan-out/fan-in', 'goroutine leaks', 'race conditions', 'concurrent Go code'. These are exactly the terms developers would naturally use.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche: Go concurrency specifically. The detailed list of Go-specific primitives (errgroup, singleflight, channels) and concurrency-specific concerns (goroutine leaks, race conditions) make it very unlikely to conflict with general Go skills or concurrency skills in other languages.

3 / 3

Total

12

/

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.