CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

golang-code-style

Golang code style conventions — line length and breaking, variable declarations, control flow clarity, when comments help vs hurt. Use when writing or reviewing Go code, asking about style or clarity, or establishing project coding standards. Not for naming conventions (→ See `samber/cc-skills-golang@golang-naming` skill), linter configuration (→ See `samber/cc-skills-golang@golang-lint` skill), or doc comments (→ See `samber/cc-skills-golang@golang-documentation` skill).

84

1.27x
Quality

85%

Does it follow best practices?

Impact

84%

1.27x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

78%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 dense, example-driven rule set that assumes Go competence and wastes almost no tokens, with clean one-level-deep offloading of edge-case detail to references/details.md. The main gaps are sections lacking code examples, one description-promised topic (comments) missing entirely, and an underspecified merge step in the parallel-review workflow.

Suggestions

Add a short "Comments" section covering "when comments help vs hurt" — the description promises it but the body never delivers it.

Add one compact code example each for String Handling and Type Conversions, the two rule areas with no illustration.

Specify how findings from the up-to-5 parallel sub-agents are merged and deduplicated (e.g., group by file/rule, drop already-flagged violations).

DimensionReasoningScore

Conciseness

Rules are stated tersely ("Nil maps panic on write; nil slices serialize to null in JSON") with minimal, purposeful code examples — near the lean score-5 anchor. It stays at 4 because of minor trimmable material: the orchestration-mode preamble, the community-default blockquote, and a "Cross-References" section that repeats sibling-skill links already made inline.

4 / 5

Actionability

Most rules are paired with executable good/bad Go examples ("mux.HandleFunc(...)" with one-arg-per-line, the default-then-override switch, named-boolean conditions), matching the mostly-executable score-4 anchor. Not 5 because a few sections — String Handling, Type Conversions, Code Organization — are guidance-only with no example, and one capability advertised in the description ("when comments help vs hurt") has no corresponding section at all.

4 / 5

Workflow Clarity

The skill's core task is unambiguous (apply these rules; "When ignoring a rule, add a comment to the code" is an explicit policy), and the review workflow is sequenced ("use up to 5 parallel sub-agents, each targeting an independent style concern ... and merge their findings") — the score-4 anchor fit. Not 5 because the merge/dedup step of the parallel review has no checkpoint or detail; not 3 because the destructive/batch validation cap does not apply and the primary flow has no implicit gaps.

4 / 5

Progressive Disclosure

The body is a well-sectioned overview whose deepest material ("Complex Conditions & Init Scope", "Value vs Pointer Arguments") is offloaded to a real, one-level-deep bundle file, clearly signaled twice as "[Details](./references/details.md)" and verified to exist with matching content and no further nesting — matching the score-5 anchor. The scattered sibling-skill pointers are all single-level and navigational, not buried references.

5 / 5

Total

17

/

20

Passed

Description

87%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, third-person description that names a clear scope, provides explicit multi-phrase triggers, and preempts overlap with sibling skills via explicit exclusions. Its only weakness is that the capability list omits a few areas the body actually covers, and it lacks synonyms like "golang" or ".go files".

Suggestions

Extend the capability list to mention function design, string handling, and type conversions so the description matches the body's full scope.

Add common synonyms users say naturally — "golang", ".go files", "idiomatic Go" — to the trigger phrase set.

DimensionReasoningScore

Specificity

"line length and breaking, variable declarations, control flow clarity, when comments help vs hurt" names the domain plus several concrete topic areas, matching the score-4 anchor (several specific actions, minor gaps). It stops short of 5 because several in-scope areas from the body (function design, string handling, type conversions) are not mentioned, and the topics are named more than the actions performed.

4 / 5

Completeness

Both halves are explicit: the "what" is enumerated ("line length and breaking, variable declarations, control flow clarity, when comments help vs hurt") and the "when" lists concrete trigger phrases ("writing or reviewing Go code, asking about style or clarity, or establishing project coding standards"), plus explicit exclusions — the score-5 anchor match. Not below 5 because no anchor element (what, when, concrete triggers) is missing or only implied.

5 / 5

Trigger Term Quality

"Use when writing or reviewing Go code, asking about style or clarity, or establishing project coding standards" gives good natural-phrase coverage (write/review Go code, style, clarity, coding standards). It misses common variations like "golang", ".go files", or "idiomatic", so it does not reach the comprehensive score-5 anchor.

4 / 5

Distinctiveness Conflict Risk

The description carves a clear niche (style/clarity conventions) and actively disambiguates from sibling skills — "Not for naming conventions (→ See ... golang-naming ...), linter configuration (→ See ... golang-lint ...), or doc comments (→ See ... golang-documentation ...)" — which is exactly the minimal-conflict ideal of the score-5 anchor.

5 / 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

metadata_field

'metadata' should map string keys to string values

Warning

relative_links

Relative link issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

samber/cc-skills-golang

Path

skills/golang-code-style/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.