CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

go-development

Develop, test, and architect production-grade Go (Golang) applications and microservices. Covers standard project layouts, Go modules, concurrency primitives, net/http servers, table-driven testing, slog logging, database access, error wrapping, generics, and CLI tooling.

56

Quality

71%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/development-skills/go-development/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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.

Highly actionable, technically sound content undermined by token bloat and structure: the body re-teaches Go fundamentals Claude already knows instead of surfacing only project-specific conventions, and it functions as a monolithic textbook rather than an overview that progressively discloses into references. The verification section is a genuine strength.

Suggestions

Cut or compress sections that restate standard-library knowledge Claude already has (mutex usage, generics Filter/Map/Set, flag-CLI basics, boilerplate envconfig/viper setup), keeping only project-specific conventions and non-obvious guidance.

Move the per-library code tutorials (database access, config, CLI, logging) into references/ files and keep SKILL.md as a concise overview with clearly signaled links, mirroring the existing go-patterns.md pattern.

Restructure the fifteen topical 'Steps' into a genuine sequenced workflow (scaffold -> implement -> verify) with validation checkpoints interleaved, rather than validation only at the end.

DimensionReasoningScore

Conciseness

The ~1000-line body extensively presents standard-library idioms Claude already knows — mutex/RWMutex usage, middleware chaining, functional options, generics Filter/Map/Set, flag-CLI basics, envconfig/viper boilerplate — with several padded sections that add no non-obvious knowledge. It is noticeably verbose rather than severely padded prose, fitting the score-2 anchor better than 1 (the code is accurate and dense, not fluffy) and clearly below 3 (many whole sections could be cut or trimmed).

2 / 5

Actionability

Guidance is fully executable: copy-paste-ready Go code for every topic (error wrapping, worker pools with semaphores, graceful shutdown, strict JSON decoding, pool tuning, atomic writes, cobra commands) plus concrete shell commands for linting, testing, and cross-compilation. Specific examples cover the common cases, matching the top anchor.

5 / 5

Workflow Clarity

The fifteen 'Steps' are topical reference sections rather than a coherent build sequence, and validation appears only as a final Verification command list, not as checkpoints within the workflow. This matches the steps-listed-but-checkpoints-missing-or-implicit anchor; it is above 2 because the sections are ordered sensibly and the end-to-end verification block is explicit.

3 / 5

Progressive Disclosure

A clearly signaled, real, one-level-deep reference exists ('Refer to references/go-patterns.md for concrete architectural patterns, worker pools, table-driven test templates, and Makefiles'), but the monolithic ~1000-line SKILL.md inlines large amounts of detail (full code tutorials per library) that belongs in the references/ layer. This fits the some-structure/could-be-better-organized anchor rather than 4, where most content would be appropriately placed.

3 / 5

Total

13

/

20

Passed

Description

75%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 specific, distinctive, well-scoped description in proper third-person voice, whose only material weakness is the complete absence of a 'Use when...' trigger clause. Adding explicit trigger guidance would raise it to the top anchor level.

Suggestions

Append a trigger clause such as 'Use when writing, testing, debugging, or architecting Go (Golang) code, services, or CLIs, or when the user mentions Go, Golang, go.mod, go test, or goroutines.'

Include one or two natural user phrasings (e.g., 'go build', 'go mod') as trigger terms to round out keyword coverage.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities — 'Develop, test, and architect production-grade Go (Golang) applications and microservices' plus ten specific areas (modules, concurrency primitives, net/http, table-driven testing, slog, error wrapping, generics, CLI tooling) — matching the comprehensive-coverage anchor, and uses third-person voice throughout.

5 / 5

Completeness

The 'what' is clearly and concretely stated, but there is no 'Use when...' clause or equivalent explicit trigger guidance anywhere in the description, which per the rubric caps completeness at 3. It is not a 4 because 'when' is not merely implicit — it is entirely absent; it is not a 2 because the 'what' is specific and unambiguous.

3 / 5

Trigger Term Quality

Natural terms like 'Go (Golang)', 'microservices', 'Go modules', 'net/http', 'slog', and 'CLI tooling' cover the primary ways users reference this domain, but a few common user phrasings are missing (e.g., 'write Go code', 'go test', 'gofmt', 'Go service'). This fits the good-coverage-with-minor-gaps anchor rather than the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

The Go (Golang) niche is well defined with distinct technical triggers (Go modules, net/http, slog, generics, error wrapping) that would not plausibly fire a different skill, matching the clear-niche/minimal-conflict anchor.

5 / 5

Total

17

/

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

skill_md_line_count

SKILL.md is long (1020 lines); consider splitting into references/ and linking

Warning

relative_links

Relative link issues: 3 missing

Warning

Total

14

/

16

Passed

Repository

administrakt0r/pro-skills-repo-administraktor

Path

skills/development-skills/go-development/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.