CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

hud

Configure HUD display options (layout, presets, display elements)

Quality

73%

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 ./skills/hud/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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 content is a strong, highly actionable setup-and-configuration guide: every step has an exact executable command, platform differences are handled explicitly, and error recovery paths are documented. Its weaknesses are minor — a small amount of explanatory padding, a missing post-edit verification step in the setup workflow, and inline configuration reference material that could live in a separate file.

Suggestions

Add an explicit post-setup validation step (e.g., re-run the Step 1 existence check and verify statusLine parses as valid JSON) to close the feedback loop after editing settings.json.

Move the full omcHud config schema JSON and the display-elements/color-coding tables into a reference file to slim the main SKILL.md.

Trim the 'Multi-Line Agent Display' prose and the trailing footnote, which describe rendering details Claude doesn't need to act.

DimensionReasoningScore

Conciseness

The body is dense and operational — exact bash/node commands, tables, and JSON snippets with almost no explanation of concepts Claude already knows. Minor trimmable padding exists (the 'Multi-Line Agent Display' prose explaining tree characters, the 'Color Coding' section, and the trailing '~300ms' footnote), matching 'efficient; minor instances of over-explanation that could be trimmed'. Not score 5 because those few sections add tokens without adding actionable value.

4 / 5

Actionability

Fully executable, copy-paste-ready commands throughout (Step 1–6 node one-liners, the cp install commands, exact statusLine JSON for both Unix and Windows), plus concrete presets and troubleshooting recovery commands — matching 'fully executable; copy-paste ready code or commands; specific examples cover the common cases'. Not score 4 because no key execution details are missing.

5 / 5

Workflow Clarity

The setup workflow is a clearly sequenced 7-step process with explicit pre-checks (EXISTS/MISSING detection, plugin READY/NOT_FOUND verification), conditional branching ('If omc-hud.mjs is MISSING or argument is setup'), and a troubleshooting feedback loop (re-run setup, omc-doctor, re-run installer for the Node 24+ error). It falls short of anchor 5 only because there is no explicit post-edit validation that settings.json was modified correctly (the 'Manual verification' section states expectations but no verify-then-fix loop), matching 'clear sequence with most checkpoints present; minor validation gaps'.

4 / 5

Progressive Disclosure

The body is well-organized into clear sections (Quick Commands, Auto-Setup, Presets, Display Elements, Configuration, Troubleshooting) with no bundle files to reference; the referenced template paths point to the plugin's own scripts, which are appropriately cited as the single source of truth. It does not reach anchor 5 because at ~250 lines some inline reference material (the full omcHud config JSON, the display-elements table) could be split into a separate reference file, matching 'good structure; most content is appropriately placed; minor organization gaps'.

4 / 5

Total

17

/

20

Passed

Description

53%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.

The description identifies the skill's domain clearly and concisely, but lacks any 'when to use' trigger guidance and omits the natural vocabulary (statusline, status bar) users would most likely say. It is distinct within its plugin context yet under-specified as a capability statement.

Suggestions

Add a 'Use when...' clause, e.g., 'Use when the user mentions the HUD, statusline, status bar, or wants to change what the statusline displays.'

Include the natural trigger terms 'statusline' / 'status line' alongside 'HUD display options' to capture how users actually phrase the request.

List a few more concrete actions (install/setup the statusline, switch presets, troubleshoot a missing HUD) to strengthen capability coverage.

DimensionReasoningScore

Specificity

The description names the domain ("HUD display options") and concrete objects ("layout, presets, display elements") but relies on a single generic action verb ("Configure"), matching 'names domain and 1-2 concrete actions, but not comprehensive'. It is not score 2 because the parenthetical items add specificity beyond bare domain naming, and not score 4 because no list of several specific actions (e.g., install, switch presets, troubleshoot) is given.

3 / 5

Completeness

The 'what' is clear ("Configure HUD display options") but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not score 2 because the 'what' half is concrete and unambiguous, unlike a vague-what example.

3 / 5

Trigger Term Quality

Relevant keywords like "HUD", "display", "layout", and "presets" are present, but common natural variations users would say — "statusline", "status line", "status bar" — are missing, matching the 'some relevant keywords but missing common variations or synonyms' anchor. Not score 4 because the missing statusline vocabulary is the most likely phrasing a user would actually use.

3 / 5

Distinctiveness Conflict Risk

"HUD" is a niche, distinctive term with clear triggers, giving the skill a clear identity with only minor overlap risk against generic statusline or display-configuration skills. Not score 5 because "Configure ... display options" alone (without the HUD qualifier) would overlap with general display/config skills.

4 / 5

Total

13

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 1 missing, 1 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

Yeachan-Heo/oh-my-claudecode

Path

skills/hud/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.