Every backend service MUST use structured logging — pino/structlog/slog, JSON format, request IDs, proper log levels. console.log is never acceptable.
88
85%
Does it follow best practices?
Impact
97%
3.03xAverage score across 4 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 a strong skill description that clearly articulates specific logging requirements, names concrete tools per language, and provides explicit trigger conditions. It uses proper third-person voice throughout and covers both the 'what' and 'when' comprehensively. The description is distinctive enough to avoid conflicts with other skills while being discoverable through natural user language.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: use structured logging, specific libraries (pino, structlog, slog), output JSON, assign request IDs, use proper log levels, avoid logging sensitive data. | 3 / 3 |
Completeness | Clearly answers both what (structured logging requirements with specific tools and practices) AND when ('whenever creating or modifying any backend service, API, or background worker'). | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'backend service', 'API', 'background worker', 'logging', specific library names, and language contexts (Node.js, Python, Go). | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused specifically on structured logging for backend services with distinct triggers (logging libraries, backend/API/worker contexts) that wouldn't conflict with general coding or other infrastructure 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 skill provides excellent actionable guidance with complete, executable code examples across three languages. However, it's verbose with repeated emphasis on the same points and could benefit from splitting detailed examples into separate files. The workflow lacks explicit validation steps to confirm logging is working correctly.
Suggestions
Add a validation step: 'Run your service and verify JSON logs appear with request_id by checking stdout or your log aggregator'
Remove redundant statements about 'never use console.log' - stating it once at the top is sufficient
Consider moving language-specific examples to separate files (e.g., NODEJS.md, PYTHON.md, GO.md) and keeping SKILL.md as a concise overview with links
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is mostly efficient but includes some redundancy (e.g., repeating 'never use console.log' multiple times, explaining what log levels mean when Claude knows this). The checklist at the end duplicates earlier content. | 2 / 3 |
Actionability | Excellent executable code examples for Node.js, Python, and Go. All code is copy-paste ready with proper imports, middleware patterns, and real-world usage in route handlers. The examples are complete and practical. | 3 / 3 |
Workflow Clarity | The numbered list provides clear steps, but lacks explicit validation checkpoints. There's no 'verify your logging is working' step or feedback loop for confirming logs are properly formatted and appearing in the expected output. | 2 / 3 |
Progressive Disclosure | Content is well-organized with clear sections, but it's a long monolithic document (~200 lines). The log levels table, language-specific examples, and background worker patterns could be split into separate reference files with links from a shorter overview. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
Reviewed
Table of Contents