CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

80%

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 ./.claude/skills/writing-user-outputs/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 an exceptionally concrete and executable standards document with almost no generic filler, but it is a 1,141-line monolith: verbose narrative passages inflate token cost, and no content is split into reference files despite many sections being self-contained. Actionability is its strength; progressive disclosure is its clear weakness.

Suggestions

Split self-contained sections (Hyperlinks, Windows Compatibility, Documentation Examples, Table Column Alignment, Snapshot Testing) into files under references/ and keep one-line pointers in SKILL.md, converting the monolith into a lean overview with one-level-deep references.

Trim narrative detours — e.g., the Cmd::delayed_stream anecdote, the picker LinkStyle::Unlinked exposition, and the MSYS2 explanation — to their one-sentence rule plus a pointer to the relevant source file.

Consolidate the repeated answer-vs-narration guidance (stated in the Decision principle, the --format=json paragraph, and the Examples list) into a single decision table to cut duplicated prose.

DimensionReasoningScore

Conciseness

Nearly all content is project-specific and non-obvious (anstream-vs-std macro semantics, guard-test exemptions, directive-file mechanics), so it avoids explaining things Claude already knows — but it is noticeably padded: multi-paragraph narrative detours (the Cmd::delayed_stream progress line, the picker LinkStyle::Unlinked exposition, MSYS2 path conversion), repeated restatements of the answer-vs-narration principle, and GOOD/BAD example density that could be halved. This fits anchor 3 ("mostly efficient but includes some unnecessary explanation or could be tightened") better than 4 given the volume of trimmable prose.

3 / 5

Actionability

Guidance is fully executable throughout: copy-paste Rust snippets ("use worktrunk::styling::{eprintln, println, stderr};"), exact function signatures and symbol/color tables, the cformat! tag list, concrete GOOD/BAD message contrasts, and named test helpers ("setup_snapshot_settings()", "make_snapshot_cmd()", "assert_cmd_snapshot!()"). Specific examples cover the common cases, matching anchor 5.

5 / 5

Workflow Clarity

As a standards reference rather than a sequential process, it still supplies explicit decision procedures — the answer-vs-narration discriminating question, the warning-placement tree ("Is it unexpected? …"), the prompts-vs-hints --yes table, and the four-part error message structure — with verification anchored in snapshot tests and guard tests. It falls short of anchor 5 because there is no consolidated end-to-end workflow with checkpoints; a reader adding a new message type must synthesize rules scattered across many sections.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), so all 1,141 lines are inlined in SKILL.md. Sections such as Hyperlinks, Windows Compatibility, Documentation Examples, and Table Column Alignment clearly belong in separate reference files, squarely matching anchor 2's "content that clearly belongs in separate files is inlined". Internal ## headers do make it navigable (above the header-less anchor-2 example), but it cannot reach anchor 3, which requires references to be present at all.

2 / 5

Total

14

/

20

Passed

Description

87%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: third-person voice, explicit what-and-when structure, and triggers phrased as concrete symbols an agent would see in the code being edited. The only weakness is slightly incomplete enumeration of the message-function family and styling surface, which leaves minor gaps in both specificity and trigger-term coverage.

DimensionReasoningScore

Specificity

"Documents ANSI color nesting rules, message patterns, and output system architecture" names three concrete content areas, and the trigger surface is enumerated with specific symbols ("warning_message, hint_message, error_message, info_message, eprintln, or println", "CLI help, progress UI, snapshot text"). Several specific actions with minor gaps — styling helpers, pager, and path-formatting capabilities are not named — so it fits anchor 4 rather than the comprehensive coverage of anchor 5.

4 / 5

Completeness

Both halves are explicit: what ("CLI output formatting standards for worktrunk. Documents ANSI color nesting rules, message patterns, and output system architecture") and when with concrete trigger phrases ("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"). This matches the anchor-5 pattern of clearly and explicitly answering both what AND when.

5 / 5

Trigger Term Quality

The exact function and macro names an editor would encounter in code ("warning_message, hint_message, error_message, info_message, eprintln, or println") plus "CLI help, progress UI, snapshot text" and the catch-all "any code that produces strings the user will see" give good natural-term coverage. A few natural terms from the body are missing (success_message, progress_message, prompt_message, "styling", stdout/stderr), which keeps it at anchor 4 rather than the synonym-level completeness of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The description is scoped to a single named codebase ("for worktrunk") and triggers on codebase-specific function names, giving it a clear niche with minimal conflict risk against any generic formatting or CLI skill. It matches anchor 5's clear-niche pattern.

5 / 5

Total

18

/

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 (1149 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

Path

.claude/skills/writing-user-outputs/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.