CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cli-logging-ux

Use this skill when editing or creating CLI output, logging, warnings, error messages, progress indicators, or diagnostic summaries in the APM codebase. Activate whenever code touches console helpers (_rich_success, _rich_warning, _rich_error, _rich_info, _rich_echo), DiagnosticCollector, STATUS_SYMBOLS, CommandLogger, or any user-facing terminal output — even if the user doesn't mention "logging" or "UX" explicitly.

63

Quality

79%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.apm/skills/cli-logging-ux/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, well-organized standards document with executable code, exact API tables, and concrete bad/good examples. Its weaknesses are duplication across sections (emoji ban, visual hierarchy, inline-vs-deferred) and a monolithic structure that inlines what should be a separate API reference file, including one dead external link.

Suggestions

Move the CommandLogger and InstallLogger method tables into a references/command-logger-api.md file and keep only the core rules and a few key methods inline in SKILL.md.

Deduplicate the repeated guidance: state the emoji ban once, merge the 'Output structure pattern' and 'Visual hierarchy contract' sections, and consolidate the two inline-vs-deferred diagnostics discussions.

Fix or remove the broken ../../agents/cli-logging-expert.agent.md link, or replace it with an inline summary of the persona so the skill is self-contained.

DimensionReasoningScore

Conciseness

Mostly efficient — tables, ASCII layer diagrams, and bad/good pairs carry real information — but there is substantive duplication: the emoji ban appears three times ('Emojis are banned', anti-pattern 4 'No emojis, ever'), the multi-package visual hierarchy is rendered twice ('Output structure pattern' and 'Visual hierarchy contract'), and the inline-vs-deferred diagnostics guidance is covered twice. Consolidating these would tighten the document meaningfully, but it is far from the padded explanations of the low anchors.

3 / 5

Actionability

Fully executable throughout: copy-paste-ready code (CommandLogger instantiation with Click decorators, diagnostics collection and render, content-aware skip via SkillIntegrator._dirs_equal), method tables with exact signatures like download_complete(name, ref=, sha=, cached=), and concrete file paths (src/apm_cli/core/command_logger.py). Bad/good pairs cover the common cases precisely.

5 / 5

Workflow Clarity

For a standards skill, the apply-sequence is clear: the three named tests ('So What?', Traffic Light, Newspaper) to run on every message, explicit inline-vs-deferred decision criteria, then rule tables and anti-patterns. It is not the top anchor because there is no explicit verification step (e.g. 'run the command and inspect the rendered output against the visual hierarchy contract') to close the loop.

4 / 5

Progressive Disclosure

Internal section organization is good with clear headers, but no references/ or scripts/ bundle exists, the sole external link (../../agents/cli-logging-expert.agent.md) does not resolve, and roughly 80 lines of full CommandLogger/InstallLogger API tables are inline reference material in a ~330-line SKILL.md — content that clearly belongs in a separate reference file.

3 / 5

Total

15

/

20

Passed

Description

78%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, trigger-focused description with explicit activation conditions, natural keywords, and excellent scoping to the APM codebase. Its main weakness is that the 'what' is conveyed only through the objects it covers rather than a direct statement of what the skill provides, leaving the capability side slightly implicit.

Suggestions

State what the skill does (e.g. 'Enforces APM's CLI output conventions and CommandLogger architecture') before the 'use when' clause, so the 'what' is explicit rather than implied by the listed artifacts.

Add a few natural synonyms users might say — 'print statements', 'console output', 'stderr' — to broaden trigger coverage.

Trim the enumerated internal symbol names if they push the description past the ideal length; the trigger semantics remain without exhaustively listing every helper.

DimensionReasoningScore

Specificity

Names concrete targets ('CLI output, logging, warnings, error messages, progress indicators, or diagnostic summaries in the APM codebase') plus specific internal symbols, but the only verbs are 'editing or creating' — it never states what the skill does with these (e.g. enforce conventions), so coverage of actions has minor gaps.

4 / 5

Completeness

It has both elements: an explicit trigger clause ('Use this skill when editing or creating... Activate whenever code touches...') and a discernible 'what' via the artifacts it governs. The 'what' is only implied through the objects listed rather than stated as a capability, so it is not the fully explicit what+when of the top anchor.

4 / 5

Trigger Term Quality

Good natural keyword coverage — 'logging', 'warnings', 'error messages', 'terminal output', 'progress indicators' are phrases users would actually say, and it explicitly covers implicit invocation ('even if the user doesn't mention "logging" or "UX" explicitly'). A few natural synonyms (e.g. 'print statements', 'stderr', 'console output') are missing, so it falls just short of comprehensive.

4 / 5

Distinctiveness Conflict Risk

Scoped tightly to 'the APM codebase' and anchored by project-specific symbols (DiagnosticCollector, STATUS_SYMBOLS, CommandLogger, _rich_* helpers), giving it a clear niche with distinct triggers and minimal risk of firing for unrelated skills.

5 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

microsoft/apm

Path

.apm/skills/cli-logging-ux/SKILL.md

Reviewed

Table of Contents

Is this your skill?

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.