Golang performance optimization patterns and methodology - if X bottleneck, then apply Y. Covers allocation reduction, CPU efficiency, memory layout, GC tuning, pooling, caching, and hot-path optimization. Use when profiling or benchmarks have identified a bottleneck and you need the right optimization pattern to fix it. Also use when performing performance code review to suggest improvements or benchmarks that could help identify quick performance gains. Not for measurement methodology (see golang-benchmark skill) or debugging workflow (see golang-troubleshooting skill).
92
92%
Does it follow best practices?
Impact
Pending
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 a Go developer would use, explicitly states both what it does and when to use it, and proactively distinguishes itself from related skills with cross-references. The 'if X bottleneck, then apply Y' framing succinctly communicates the skill's methodology.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions and domains: allocation reduction, CPU efficiency, memory layout, GC tuning, pooling, caching, hot-path optimization, and performance code review. The 'if X bottleneck, then apply Y' framing adds methodological specificity. | 3 / 3 |
Completeness | Clearly answers both 'what' (Golang performance optimization patterns covering allocation reduction, CPU efficiency, etc.) and 'when' (explicit 'Use when profiling or benchmarks have identified a bottleneck' and 'when performing performance code review'). Also includes explicit 'Not for' exclusions referencing other skills, which strengthens the 'when' guidance. | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'performance optimization', 'profiling', 'benchmarks', 'bottleneck', 'allocation reduction', 'GC tuning', 'caching', 'hot-path', 'performance code review'. These cover a wide range of terms a Go developer would naturally use when seeking optimization help. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with explicit boundary-setting via 'Not for measurement methodology (see golang-benchmark skill) or debugging workflow (see golang-troubleshooting skill)'. This directly addresses potential overlap with related skills and creates clear delineation. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
85%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 performance optimization skill that excels at progressive disclosure and workflow clarity. The decision tree mapping pprof signals to specific reference documents is particularly effective. The main weakness is that actionable code examples are largely deferred to reference files, so the top-level skill reads more as a routing/methodology document than a hands-on guide — though this is a reasonable design choice given the breadth of topics covered.
Suggestions
Consider adding 1-2 inline executable code snippets for the most common optimization (e.g., a before/after allocation reduction example with sync.Pool or pre-allocated slice) to make the main skill more immediately actionable without requiring navigation to reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient. It assumes Claude knows Go, avoids explaining basic concepts, and every section earns its place — the decision tree, common mistakes table, and methodology steps are all high-density information. No unnecessary padding or concept explanations. | 3 / 3 |
Actionability | The iterative methodology provides concrete commands (benchstat, go test -bench flags), and the decision tree maps signals to actions. However, the actual optimization patterns are delegated to reference files rather than shown inline — the main skill lacks executable code examples demonstrating specific optimizations. The common mistakes table provides actionable fixes but they're brief directives rather than copy-paste ready code. | 2 / 3 |
Workflow Clarity | The iterative optimization cycle is clearly sequenced with 7 explicit steps including baseline measurement, single-change discipline, and statistical comparison via benchstat. The 'Rule Out External Bottlenecks First' section acts as a validation checkpoint before entering the optimization loop. The feedback loop (measure → change one thing → re-measure → repeat) is explicit and well-structured. | 3 / 3 |
Progressive Disclosure | Excellent structure: the main skill provides a concise overview with decision tree, methodology, and common mistakes, then clearly signals one-level-deep references to 6 detailed deep-dive files. Cross-references to other skills are well-organized and clearly labeled. No deeply nested references or monolithic content blocks. | 3 / 3 |
Total | 11 / 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 | |
b88f91d
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.