Troubleshoot Golang programs systematically - find and fix the root cause. Use when encountering bugs, crashes, deadlocks, or unexpected behavior in Go code. Covers debugging methodology, common Go pitfalls, test-driven debugging, pprof setup and capture, Delve debugger, race detection, GODEBUG tracing, and production debugging. Start here for any 'something is wrong' situation. Not for interpreting profiles or benchmarking (→ See `samber/cc-skills-golang@golang-benchmark` skill) or applying optimization patterns (→ See `samber/cc-skills-golang@golang-performance` skill).
68
85%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
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 an excellent skill description that hits all the marks. It provides specific concrete capabilities, uses natural trigger terms developers would actually say, explicitly states both what it does and when to use it, and carefully delineates its boundaries from related skills with cross-references. The 'Start here for any something is wrong situation' is a particularly effective trigger phrase.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions and tools: debugging methodology, common Go pitfalls, test-driven debugging, pprof setup and capture, Delve debugger, race detection, GODEBUG tracing, and production debugging. Very comprehensive enumeration of capabilities. | 3 / 3 |
Completeness | Clearly answers both 'what' (troubleshoot Go programs, find and fix root cause, covers specific tools and methodologies) and 'when' (explicit 'Use when encountering bugs, crashes, deadlocks, or unexpected behavior'). Also includes helpful negative boundaries directing users to related skills. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'bugs', 'crashes', 'deadlocks', 'unexpected behavior', 'something is wrong', 'Go code', 'Golang', 'debugging', 'pprof', 'Delve', 'race detection'. These are terms developers naturally use when encountering issues. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with explicit boundary-drawing: clearly states it is NOT for interpreting profiles/benchmarking or optimization patterns, and cross-references the specific alternative skills. The focus on troubleshooting/debugging Go code specifically creates a clear niche. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
70%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 debugging skill with excellent workflow clarity and progressive disclosure. The decision tree is a strong entry point, and the golden rules provide a solid methodology framework. The main weaknesses are moderate verbosity (motivational/emphatic language that could be trimmed) and limited executable code examples in the main file — most actionable content is delegated to reference files that weren't provided for evaluation.
Suggestions
Tighten the Golden Rules section by removing motivational language and reducing repetition of the 'no fixes without root cause' message — state it once firmly rather than multiple times with emphasis.
Add at least one complete executable debugging example in the main file (e.g., a minimal race condition reproduction with -race output) so the skill is actionable even without reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient and avoids explaining basic Go concepts, but some sections are verbose — the Red Flags section, Golden Rules elaborations, and repeated emphasis on 'NO FIXES WITHOUT ROOT CAUSE' could be tightened. The persona/thinking mode preamble and some motivational language ('There is no later') add tokens without adding actionable value. | 2 / 3 |
Actionability | The decision tree provides concrete commands (go test -race, curl pprof endpoint, GOTRACEBACK=all), and the golden rules give a clear methodology. However, the main SKILL.md lacks executable code examples — it's primarily a methodology guide with commands mentioned inline rather than copy-paste-ready code blocks. The real actionable content appears to be delegated to reference files which aren't provided. | 2 / 3 |
Workflow Clarity | The workflow is exceptionally clear: decision tree → golden rules → step-by-step methodology with explicit validation checkpoints ('reproduce before fix', 'one hypothesis at a time', 'never propose a fix you cannot explain'). The red flags section serves as a feedback loop for self-correction. The escalation path (fmt.Println → logging → pprof → Delve) is explicitly sequenced. | 3 / 3 |
Progressive Disclosure | Excellent progressive disclosure structure: the main file serves as a concise overview with decision tree and methodology, then clearly signals 10 reference files with one-sentence descriptions of what each contains. References are one level deep, well-organized by topic, and the cross-references to other skills are clearly separated. Navigation is intuitive. | 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.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
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 | |
8c7e016
Table of Contents
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.