CtrlK
BlogDocsLog inGet started
Tessl Logo

tessl-labs/structured-logging

Every backend service MUST use structured logging — pino/structlog/slog, JSON format, request IDs, proper log levels. console.log is never acceptable.

88

3.03x
Quality

85%

Does it follow best practices?

Impact

97%

3.03x

Average score across 4 eval scenarios

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

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.

DimensionReasoningScore

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

DimensionReasoningScore

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Reviewed

Table of Contents