Golang everyday observability — the always-on signals in production. Covers structured logging with slog, Prometheus metrics, OpenTelemetry distributed tracing, continuous profiling with pprof/Pyroscope, server-side RUM event tracking, alerting, and Grafana dashboards. Apply when instrumenting Go services for production monitoring, setting up metrics or alerting, adding OpenTelemetry tracing, correlating logs with traces, migrating legacy loggers (zap/logrus/zerolog) to slog, adding observability to new features, or implementing GDPR/CCPA-compliant tracking with Customer Data Platforms (CDP). Not for temporary deep-dive performance investigation (→ See `samber/cc-skills-golang@golang-benchmark` and `samber/cc-skills-golang@golang-performance` skills).
86
82%
Does it follow best practices?
Impact
94%
1.20xAverage score across 3 eval scenarios
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 thoroughly covers specific capabilities, includes rich natural trigger terms across the Go observability ecosystem, and explicitly addresses both 'what' and 'when'. The inclusion of a 'Not for' clause with cross-references to related skills is a best practice that further reduces conflict risk and aids in skill selection.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions and technologies: structured logging with slog, Prometheus metrics, OpenTelemetry distributed tracing, continuous profiling with pprof/Pyroscope, server-side RUM event tracking, alerting, and Grafana dashboards. | 3 / 3 |
Completeness | Clearly answers both 'what' (structured logging, metrics, tracing, profiling, alerting, dashboards) and 'when' with an explicit 'Apply when...' clause listing specific trigger scenarios. Also includes a 'Not for' exclusion clause that further clarifies scope, which is excellent for disambiguation. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'metrics', 'alerting', 'OpenTelemetry', 'tracing', 'logs', 'slog', 'Prometheus', 'Grafana', 'pprof', 'monitoring', 'observability', 'zap', 'logrus', 'zerolog', 'GDPR', 'CDP'. These are terms Go developers would naturally use when seeking help with observability. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche (Go observability in production) and explicit boundary-setting via the 'Not for' clause that distinguishes it from related performance/benchmarking skills. The specific technology stack (slog, Prometheus, OpenTelemetry, Pyroscope, Grafana) makes it very unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid observability skill with strong actionability — the code examples are executable, the common mistakes section is excellent, and the Definition of Done checklist is practical. The main weaknesses are moderate verbosity in the detailed guide descriptions (which essentially preview content that lives in reference files), a missing explicit instrumentation workflow despite referencing one, and inability to verify the referenced bundle files exist. The cross-referencing to other skills and the multi-mode persona setup are well done.
Suggestions
Trim the Detailed Guides section descriptions to 1 line each — the verbose summaries duplicate content that should live in the reference files themselves
Define the 'sequential instrumentation guide' explicitly in the coding/instrumentation mode, or provide a clear step-by-step workflow with validation checkpoints (e.g., verify metrics endpoint returns expected output after adding instrumentation)
Add a brief verification step to the migration strategy (e.g., 'Verify logs still appear in your aggregator with correct format after switching to slog')
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is generally well-organized but includes some unnecessary explanation (e.g., 'Observability is the ability to understand a system's internal state from its external outputs' and the verbose descriptions in the Detailed Guides section that summarize what each reference file covers). The best practices summary and five signals table are efficient, but the detailed guide descriptions could be trimmed since they're just pointers to reference files. | 2 / 3 |
Actionability | The skill provides fully executable Go code examples for signal correlation (otelslog bridge, exemplars), common mistakes with clear good/bad patterns, concrete migration steps, and a specific definition-of-done checklist. The code snippets are copy-paste ready and cover the most critical patterns. | 3 / 3 |
Workflow Clarity | The migration strategy has clear sequential steps (1-4), and the Definition of Done checklist provides validation checkpoints. However, the main instrumentation workflow ('Follow the sequential instrumentation guide') is referenced but never defined in the skill body, and there are no explicit validation/verification steps for the coding/instrumentation mode — no feedback loop for confirming that metrics are actually being scraped or traces are appearing. | 2 / 3 |
Progressive Disclosure | The skill has excellent structure with a clear overview, summary table, and references to seven detailed guide files in references/. However, no bundle files were provided, so the referenced files (references/logging.md, references/metrics.md, etc.) cannot be verified to exist. The inline descriptions of each reference file are quite verbose and could be shorter, essentially duplicating a table of contents that belongs in the files themselves. | 2 / 3 |
Total | 9 / 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.