CtrlK
BlogDocsLog inGet started
Tessl Logo

writing-user-outputs

CLI output formatting standards for worktrunk. Load before editing any code that calls warning_message, hint_message, error_message, info_message, eprintln, or println, or that produces strings the user will see (CLI help, progress UI, snapshot text). Documents ANSI color nesting rules, message patterns, and output system architecture.

66

Quality

83%

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

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.

The body is a dense, highly actionable standards document with excellent GOOD/BAD examples and concrete helper references, but it is far too long for a single SKILL.md and buries several self-contained topic areas inline. Splitting stable reference material into one-level-deep bundle files and tightening the digressive prose passages would address both low-scoring dimensions.

Suggestions

Split self-contained topic areas (hyperlink/OSC 8 rules, verbose-output spec, documentation examples, table alignment) into one-level-deep files under references/ and replace them with short pointers from SKILL.md.

Tighten the long anstream-vs-std stderr-macro and raw-write passages into a compact rule list with one example each; the current multi-paragraph narration repeats the same invariants.

Remove the duplicated flag-acknowledgment examples (shown in both 'Explicit flag acknowledgment' and 'Flag locality' sections) and consolidate them under one rule.

DimensionReasoningScore

Conciseness

The ~1,130-line body is information-dense and mostly project-specific knowledge Claude cannot know, but several long winding prose passages (the anstream-vs-std macro discussion spanning dozens of lines, the hyperlink/OSC 8 section) and repeated flag-acknowledgment examples could be tightened. It fits the 3 anchor ("mostly efficient but includes some unnecessary explanation or could be tightened") better than 4, which requires only minor trims.

3 / 5

Actionability

Exceptionally concrete throughout: GOOD/BAD example pairs, executable Rust snippets (eprintln/stderr-flush patterns, StyledLine usage, Display impl newline patterns), exact helper names (format_path_for_display, suggest_command, format_bash_with_gutter), and source-file pointers. Copy-paste ready and covers the common cases; matches the 5 anchor.

5 / 5

Workflow Clarity

As a standards document it provides clear decision rules — the warning-placement decision tree, stream-choice decision principle with per-command examples, and pointers to validating guard tests (check_stderr_macros_come_from_styling, snapshot-test patterns). Sequence and checkpoints are mostly present, but it is reference material rather than a validated multi-step workflow, so the 4 anchor ("clear sequence with most checkpoints present") fits better than 5.

4 / 5

Progressive Disclosure

The skill is a single monolithic ~47KB SKILL.md with no bundle files (references/, scripts/, assets/ absent), and the body's in-file source pointers (src/progress.rs, src/output/handlers.rs) are code locations, not skill references. Section headers and tables give it real structure, lifting it above the 2 anchor (no headers), but large bodies of content that clearly belong in separate reference files (message patterns, hyperlink rules, verbose-output spec, documentation examples) are inlined, matching the 3 anchor.

3 / 5

Total

15

/

20

Passed

Description

92%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 description: concrete what and when, correct third-person voice, and project-specific trigger symbols that make accidental triggering very unlikely. Only minor gap is the absence of a few natural phrasings (streams, user-facing messages) alongside the function-name triggers.

DimensionReasoningScore

Specificity

The description names concrete capabilities ("Documents ANSI color nesting rules, message patterns, and output system architecture") and enumerates specific trigger surfaces — "warning_message, hint_message, error_message, info_message, eprintln, or println" plus "CLI help, progress UI, snapshot text". Multiple specific concrete items with comprehensive coverage for this domain; not the 4 anchor because no meaningful coverage gaps remain.

5 / 5

Completeness

Explicitly answers both: what ("CLI output formatting standards for worktrunk... Documents ANSI color nesting rules, message patterns, and output system architecture") and when ("Load before editing any code that calls ... or that produces strings the user will see") with concrete trigger phrases. Matches the 5 anchor's what+when with concrete triggers; not 4 because the when-clause is fully explicit, not just present.

5 / 5

Trigger Term Quality

Strong keyword coverage: exact function names (warning_message, hint_message, eprintln, println), concrete output surfaces (CLI help, progress UI, snapshot text), and ANSI color nesting. A few natural terms a user might say are missing (e.g., stdout/stderr streams, "user-facing output"), so it sits between the 4 anchor (good coverage, a few natural terms missing) and the 5 anchor (comprehensive synonyms).

4 / 5

Distinctiveness Conflict Risk

Clear niche (worktrunk CLI output formatting) with distinct triggers — the specific worktrunk function names would rarely collide with another skill. Minimal conflict risk; matches the 5 anchor's "clear niche with distinct triggers."

5 / 5

Total

19

/

20

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 — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (1143 lines); consider splitting into references/ and linking

Warning

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

13

/

16

Passed

Repository
max-sixty/worktrunk
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.